> ## Documentation Index
> Fetch the complete documentation index at: https://help.maestra.io/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Create Embedded Form

<Note>
  To work with cart data and viewed pages, a full integration is required according to the [setup guide](https://developers.maestra.io/page/website-personalization).
</Note>

# Adding an Embedded Form

1. Go to **Customer Data Platform→ Customers**. ​
   <img src="https://mintcdn.com/maestraio/8PhODeBuBM8nSWYH/images/imported/--2026-01-27--11_58_17.png?fit=max&auto=format&n=8PhODeBuBM8nSWYH&q=85&s=d27622b74e3c633a87ed890e6c298e2e" alt="" width="2904" height="808" data-path="images/imported/--2026-01-27--11_58_17.png" />
2. Click “**Create Campaign**” → “**Personalization**” → “**Embedded form**”: ​
   <img src="https://mintcdn.com/maestraio/8PhODeBuBM8nSWYH/images/imported/--2026-01-27--12_01_44.png?fit=max&auto=format&n=8PhODeBuBM8nSWYH&q=85&s=9d92d3e83c8767873cb2f5fabd67e054" alt="" width="2910" height="948" data-path="images/imported/--2026-01-27--12_01_44.png" />
3. Select a folder and click “**Create**”: ​
   <img src="https://mintcdn.com/maestraio/8PhODeBuBM8nSWYH/images/imported/--2026-01-27--12_03_49.png?fit=max&auto=format&n=8PhODeBuBM8nSWYH&q=85&s=0f6d819e5c608152823b8e74b69dfb73" alt="" width="2916" height="958" data-path="images/imported/--2026-01-27--12_03_49.png" />
4. Choose a template: ​
   <img src="https://mintcdn.com/maestraio/8PhODeBuBM8nSWYH/images/imported/--2026-01-27--12_12_34.png?fit=max&auto=format&n=8PhODeBuBM8nSWYH&q=85&s=89a631b2e3d4e6f291eb73422342de0b" alt="" width="2886" height="1132" data-path="images/imported/--2026-01-27--12_12_34.png" />
5. Select a website: ​
   <img src="https://mintcdn.com/maestraio/8PhODeBuBM8nSWYH/images/imported/--2026-01-27--12_15_28.png?fit=max&auto=format&n=8PhODeBuBM8nSWYH&q=85&s=a9f7bcd5f0640d791e609922217be246" alt="" width="2930" height="1460" data-path="images/imported/--2026-01-27--12_15_28.png" />
6. Enter a name: ​
   <img src="https://mintcdn.com/maestraio/8PhODeBuBM8nSWYH/images/imported/--2026-01-27--12_20_01.png?fit=max&auto=format&n=8PhODeBuBM8nSWYH&q=85&s=2f80712a6aa80d842c033a9c4e71f5fb" alt="" width="2874" height="1278" data-path="images/imported/--2026-01-27--12_20_01.png" />

## Form Design

In the “Embedded Form” section, click “Edit”, then click “Edit” under “Template design”. ​

<img src="https://mintcdn.com/maestraio/8PhODeBuBM8nSWYH/images/imported/--2026-01-29--13_35_28.png?fit=max&auto=format&n=8PhODeBuBM8nSWYH&q=85&s=3d6c29bf96a3f8f0c7d314d46122b5a2" alt="" width="2939" height="722" data-path="images/imported/--2026-01-29--13_35_28.png" />

**Basic Settings** Configure the appearance and placement of the embedded block:

<img src="https://mintcdn.com/maestraio/8PhODeBuBM8nSWYH/images/imported/--2026-01-29--13_38_45.png?fit=max&auto=format&n=8PhODeBuBM8nSWYH&q=85&s=ed2819838b5ced3a2d37497a180453ad" alt="" width="2930" height="1650" data-path="images/imported/--2026-01-29--13_38_45.png" />

On the template editing page, you can also preview how the embedded form appears on different devices and edit the HTML and CSS code if needed. ​

<img src="https://mintcdn.com/maestraio/8PhODeBuBM8nSWYH/images/imported/--2026-01-29--13_41_03.png?fit=max&auto=format&n=8PhODeBuBM8nSWYH&q=85&s=2400f0d3c3517f9d1355b25f841cbe02" alt="" width="2922" height="1056" data-path="images/imported/--2026-01-29--13_41_03.png" />

## New Templates

Use the new embedded block templates for more flexible customization.

* Choose a template labeled “New”: ​
  <img src="https://mintcdn.com/maestraio/8PhODeBuBM8nSWYH/images/imported/--2026-01-29--13_43_08.png?fit=max&auto=format&n=8PhODeBuBM8nSWYH&q=85&s=87374281c9a4c0fc8a390be181d9aa2f" alt="" width="2904" height="1134" data-path="images/imported/--2026-01-29--13_43_08.png" />
* Add the required elements to each screen using the “Add element” button (1), reorder them as needed (2), and remove any unnecessary ones (3). ​
  <img src="https://mintcdn.com/maestraio/8PhODeBuBM8nSWYH/images/imported/--2026-01-29--13_47_23.png?fit=max&auto=format&n=8PhODeBuBM8nSWYH&q=85&s=4189ad65ed7bf70288d667676f62dc70" alt="" width="2886" height="1630" data-path="images/imported/--2026-01-29--13_47_23.png" />
* To edit an element, click it in the screen element list or directly in the preview: ​
  <img src="https://mintcdn.com/maestraio/8PKiDbR3rMJsCzSE/images/imported/--2026-01-29--13_51_10.png?fit=max&auto=format&n=8PKiDbR3rMJsCzSE&q=85&s=a33bf35a87efbb67900b947f948eab7f" alt="" width="2908" height="1296" data-path="images/imported/--2026-01-29--13_51_10.png" />

<Note>
  In the new templates, you can configure different settings for each text element on different screens, including font style, size, color, and text alignment.
</Note>

**Device-Specific Design** By default, the design of most elements is automatically synced and optimized for mobile. Disable syncing on the **Desktop** tab. To apply unique settings for your phone, switch to the **Phone** tab.  ​

<img src="https://mintcdn.com/maestraio/8PKiDbR3rMJsCzSE/images/imported/--2026-01-29--13_55_12.png?fit=max&auto=format&n=8PKiDbR3rMJsCzSE&q=85&s=5354257ef13b3c4725828acb4b88b88d" alt="" width="2918" height="1302" data-path="images/imported/--2026-01-29--13_55_12.png" />

* **Go to “General Settings” to update:**
  * The overall form design (font, width and height, close button, and more)
  * The form placement on the website
  * Data submission settings (phone input format, autocomplete, user data storage)
    <img src="https://mintcdn.com/maestraio/8PKiDbR3rMJsCzSE/images/imported/--2026-01-29--14_00_24.png?fit=max&auto=format&n=8PKiDbR3rMJsCzSE&q=85&s=757db860baa049381514d39035f9a067" alt="" width="2912" height="1650" data-path="images/imported/--2026-01-29--14_00_24.png" />

<Note>
  In the new template settings, you can set a unified form height for all screens. This is useful when screens contain different types of content and the height may otherwise change when switching between them.
</Note>

In templates with multiple screens, you can enable saving entered data when the second screen is closed. In this case, all fields on **the second screen become optional**.
To do this, go to  **General Settings → Data submission → User Data** and enable the option: ​

<img src="https://mintcdn.com/maestraio/8PKiDbR3rMJsCzSE/images/imported/--2026-01-29--14_04_06.png?fit=max&auto=format&n=8PKiDbR3rMJsCzSE&q=85&s=4eb04c76e80ba7c82fdf754f7d80c736" alt="" width="2928" height="1562" data-path="images/imported/--2026-01-29--14_04_06.png" />

We recommend using this setting only if the first screen includes a required privacy policy, allowing the user to explicitly consent to data sharing and receiving communications.

## Targeting

Specify who should see the form and under what conditions. You can limit the audience by segment, traffic source, and more.
For example, show the form only to segment of customers whose birthday is in 7 days: ​

<img src="https://mintcdn.com/maestraio/8PKiDbR3rMJsCzSE/images/imported/--2026-01-29--14_07_56.png?fit=max&auto=format&n=8PKiDbR3rMJsCzSE&q=85&s=d04283a99f2442c5a82b6eccebcc4bd8" alt="" width="2882" height="1500" data-path="images/imported/--2026-01-29--14_07_56.png" />

Learn more about targeting in this article.

## General Settings

## What happens after form was filled

<img src="https://mintcdn.com/maestraio/8PKiDbR3rMJsCzSE/images/imported/--2026-01-29--14_18_44.png?fit=max&auto=format&n=8PKiDbR3rMJsCzSE&q=85&s=1d5e64fab7a93701b12025fca254fc00" alt="" width="2914" height="1656" data-path="images/imported/--2026-01-29--14_18_44.png" />

This section defines what should be done with the data collected in the form: add it to the database, send it to analytics, or trigger a custom method. The available actions depend on the selected template.
Learn more in this article.

## How to Add a Form to Your Website

**Placement Settings**:

* Embed content block into page selector:
  * Embed form placement: before/after element, at the start/at the end of the block, replace content of the block, replace block
  * Selector ​
    <img src="https://mintcdn.com/maestraio/8PKiDbR3rMJsCzSE/images/imported/--2026-01-29--14_20_52.png?fit=max&auto=format&n=8PKiDbR3rMJsCzSE&q=85&s=70faff22afab90a873677152c24d7bab" alt="" width="1988" height="754" data-path="images/imported/--2026-01-29--14_20_52.png" />
* Place content block manually Copy the code and paste it into the appropriate location in your website template. ​
  <img src="https://mintcdn.com/maestraio/8PKiDbR3rMJsCzSE/images/imported/--2026-01-29--14_22_34.png?fit=max&auto=format&n=8PKiDbR3rMJsCzSE&q=85&s=5c9ac2ef7c0b8a293eab7f0c9172167f" alt="" width="1978" height="714" data-path="images/imported/--2026-01-29--14_22_34.png" />**How to Choose a Selector** ​A **CSS selector** is the element to which specific CSS properties will be applied.

1. Install the **[Selector Gadget](https://chromewebstore.google.com/detail/selectorgadget/mhjhnkcfbdhnjickkkdbjoemdmbfginb)** extension for Google Chrome. It significantly simplifies finding the correct selector.
2. Go to the website where you want to place the form and choose the location on the page where it should appear.
3. Activate Selector Gadget, hover your cursor over the desired area, and copy the selector.Common selector types:

* **`.someClass`** — targets any element with the class `someClass`
* **`#someId`** — targets the element with the  `someId` ID.You can find a detailed guide on selecting the right selector in the article. ​If you need to use different selectors for desktop and mobile for the same form, use the following in the selector field:

```
`.popmechanic-desktop [selector_for_desktop], .popmechanic-mobile [selector_for_mobile]`
```

where you need to replace `[selector_for_desktop]` and `[selector_for_mobile]` with the corresponding selectors.

# Check how the form appears on the website.

To preview the form on the website, make sure the Placement section is configured. This means either embedding a div block on the site (Place content block manually) or selecting display by selector and specifying the required selector (Embed content block into page selector).
Click “Form Preview” and follow the link under “Your address”: ​
<img src="https://mintcdn.com/maestraio/8PKiDbR3rMJsCzSE/images/imported/--2026-01-29--15_22_12.png?fit=max&auto=format&n=8PKiDbR3rMJsCzSE&q=85&s=d76a1e11b1e224f627071dc3abd27cfa" alt="" width="1998" height="770" data-path="images/imported/--2026-01-29--15_22_12.png" /> ​Check the embedded form on your site ​

<img src="https://mintcdn.com/maestraio/8PKiDbR3rMJsCzSE/images/imported/--2026-01-29--15_22_56.png?fit=max&auto=format&n=8PKiDbR3rMJsCzSE&q=85&s=9e2f2064afbc2cb6bdb617ba81b1bad2" alt="" width="2896" height="1624" data-path="images/imported/--2026-01-29--15_22_56.png" />

# Launch

If the form meets the requirements, launch it.

<img src="https://mintcdn.com/maestraio/8PKiDbR3rMJsCzSE/images/imported/-D0-A1-D0-BD-D0-B8-D0-BC-D0-BE-D0-BA--D1-8D-D0-BA-D1-80-D0-B0-D0-BD-D0-B0-2026-01-29--D0-B2-14_32_32.png?fit=max&auto=format&n=8PKiDbR3rMJsCzSE&q=85&s=6cee88c5eb16c2c18bdde9cad5de7a1d" alt="" width="2902" height="932" data-path="images/imported/-D0-A1-D0-BD-D0-B8-D0-BC-D0-BE-D0-BA--D1-8D-D0-BA-D1-80-D0-B0-D0-BD-D0-B0-2026-01-29--D0-B2-14_32_32.png" />
