---
updatedAt: 2026-11-10T14:33:10.000Z
agentTools:
  projectIndex: https://docs.esputnik.com/llms.txt
---

# Setting Up Smart Containers

<HTMLBlock>{`
<p align="right" style="color: gray;">
  <a href="https://docs-ua.esputnik.com/docs/nalashtuvannya-smart-elementiv" style="color: gray; text-decoration: none;"><em>
    Read this article in Ukrainian ⮕
  </em></a>
</p>
`}</HTMLBlock>

A **smart container** is a template element that consists of basic blocks (image, text, button), whose content is automatically pulled from a product page on a website or from a [data feed](#data-from-a-data-feed): a JSON file, a spreadsheet, an RSS feed, or a recommendation data source.

Use smart containers when you need to quickly add product cards to an email without manually filling in each element.

> 🚧 Important
>
> If the website uses OG (**Open Graph**) tags, eSputnik can automatically pull product information into the email.

If the data is not pulled from the website or you need to display additional product parameters, the required values can be added to existing cards manually.

The content is pulled by a request from our side to the product page, so if the site's protection blocks external requests, neither the automatic substitution nor a selector check returns data. Ask the site administrators to add the IP addresses `18.193.171.62`, `3.66.101.249`, and `52.16.166.210` to the allowlist.

This guide explains how to check whether content cards are automatically populated and how to configure them manually if necessary.

## Automatic Data Substitution from the Website

With this method, you only need to copy the product URL and paste it into the container.

### Adding a Smart Container to an Email

1. Go to **Messages → Messages → Email**.
2. <Anchor target="_blank" href="https://docs.esputnik.com/docs/adaptive-email-builder-review#creating-a-message">Create a new email</Anchor> or open an existing one.

<Image src="https://files.readme.io/6e0af81a43ffe92e66eb5b91d709a71be9468a82d926ddf587b6c20e6b2384f5-image.png" align="center" width="80%"  alt="Messages navigation menu with the Email channel and Messages tab highlighted, showing a list of email messages" />

3. Open the **Structures and Modules** panel.

<Image src="https://files.readme.io/b737d3295331565fec449e4d8bd4e43a71c020745fd0c6952132e819e44fd74f-image.png" align="center" width="80%"  alt="Email editor with the Structures & Modules icon highlighted, showing a fashion email template" />

4. Go to the **My Modules** or **General Modules** tab (tab names may vary depending on your interface language and version).
5. Select the **Product Cards** category.

<Image src="https://files.readme.io/ad93f0c7acaf52f4af6198a8a8f07d977036e366b107ae09fd14a1ae1d9e1e56-image.png" align="center" width="80%"  alt="Modules panel with the Modules tab and My modules dropdown highlighted, and the Product Cards category underlined" />

For this example, we will configure containers containing:

* product image
* product name
* price
* button

6. Drag the module into the email.

<Image src="https://files.readme.io/5e14cb7b41ae7e2ddd314406c69779d96ad2e3906fdb1a3109ed38b7024f46db-image.png" align="center" width="80%"  alt="Product Cards module with three blouse products added to the Smart Casual section of the email template, highlighted" />

> 📘 Note
>
> If the email already has [styles configured](https://docs.esputnik.com/docs/designing-your-email), they will automatically apply to the added module.

### Inserting Data from the Website

1. Open the product page and copy its URL.

<Image src="https://files.readme.io/66aea3642bfbcac566955c6404f4c404cec17c70d1bf198e3741c8ea9c99bb27-image05.webp" alt="Browser window showing a Shopify product page for a Blue Classic Sweatshirt with the page URL boxed in red" align="center" width="80%" />

2. In the smart container settings, open the **Data** tab and click **Connect Website Page**.
3. Paste the URL into the **Link** field and click **Get**.

<Image src="https://files.readme.io/a32baa13bf89f470f8eea711c4877f391e850cf68303edc915e4d5fbd1f406e7-image.png" align="center" width="80%"  alt="Smart Container settings panel on the Data tab with the Link field and Get button highlighted, and Name and Image fields showing retrieved product data" />

eSputnik retrieves the available data and populates the container fields.

> 📘 Note
>
> The [button](https://docs.esputnik.com/docs/creating-cta-button) text is not changed automatically. Edit it manually if necessary.

<Image src="https://files.readme.io/a957ffb9d93f2aec9877c903e6c96dcc972cb6df725fa6056415ba1b1f02ff78-image.png" align="center" width="80%"  alt="First container filled with Blue Classic Sweatshirt product data, highlighted, and the Container settings Data tab showing Name and Image fields" />

Repeat steps 1–3 for each container.

<Image src="https://files.readme.io/2da877f63453bd40cf020855d45c722a4588b209824905b7d13828e8d70cb4e0-image.png" align="center" width="80%"  alt="Third container filled with Mocha Comfort Joggers product data, highlighted, with all three containers now showing retrieved product information" />

> 📘 Note
>
> There's no separate action for deleting a smart container. To remove its content, select the container level and use the content clearing option — the container itself stays in the template and becomes empty.

If you plan to use this module in other campaigns, update the [module](https://docs.esputnik.com/docs/module-library) or save it as a new one.

<Image src="https://files.readme.io/196cc50fadb970eabc9bae273e8b073c50df788a4cfcfd5bdaee7a3882fc66f0-image09.webp" alt="Update module panel with the Save as New button boxed in red, and the Store smart module boxed in red in the email template" align="center" width="80%" />

## Data from a Data Feed

A data feed is data available at a public link, such as a product list:

* **JSON** — an array of objects; the object keys become the feed fields;
* **spreadsheet** — a link to a CSV file, for example a CSV export of a Google Sheet shared by link. Each row is a separate item, and the headers in the first row are the feed fields;
* **RSS** — a link to an RSS feed;
* **recommendation data source** — a [data source](https://docs.esputnik.com/docs/creating-a-data-source-for-recommendations) with product recommendations created in your account settings.

The container is filled with the data of one feed item.

<Image src="https://files.readme.io/ba9a3e496f2d45c55b6d0b0215636381b78ce73aecf8de41dedce53795908bdb-image.png" alt="Data from a Data Feed" align="center" width="80%" />

### Connecting a Feed

1. In the smart container settings, open the **Data** tab and in the **Data Source** list, select **Data Feed**.

<Image src="https://files.readme.io/23947d43e5ba5d24ad98518c522f79f90d8184340d65edde0083920a54356023-image.png" align="center" width="80%" />

2. In the **Connected Data Sources** list, select the feed type:

* **External Source URL** — paste the feed link;

<Image src="https://files.readme.io/47bf9cd3732d65ff1ac65977a319fc1e73e08581ab3eebe6ead3f3a1966d3cc3-image.png" alt="External Source URL" align="center" width="80%" />

* **Data sources** — in the list below, select a recommendation data source. To find it by name, use the **Search** field. Only recommendation data sources are available here.

<Image src="https://files.readme.io/ec418dcfa50b9c9439b7bbaccee762f707d94cd053a4e755a9aca081e1c47761-image.png" alt="Data sources" align="center" width="80%" />

3. Click the **Get Data** icon next to the list.

<Image src="https://files.readme.io/cbf482e33f2c3a1e7696f83356079a436e34acf1df1c924ba6e82761aabfbf26-image.png" alt="Connecting a Feed" align="center" width="80%" />

### Mapping Fields and Selecting an Item

After the data loads, the **Mapping** window opens. It lists the container variables, one for each block, such as **Name** for a text block.

1. For each variable, select a feed field from the list, such as `title`. If a field name is similar to the variable name, the editor selects it automatically, so check the selection.
2. Click **Apply and Load Data**.

<Image src="https://files.readme.io/a957c919d57e8f11c3f8261dff933fb37dbd6fea9fcf73430ebb294df15dbec3-image.png" alt="Mapping Fields and Selecting an Item" align="center" width="80%" />

3. In the **Data preview** window, select an item: **Item 1**, **Item 2**, and so on. To find an item, select a field and enter a value in the **Search** field.
4. Click **Apply**.

<Image src="https://files.readme.io/9f3a7943a6891c8060036a477bb10ff9877ec81b69feb320c28cf61bfe6cccce-image.png" alt="In the Data preview window, select an item" align="center" width="80%" />

The data of the selected item appears in the container.

After the feed is connected, the **Data** tab has these buttons:

* **Variables** — the container variables. Each variable has a block (**Apply Data to**) and the place where the value goes (**Import Data into**), such as paragraph text or a button link (`href`). The **+ Item** button adds a variable for another block.
* **Mapping** — change the feed field that goes into a variable.
* **Data** — select another feed item.

<Image src="https://files.readme.io/0c4952fd97661ed54e72be5106506429b0a11f782fae28f0dc5cae4a68082ae3-image.png" alt="After the feed is connected, the Data tab has these buttons:" align="center" width="80%" />

## Adding Additional Parameters

This method provides more flexibility for customizing email content.

> 📘
>
> This method requires basic HTML and CSS knowledge, including familiarity with CSS selectors and browser DevTools.

Use this method if you need to add non-standard product parameters, such as:

* discount amount
* color
* SKU
* country of origin
* promotion expiration date

To configure additional parameters, follow these steps:

1. Add a block to the container.
2. Create a variable.
3. Configure CSS selector matching rules.

Below is an example of adding additional discount information to a product card.

### Adding a Block

1. Add a **Text** block to the container.

<Image src="https://files.readme.io/0927defaea497b4d964d01818dfb3d1150d4c9b3b667a2790033f5ccd07dfb91-image.png" align="center" width="80%"  alt="Text block icon highlighted in the side panel with a Discount text block added above the sweatshirt product image" />

2. Select the block and open the **code editor**.

> 📘 Note
>
> The code editor isn't limited to smart containers — you can open it for any selected block, container, structure, or stripe (or for the whole message if nothing is selected) to edit its HTML directly. It's organized into an HTML tab and separate tabs for default and custom CSS, plus a formatting tool that makes the code easier to read.

3. Add an HTML attribute, for example: `class="Discount"`.

<Image src="https://files.readme.io/b371465d66ca2cacd2d2403e58ff2286dc4126b5eafbe6899bf093e9572c7da0-image.png" align="center" width="80%"  alt="Code editor icon highlighted in the toolbar with the class attribute set to Discount highlighted in the text block's code" />

### Creating Variables

1. In the container settings, click the **Configuration** icon.
2. Click **+**.
3. Add a new Element and select the value from the dropdown menu. In our example, this is a field for displaying an additional discount.
4. Specify:

* Variable name: **Discount**
* Variable value: `discount`

5. Save the configuration.

<Image src="https://files.readme.io/fa80617b20bf59837d121fa67ee89c4fa2a0f4ff2209988e6f2e78fa2c9e8dad-image12.gif" alt="Container settings Data tab with the cursor on the configuration gear icon, and a new Discount label shown above the smart container product image" align="center" width="80%" />

After that, a new **Discount** field will appear in the container settings.

<Image src="https://files.readme.io/c8bb2de21655e937ae5ecc896fe09eb040159ae72965402c68f2503fcb96fd6b-image.png" align="center" width="80%"  alt="Container settings Data tab with a new Discount field highlighted below the Price field" />

### CSS Selector Direction Rules

1. Open the product page in a browser.

> 📘 Note
>
> This example demonstrates a basic way to inspect webpage elements using **DevTools in Google Chrome for Windows**. If you use another browser or operating system, refer to the documentation for inspecting elements using DevTools.

2. Open DevTools to inspect the page element: press `Ctrl + Shift + `I or `F12`.
3. Activate the element selection tool: press `Ctrl + Shift + C` or click the cursor icon in the upper-left corner of the DevTools panel.

<Image src="https://files.readme.io/be70bb352ceae5ed10da8258e5bedd027c909e174f2414a5480f56b8307b1540-image14.webp" alt="Chrome DevTools Elements panel with the Select an element to inspect tooltip and Ctrl+Shift+C shortcut boxed in red" align="center" width="80%" />

4. Click the required element (for example, the discount value).

<Image src="https://files.readme.io/621f157dce2aca635220bf290d604d8e4072b81e5ff2be4e95f99f9b7579460f-image15.webp" alt="Product page with the Second item 50% off discount label boxed in red and a DevTools element inspection tooltip showing its style details" align="center" width="80%" />

5. Copy the element's CSS selector.

<Image src="https://files.readme.io/2e3cb8f742ac8ad81fe7743395b20be02a6d0dae2d9aee8fd54611d51b46e310-image16.gif" alt="Chrome DevTools Elements panel with the strong element containing Second item 50% off highlighted in the HTML source" align="center" width="80%" />

6. In the smart container, open the **Discount** field and click **Direction** rules.
7. Paste the selector into the field.
8. Click **Check Rule and Save**.

<Image src="https://files.readme.io/190d046474ca40dc1b357cd9ae739aa62df0dc11135d2b4c12d89356a06c84a6-image.png" align="center" width="80%"  alt="Container settings Data tab with the Discount field's Selector value and the Check Rule and Save button highlighted" />

If the rule is configured correctly, the value will be pulled from the product page.

<Image src="https://files.readme.io/34e4f155c0809c6bc636c6173a3711b2734bf16d8029798d16378e169261ccf7-image.png" align="center" width="80%"  alt="Discount badge on the container now showing Second item 50% off, pulled from the product page and highlighted" />

> 📘 Note
>
> Websites usually use standard CSS selector naming conventions. Therefore, smart container settings can often be reused for most pages that follow standard CSS practices.<br />However, some pages may contain custom selector names or non-standard attributes. In such cases, additional configuration or creating a new smart container may be required. The same happens when a page that used to work stops providing the values: if the editor reports that a field was not found at the link, open the matching rules and update its selector, because the markup of the page has changed.

The steps for configuring a new container are similar to those described in the [Adding Additional Parameters](https://docs.esputnik.com/docs/building-smart-containers#adding-additional-parameters) section. Variables and matching rules must be created separately for each element.

If you have any questions about configuring smart containers, contact support at <support@esputnik.com>.