# Popup block

The **Popup block** appears as a clickable link with an icon. When clicked, a popup will appear with custom page content that you can use for product guides and details.

* Choose a default or custom **Icon**
* Add **Link text**
* Add **Content** for the popup

## Create pages for popup content

***

The **Popup block** displays content from a **Page** created in your Shopify admin. Use Shopify's page editor to [create tables](https://help.shopify.com/en/manual/shopify-admin/productivity-tools/rich-text-editor#insert-tables-with-the-rich-text-editor) with images, links, and other rich text to display in the popup modal.

Add as many pages as you need for unique product guides to tell customers about sizes, materials, or any other details they need to know before purchasing your products.

{% hint style="info" %} <mark style="color:blue;">**Note**</mark> For multiple guides for different products, see the steps for **creating unique info popups** for different products by using metafields. See the steps at the end of this guide.
{% endhint %}

## Add popup block

***

Under **Product overview**, click **(+) Add block** and select **Popup**. Use the drag-and-drop handles **`⋮⋮`** to re-order blocks. Click the block to start customizing.

### Select popup content

***

After you've created a page for your popup content, you can select the page in the block settings. Click the **Popup** block, then click **Select page** under Content.

{% hint style="info" %}
The same page content will appear for every product that uses the same template. You can [display unique popup content for different products](#use-metafields-to-display-unique-product-guides) by using metafields.
{% endhint %}

### Select icon

***

Choose an icon or upload your own to display next to the featured text.

<figure><img src="https://3688473072-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHUe2h5JnXOGnUNdkJwav%2Fuploads%2Fh3BFoIPYtdnPs5Uaseov%2Ficons-menu.png?alt=media&#x26;token=30cc88a3-c6da-4c4d-9194-78cddc6f72b6" alt="" width="226"><figcaption></figcaption></figure>

`Click Popup block to find settings`

<table><thead><tr><th width="190">Setting</th><th width="400">Description</th><th>Options</th></tr></thead><tbody><tr><td><mark style="color:blue;">Icon</mark></td><td>Choose from 40+ free icons.</td><td><em><mark style="background-color:yellow;">Default</mark></em><mark style="background-color:yellow;">: Checkmark</mark></td></tr><tr><td><mark style="color:blue;">Custom icon image</mark></td><td>Upload your own icon image to display next the heading.<br><br>We recommend a PNG image with a transparent background and minimum dimensions of 50px by 50px.</td><td></td></tr></tbody></table>

### Add link text

***

`Click Popup block to find settings`

<table><thead><tr><th width="190">Setting</th><th width="400">Description</th><th>Options</th></tr></thead><tbody><tr><td><mark style="color:blue;">Link text</mark></td><td>Enter text to display as the label for the link.</td><td><em><mark style="background-color:yellow;">Default</mark></em><mark style="background-color:yellow;">: "Popup link text"</mark></td></tr></tbody></table>

### Add bottom padding

***

Use **Bottom padding** to adjust the layout of the product overview section by adding spacing between blocks.

`Click Popup block to find settings`

<table><thead><tr><th width="190">Setting</th><th width="400">Description</th><th>Options</th></tr></thead><tbody><tr><td><mark style="color:blue;">Bottom padding</mark></td><td>Add spacing below the block</td><td><p><strong>1 - 50px</strong></p><p><em><mark style="background-color:yellow;">Default</mark></em><mark style="background-color:yellow;">: 16px</mark></p></td></tr></tbody></table>

## Use metafields to display unique product guides

***

You can display unique info popups for different products by using **metafields**. Once you create page content for multiple info popups (e.g. different size charts), you can link those pages to specific products by adding metafields in your Shopify admin.

Then, in the theme editor, insert that metafield as a dynamic source to automatically display the correct information.

Watch the video tutorial or follow the written instructions below.

{% embed url="<https://youtu.be/gxB6XDhCy80?t=43>" %}

### 1. Add 'Page reference' metafield

***

First, you need to add a **Page reference** metafield to your product pages. This field will store the specific page you want to link to each product in your Shopify admin.

{% hint style="warning" %}
Make sure you've created pages with your info popup content before following these steps.
{% endhint %}

<details>

<summary><mark style="color:blue;"><strong>STEPS</strong></mark></summary>

In your theme editor (**Customize**):

1. Click the **Variant selector** or **Information popup** block to open the settings.
2. Click the **Connect dynamic source** button next to the **Content** option in the **Information popup** settings. Then click **+ Create Metafield**.

   > Alternatively, go to **Settings > Custom data** in your **Shopify admin**.
3. Click the **Products** tab.
4. Click the **Add definition** button in the top-right.
5. Add a **Name** to the metafield that describes what it will be used for so you can remember and find it easily. For example: "Size guide".
6. Click the **(+) Select content type** button and select **Page** under **Reference**.
7. Click **Save**.

</details>

### 2. Link pages with popup content to products

***

Once you've added the **Page reference metafield** to your products in the Shopify admin, you can now enter the specific pages you want for the info popup by going to your **product inventory** in the Shopify admin.

<details>

<summary><mark style="color:blue;"><strong>STEPS</strong></mark></summary>

In your **Shopify Admin**:

1. Click **Products** in the admin sidebar. Open the product(s) you want to add the info popup page.
2. Scroll down to the **Metafields** section on the product page and click on the metafield you created and click **Select page**.
3. Repeat these steps to update the **Page reference** metafield for each product.
4. Click **Save**.

</details>

## 3. Insert page metafields in theme editor

***

Now that the product **Metafields** you created link to the correct **pages** for your popup content, you can insert that metafield into the theme editor as a **Dynamic source**.

<details>

<summary><mark style="color:blue;"><strong>STEPS</strong></mark></summary>

In your theme editor (**Customize**):

1. Click the the **popup** block to open the settings.
2. Click the **Connect dynamic source** button next to the **Content** option.
3. Select the **Metafield** that you created (e.g. "size guide").
4. You can now view or preview your different products to ensure that the correct **Information popup** content appears on each product page.
5. Click **Save**.

</details>