> ## 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).

# 🎯 Advanced Targeting Options for Free Shipping Upsell Bar

The Placement & Visibility settings in Hoppy Free Shipping give you advanced control over **where**, **when**, and **to whom** your Free Shipping Bar should appear.

Using these settings properly helps you create highly targeted campaigns that feel more personalized and less intrusive to customers ✨

With these targeting options, you can control:

* 📍 Where the bar appears  
* 🚫 Where it should not appear  
* ⚙️ In which conditions it should appear  
* ⏱️ When it should appear on the storefront  
* 👥 Which group of users can see it (and who cannot)  
* 📅 From when to when the Free Shipping Bar should stay active

ℹ️ Other than the **Display On (Include)** section, most Placement settings remain similar across all placement types such as:

* Product Page  
* Cart Drawer  
* Cart Page  
* Banner / Bar

The biggest difference is simply **where the Free Shipping Bar gets placed**.

---

# **📍 1\. Display On (Include)**

This section determines **where you want the Free Shipping Bar to appear**.

In this example, the selected placement is **Product Page**.

The following display options are available:

---

## **A. All Products**

Display the Free Shipping Bar across **all product pages** in your store, regardless of collection, tag, or product type.

✅ Best for stores wanting a site-wide Free Shipping experience.

---

## **B. Specific Products**

Selecting this option displays a **Select Product** button.

This allows you to manually choose the exact product pages where the Free Shipping Bar should appear.

🎯 Useful when promoting:

* High-converting products  
* Seasonal launches  
* Best sellers  
* High AOV products

---

## **C. All Products in Specific Collections**

Selecting this option displays a **Select Collection** button.

You can then choose which collections should display the Free Shipping Bar.

🛍️ Great for targeting:

* Seasonal collections  
* Sale collections  
* Premium product ranges  
* Category-specific campaigns

---

## **D. All Products With Specific Tags**

Selecting this option displays an input field where you can enter product tags.

Once the desired tag is entered, click **Add**.

⚠️ Important Note:

* Tag matching is case-sensitive  
* Make sure the tag is written exactly as it exists in Shopify

💡 Example:

If your product tag is:

`summer-sale`

Then:

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

Also, the product tags can be added from here:

---

## **E. Custom Position**

This option allows you to manually place the Free Shipping Bar anywhere inside your store.

Whenever you choose **Custom Position**, two placement methods become available:

* Shipping Bar ID  
* Shipping Bar Code Snippet

---

### **1\. Shipping Bar ID**

This method is ideal if you want to place the Free Shipping Bar directly using Shopify’s Theme Editor.

To access Theme Editor, go to:

**Sales Channels → Online Store → Edit Theme**

Then navigate to the area where you want the Free Shipping Bar to appear.

When hovering in compatible areas, a blue-colored ➕ icon may appear.

Click:

**Add block → Apps → Free Shipping Upsell**

Once added:

* Enter the Shipping Bar ID in the right sidebar  
* Save the Shopify Theme  
* Save the Free Shipping setup inside the Hoppy app as well  
  

⚠️ Important:

You must save both:

* Shopify Theme  
* Hoppy Free Shipping setup

Otherwise, the Free Shipping Bar may not appear.

---

### **2\. Shipping Bar Code Snippet**

This method is useful when you want more advanced placement flexibility.

You can:

* Add the snippet inside a **Custom Liquid** section in Theme Editor  
* Or manually place it inside Shopify theme code files

💡 Pro Tip:

Custom Liquid can usually be found under the **Sections** tab inside Shopify Theme Editor.

⚠️ Important:

Do not forget to:

* Save the configuration in Hoppy Free Shipping  
* Publish the setup after making changes

---

# **🚫 2\. Don’t Display On (Exclude)**

This section determines where the Free Shipping Bar **should NOT appear**.

If there are areas you want excluded from the campaign, this is where you configure them.

---

## **A. Don’t Exclude Any Product Page**

This is the default option. It does not exclude any pages.

---

## **B. Don’t Show on Product Pages in Specific Collections**

Use this option to exclude entire collections from displaying the Free Shipping Bar.

🛑 Useful when excluding:

* Sale collections  
* Low-margin products  
* Wholesale collections  
* Special campaign collections

---

## **C. Don’t Show on Specific Product Pages**

This option allows you to manually exclude individual products.

🎯 Helpful when certain products should never participate in Free Shipping campaigns.

---

# **⚙️ 3\. Display Only When**

This section allows you to create conditional visibility rules for the Free Shipping Bar.

These conditions help make campaigns more targeted and personalized.

---

## **A. Always Display**

This is the default option.

The Free Shipping Bar will always appear unless additional conditions are enabled.

---

## **B. Minimum Number of Orders**

Use this option to target customers who have already placed a minimum number of orders.

Once selected, an input field appears where you can enter the minimum order count.

🎯 Example Use Case:

Show special Free Shipping offers only to customers who have ordered at least once.

---

## **C. Show Once Per Customer**

This ensures the Free Shipping Bar is shown only once during a browsing session.

✅ Helpful for reducing repetition and keeping the storefront experience cleaner.

---

## **D. Cart Value Is Below (Set Max Cart Value)**

This option displays the Free Shipping Bar only if the cart value remains below a specified amount.

An input field appears where you can enter the maximum cart value.

💡 Useful when encouraging customers to increase cart value before checkout.

---

## **E. Last Order Was More Than X Days Ago**

Target customers who haven’t placed an order in a long time.

An input field appears for entering the number of days.

🎯 Great for re-engagement campaigns.

---

## **F. Last Order Was Within the Last X Days**

Target customers who recently placed an order.

An input field appears where you can enter the number of days.

✨ Useful for loyalty-focused campaigns and repeat purchase strategies.

---

# **⏱️ 4\. Time-on-Site Targeting**

This setting determines **when** the Free Shipping Bar should appear after a customer lands on the storefront.

---

## **A. Always Show**

This is the default option.

The Free Shipping Bar appears immediately.

---

## **B. Show After a While**

Selecting this option displays a number-only input field.

You can enter the number of seconds after which the Free Shipping Bar should appear.

💡 Example: Entering ‘`5’`will make the Free Shipping Bar appear after 5 seconds.

✨ Useful when you want to avoid overwhelming visitors immediately.

---

# **👥 5\. Customer Targeting**

This section allows you to target customers based on:

* Login state  
* Customer tags  
* Lifetime spending

---

## **A. Show Bar To**

You can display the Free Shipping Bar to:

* All Customers  
* Customers with specific tags  
* Customers who spent a certain amount over their lifetime

🎯 Great for VIP campaigns and loyalty-based offers.

---

## **B. Hide Bar From**

You can also exclude customers based on:

* Tags  
* Lifetime spending  
* Other targeting conditions

💡 Useful when creating exclusive or segmented campaigns.

---

# **🌍 6\. Geolocation Targeting**

This setting allows you to control which countries can see the Free Shipping Bar.

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

🌎 Helpful for region-specific promotions and shipping campaigns.

---

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

This setting allows the Free Shipping Bar to appear only for visitors coming from selected traffic sources.

Examples include:

* Facebook  
* Instagram  
* Google Ads  
* Email campaigns

🎯 Perfect for campaign-specific targeting.

---

# **📅 8\. Scheduling**

Use Scheduling to control exactly when the Free Shipping Bar should become active and when it should stop appearing.

You can configure:

* Start date  
* End date  
* Campaign duration

✨ This is especially useful for:

* Flash sales  
* Holiday campaigns  
* Limited-time promotions  
* Seasonal launches

---

# **🚀 Final Result**

Once configured successfully, Advanced Targeting allows merchants to create highly personalized Free Shipping experiences that feel smarter, cleaner, and more conversion-focused.

With proper targeting in place:

✅ Customers only see relevant Free Shipping offers  
✅ Campaigns become more personalized  
✅ Product targeting becomes more precise  
✅ Upsell opportunities improve significantly  
✅ Storefront experience feels cleaner and less intrusive  
✅ Merchants gain better control over visibility and campaign behavior

Using these advanced targeting options correctly can greatly improve both customer experience and Average Order Value (AOV). ✨