---
title: Add a Popup
slug: add-a-popup
docTags: 
createdAt: 2025-07-04T09:24:38.880Z
---

::embed[]{url="https://youtu.be/DWtrjUGYOXA?list=PLlZ7USQQgO8QKInaiqQ8EEsgm0ladx5Qc"}

## How To Add A Pop-up?

Pop-ups are a powerful way to communicate directly with your customers when they visit your store. You can use them to announce special sales, share important information, or display promotional images.

&#x20;

## Navigating to the Popups Page

- Navigate to your admin panel, then click on "Promotions."

::Image[]{src="https://api.archbee.com/api/optimize/A6k4A417O1V2DGm4H5kN0/5oirNOBoij3dRBLo19O3G_image.png" size="52" width="515" height="405" position="center" showCaption="false"}

- Then click "Popups."

::Image[]{src="https://api.archbee.com/api/optimize/A6k4A417O1V2DGm4H5kN0/avjvztx8wsrEsURgQ4Wu7_image.png" size="52" width="1245" height="459" position="center" showCaption="false"}

## Creating a Popup

- To create a new popup, click "Create New."

::Image[]{src="https://api.archbee.com/api/optimize/A6k4A417O1V2DGm4H5kN0/6IZ_R6ECZosCPipaoRSiZ_image.png" size="52" width="1571" height="473" position="center" showCaption="false"}

### Title&#x20;

- This is an internal name for your reference only; customers will not see it. Make it descriptive so you can easily identify it later.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/A6k4A417O1V2DGm4H5kN0/FUSjbog5tU3ExTXuTB10Y_image.png" size="52" width="499" height="347" position="center" showCaption="false"}

### Status&#x20;

- Set the popup's state as "active" or "inactive" as per your choice.

::Image[]{src="https://api.archbee.com/api/optimize/A6k4A417O1V2DGm4H5kN0/yJIFfE0WiXbRC7WaThBiU_image.png" size="52" width="500" height="417" position="center" showCaption="false"}

### Location&#x20;

Choose for whom the popup will appear.

- **Global:** On setting it to "Global," the popup will appear on all the merchants.

::Image[]{src="https://api.archbee.com/api/optimize/A6k4A417O1V2DGm4H5kN0/rRQjduGoPaKrG378jp0ca_image.png" size="52" width="497" height="559" position="center" showCaption="false"}

- **Merchants:** If you want to set the popup to appear for specific merchants, set it to "Merchant" and choose the merchants from the dropdown list accordingly.

::Image[]{src="https://api.archbee.com/api/optimize/A6k4A417O1V2DGm4H5kN0/PiS-WVREN46u_BKkKbPbS_image.png" size="52" width="487" height="633" position="center" showCaption="false"}

### Action Type&#x20;

- This setting controls what happens when a customer taps on your popup. It lets us choose between 5 different options to use. It allows us to choose whether the popup will remain static or customers can click on the popup to reroute to a particular web page.&#x20;

:::hint{type="info"}
Learn more about the 5 different [Action Types](https://help.hyperzod.com/discovery-page#51Fqg).
:::

::Image[]{src="https://api.archbee.com/api/optimize/A6k4A417O1V2DGm4H5kN0/6A8n7Gb-QQP0tYNgDwUt9_image.png" size="52" width="509" height="793" position="center" showCaption="false"}

### Choosing Your Popup Type: Image vs. HTML

- **Image:** This is the standard, straightforward option. You will be shown a box to upload your image file. This is best for simple visual advertisements.

::Image[]{src="https://api.archbee.com/api/optimize/A6k4A417O1V2DGm4H5kN0/g6TDUjpQBx7JOY-_U7e_7_image.png" size="52" width="528" height="721" position="center" showCaption="false"}

- **HTML:&#x20;**&#x54;his is an advanced option that gives you complete creative control. Instead of a single image, you can build a custom popup using simple code.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/A6k4A417O1V2DGm4H5kN0/S7IURA9Xx4w2TdR0uYS14_image.png" size="52" width="536" height="675" position="center" showCaption="false"}

### Customer Segmentation&#x20;

Choose who is eligible to use this coupon.

- **All Customers:** Any customer can see the popup.

::Image[]{src="https://api.archbee.com/api/optimize/A6k4A417O1V2DGm4H5kN0/h_4SU3WJQT8H0kmPgI__t_image.png" size="52" width="372" height="276" position="center" showCaption="false"}

- **Specific Customer Segment:** You can limit to show the popup to a pre-defined group of customers (e.g., "New Customers"). You can configure a segment by going to the [Segmentation part](https://help.hyperzod.com/segmentation) in the Admin Panel.

::Image[]{src="https://api.archbee.com/api/optimize/A6k4A417O1V2DGm4H5kN0/Y7nE5ZVk66hYprlfHcsb5_image.png" size="52" width="546" height="344" position="center" showCaption="false"}

### Frequency&#x20;

- Set "Frequency" if the popup will appear once or show every time a user lands on the website.

::Image[]{src="https://api.archbee.com/api/optimize/A6k4A417O1V2DGm4H5kN0/sRxgs6f1_dA7YJHnJgwJ3_image.png" size="52" width="472" height="272" position="center" showCaption="false"}

### Visible On&#x20;

- The **Visible On&#x20;**&#x6F;ption lets you choose where the popup will appear. If not set, it shows on both web and mobile.

::Image[]{src="https://api.archbee.com/api/optimize/A6k4A417O1V2DGm4H5kN0/ADtzj_aT-om-ndp3brDGi_image.png" size="52" width="534" height="565" position="center" showCaption="false"}

:::hint{type="warning"}
**Important:** Before you save, you can preview it on the screen that appears on the right side so that you know how the popup is going to look.
:::

- Uploa&#x64;**&#x20;"Image"** as easily as dragging and dropping or selecting them from the computer.

::Image[]{src="https://api.archbee.com/api/optimize/A6k4A417O1V2DGm4H5kN0/hZJ-wYbsGMq2eN6EVEi1V_10.png" size="52" width="950" height="535" position="center" showCaption="false"}

- Lastly, click **"Save."**

::Image[]{src="https://api.archbee.com/api/optimize/A6k4A417O1V2DGm4H5kN0/kz-Q4A9DgGU7beDxa1iho_11.png" size="52" width="898" height="505" position="center" showCaption="false"}

- The popup is successfully added. Now, your customers will find the popup once they land on your website.

::Image[]{src="https://api.archbee.com/api/optimize/A6k4A417O1V2DGm4H5kN0/FkKPtZ0P_mm__xlBSE0nr_13.png" size="52" width="954" height="527" position="center" showCaption="false"}

***

## Frequently Asked Questions (FAQs)



:::ExpandableHeading
**What image size should I upload for the popup?**

Popups follow a recommended size of **400px width and up to 800px height.&#x20;**
:::

***

:::ExpandableHeading
**Can I edit or disable a popup after creating it?**

Yes, all created popups appear in your Popups list. You can edit, deactivate, or delete them anytime.
:::

***

:::ExpandableHeading
**Can I use popups for targeted marketing campaigns, like showing different popups to new vs. returning customers?**

Yes. By using **Customer Segmentation**, you can build campaigns and target specific customers, such as:

- A **welcome discount** popup for new customers&#x20;
- A **loyalty reminder** popup for returning users

This allows your popup strategy to behave like an automated marketing funnel.
:::

***

:::ExpandableHeading
**Can popups help me drive app downloads?**

Popups can be an extremely effective strategy for converting existing web traffic into dedicated app users. Example use case:

- Show popup ONLY on web → “Install our app for faster ordering & rewards!”&#x20;
- Action Type → Redirect to App Store or Play Store&#x20;

This converts web traffic into app users, increasing retention.
:::

