> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.hoppyapps.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 🎯 PopUp Advanced Targeting Options

The Placement tab in Hoppy PopUps gives you advanced control over **where**, **when**, and **to whom** your popup should appear.

Instead of showing the same popup to every visitor, Advanced Targeting allows you to create smarter and more personalized popup experiences based on:

* 📍 Page targeting  
* ⏱️ Visitor behavior  
* 👥 Customer type  
* 🌍 Visitor location  
* 🔗 Marketing traffic source  
* 📅 Campaign scheduling  
* 🔁 Popup frequency

Using these settings properly helps reduce popup fatigue while improving engagement, conversions, and overall storefront experience.

---

# **⚠️ Before You Begin**

To configure Placement & Targeting settings:

→ Open an existing popup setup  
→ Or create a new popup first

Then switch to the **Placement** tab inside the popup editor.

ℹ️ Some targeting options only appear after selecting certain rules or trigger types.

### **Examples**

* Collection selectors only appear after choosing collection-based targeting  
* Country selectors only appear after enabling country targeting  
* Frequency cooldown settings only appear after selecting Limit Frequency  
* Idle timing fields only appear for idle-based exit intent triggers

---

# **📍 1\. Display On**

This section determines where the popup should appear across your storefront.

Choosing the correct display location helps ensure visitors only see popups that are relevant to the page they are currently browsing.

---

## **🌐 Show on Every Page**

Displays the popup across the entire storefront.

This is the broadest targeting option and works especially well for campaigns that should remain highly visible throughout the customer journey.

🎯 Common Use Cases:

* Store-wide discounts  
* Newsletter signup campaigns  
* Welcome popups  
* Holiday announcements

---

## **🏠 Show on Home Page Only**

Displays the popup only on the homepage.

This helps create focused landing experiences without interrupting visitors across product or collection pages.

✨ Great for:

* Welcome offers  
* Brand introductions  
* Seasonal campaigns  
* Homepage-exclusive announcements

---

## **🛍️ Show on All Product Pages**

Displays the popup across all product pages in the store.

This option works extremely well for promotional campaigns that should appear while customers are actively browsing products.

🎯 Helpful for:

* Upsells  
* Coupon campaigns  
* Countdown offers  
* Add-to-cart incentives

---

## **🎯 Show on Specific Product Pages**

Allows you to manually choose which products should display the popup.

Once selected, a product selector appears where products can be added individually.

✨ Useful for targeting:

* Best sellers  
* High AOV products  
* Seasonal launches  
* Featured collections

---

## **🗂️ All Products in Specific Collections**

Displays the popup only on products belonging to selected collections.

After selecting this option, a collection selector becomes available.

🎯 Common Use Cases:

* Sale collections  
* Seasonal categories  
* Premium collections  
* Collection-based campaigns

---

## **📚 Show on All Collection Pages**

Displays the popup on all collection listing pages.

This is useful when targeting visitors who are browsing categories rather than individual products.

---

## **📌 Show on Specific Collection Pages**

Allows you to manually choose which collection pages should display the popup.

This helps create highly targeted category-specific popup experiences.

---

## **🏷️ All Products with Specific Tags**

Displays the popup only on products containing selected Shopify product tags.

After selecting this option, a tag input field appears.

⚠️ Important Notes:

* Tag matching is case-sensitive  
* Tags must exactly match the Shopify product tags

### **Example**

If the product tag is:

`summer-sale`

Then:

❌ `Summer-Sale` will not work  
✅ `summer-sale` will work

---

# **⚙️ 2\. Trigger Settings**

Trigger settings determine what visitor action or behavior causes the popup to appear.

Using the correct trigger helps popups feel more natural and less intrusive while improving engagement.

---

## **⏱️ After Time (Duration)**

Displays the popup after the visitor spends a certain amount of time on the page.

Once selected, the **Show Pop Up After** dropdown becomes available.

### **Available Options**

* Immediately  
* After 5 seconds  
* After 15 seconds  
* After 30 seconds  
* After 1 minute  
* After 3 minutes

💡 Short delays work best for welcome campaigns, while longer delays are better for engaged visitors already interacting with the storefront.

---

## **📜 Page Scroll**

Displays the popup after the visitor scrolls down the page.

This trigger targets visitors who are already engaging with the content.

### **Available Options**

* After 25% page scroll  
* After 50% page scroll  
* After 75% page scroll  
* After 100% page scroll

✨ Higher scroll percentages usually indicate stronger visitor interest and engagement.

---

## **🚪 Exit-intent**

Displays the popup when the app detects that the visitor may be about to leave the storefront.

This is one of the most commonly used popup triggers for recovering abandoning visitors.

---

### **🖱️ When Mouse Leaves the Page (Desktop Only)**

Triggers the popup when the visitor moves their cursor toward the browser close area or tab section.

⚠️ This trigger primarily works on desktop devices.

---

### **📜 When User Scrolls Up Quickly**

Triggers the popup when the visitor rapidly scrolls upward.

This behavior often indicates that the visitor may be preparing to leave or navigate away.

---

### **💤 After User Idle**

Triggers the popup after the visitor becomes inactive for a certain amount of time.

Once selected, an **Idle Time (in seconds)** field becomes available.

💡 This works well for:

* Re-engagement campaigns  
* Discount reminders  
* Email capture popups  
* Attention recovery campaigns

---

## **🛒 Add to Cart Button is Clicked**

Displays the popup immediately after the visitor clicks the Add to Cart button.

This trigger is highly effective because it targets customers showing strong purchase intent.

🎯 Common Use Cases:

* Upsell offers  
* Cross-sell campaigns  
* Bundle suggestions  
* Cart incentives

---

## **📄 After Page Views**

Displays the popup after a visitor has viewed a specified number of pages on your store.

Instead of appearing immediately, the popup waits until the visitor reaches the page view count you configure, making it ideal for engaging users who have already shown interest by browsing multiple pages.

🎯 **Common Use Cases:**

* Newsletter signup popups  
* Discount or coupon offers  
* Free shipping promotions  
* Product recommendations  
* Exit conversion campaigns for engaged visitors

---

# **🔁 3\. Display Frequency**

Display frequency controls how often the same visitor should see the popup.

Managing popup frequency properly helps avoid repetitive experiences and reduces popup fatigue.

---

## **🔄 Show Every Time**

Displays the popup every time the visitor matches the targeting conditions.

This option works best for campaigns that need maximum visibility.

---

## **👁️ Once Every Time Anyone Visits**

Displays the popup only once during a browsing visit.

If the visitor closes the popup, it will not repeatedly appear during the same visit.

⚠️ The popup will stop appearing entirely after the form is successfully submitted.

---

## **⏳ Limit Frequency**

Limits how often the popup reappears after being closed.

Once selected, an additional waiting period field becomes available.

### **Example**

If the waiting period is set to:

`3 Days`

Then the popup will not reappear again for that visitor until 3 days have passed.

✨ This is extremely useful for maintaining a cleaner and less intrusive storefront experience.

⚠️ The popup automatically stops being displayed after the form is submitted.

---

# **📌 4\. Display Position**

Controls where the popup appears on the screen.

Different popup positions can dramatically affect visibility, engagement, and how intrusive the popup feels.

### **Available Examples**

* Center  
* Bottom Left  
* Bottom Right  
* Top Left  
* Top Right

💡 Center popups are generally the most noticeable and are commonly used for email capture campaigns and discount offers.

---

# **👥 5\. Customer Targeting**

This section allows you to target customers based on:

* Login status  
* Customer tags  
* Customer lifetime spending

These targeting settings help create more personalized popup experiences for different customer groups.

---

## **🔐 Visibility (Customer Login Status)**

Controls whether the popup should appear based on customer authentication status.

### **Available Options**

* Show to all customers  
* Show only logged-in customers  
* Show only logged-out visitors

✨ Helpful for loyalty programs, onboarding flows, and member-exclusive promotions.

---

## **👤 Show Bar To**

Controls which customers should be allowed to see the popup.

### **Available Options**

* All Customers  
* Target customers based on customer tag  
* Target customers based on lifetime spent

---

### **🏷️ Customer Tag Targeting**

Allows you to target customers with specific Shopify customer tags.

🎯 Example Use Cases:

* VIP customers  
* Wholesale buyers  
* Loyalty members  
* Repeat customers

---

### **💰 Lifetime Spent Targeting**

Allows you to target customers based on their total historical spending.

This is especially useful for:

* High-value customer rewards  
* VIP campaigns  
* Premium discounts  
* Loyalty-focused offers

---

## **🚫 Hide Bar From**

Allows you to exclude certain customer groups from seeing the popup.

### **Available Options**

* No one — use settings from above  
* Target customers based on customer tag  
* Target customers based on lifetime spent

💡 Useful when creating exclusive campaigns that should remain hidden from certain customer segments.

---

# **🌍 6\. Geolocation Targeting**

Controls which countries are allowed to see the popup.

This is especially useful for region-specific promotions, localized campaigns, and country-based marketing strategies.

---

## **🌐 All World**

Displays the popup globally to visitors from all supported countries.

This is the default option and works best for store-wide campaigns.

---

## **📍 Specific Countries**

Allows you to manually choose which countries should see the popup.

Once selected, a country selector becomes available.

🎯 Common Use Cases:

* Country-specific discounts  
* Shipping campaigns  
* Regional launches  
* Localized holiday promotions

⚠️ If countries do not appear in the selector, make sure they are added to an active Shopify Market.

---

# **🔗 7\. Allowed UTM Sources**

UTM targeting allows the popup to appear only for visitors arriving from specific marketing sources.

This helps create more personalized popup experiences that match the original marketing campaign.

---

## **✅ Only Show to Visitors Who Match UTM Source**

When enabled, the popup only appears if the visitor URL contains the matching UTM source parameter.

### **Example**

If configured for:

`utm_source=facebook`

Then the popup will only appear for visitors arriving through Facebook campaign links.

✨ Perfect for:

* Facebook Ads campaigns  
* Instagram promotions  
* Email marketing campaigns  
* Influencer traffic  
* Google Ads campaigns

💡 This helps maintain consistent messaging between advertisements and popup campaigns.

---

# **📅 8\. Scheduling**

Scheduling controls exactly when the popup should become active and when it should automatically stop appearing.

This is especially useful for limited-time campaigns and seasonal promotions.

---

## **🚀 Start Settings**

Controls when the popup campaign should begin.

### **Available Options**

* Right now  
* Specific date

---

### **⚡ Right Now**

Makes the popup active immediately after publishing.

This works best for campaigns that should launch instantly.

---

### **📆 Specific Date**

Allows the popup to automatically activate at a future date.

🎯 Helpful for:

* Holiday launches  
* Flash sales  
* Product launches  
* Scheduled campaigns

⚠️ If the selected start date is in the future, the popup will remain hidden until that date arrives.

---

## **🛑 End Settings**

Controls when the popup should stop appearing.

### **Available Options**

* Never  
* Specific date

---

### **♾️ Never**

Keeps the popup active indefinitely until manually unpublished or disabled.

This is ideal for evergreen campaigns such as newsletter signup popups.

---

### **📅 Specific Date**

Automatically disables the popup after the selected end date.

✨ Perfect for:

* Limited-time discounts  
* Black Friday campaigns  
* Countdown promotions  
* Seasonal offers

⚠️ Once the end date passes, the popup automatically stops appearing.

---

# **⚠️ Important Notes**

Before troubleshooting popup visibility issues, always double-check:

* Display On targeting  
* Trigger conditions  
* Frequency settings  
* Customer targeting  
* Geolocation restrictions  
* Scheduling dates

ℹ️ Multiple targeting rules work together simultaneously.

This means visitors must satisfy all active conditions before the popup becomes visible.

### **Example**

If a popup is configured to:

* Show only in the United States  
* Show only to logged-in customers  
* Show only on product pages

Then visitors outside the United States or visitors who are not logged in will never see the popup.

---

# **🚀 Final Result**

Once configured successfully, Advanced Targeting helps create smarter and more personalized popup experiences across the storefront.

With proper targeting in place:

✅ Popups appear at the right moment  
✅ Visitors only see relevant campaigns  
✅ Customer segmentation becomes more precise  
✅ Campaigns feel less intrusive  
✅ Marketing traffic receives personalized popup experiences  
✅ Time-sensitive campaigns run automatically  
✅ Popup fatigue is significantly reduced

Using Advanced Targeting correctly can greatly improve both customer engagement and popup conversion performance 🎯

---