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

# 🎡 How to Setup Spin Wheel PopUps

Want to turn email collection into a fun, interactive game? 🎉

Spin Wheel PopUps let visitors spin a colorful wheel to win discounts, free shipping, or special offers. It's one of the most engaging ways to grow your subscriber list while giving customers a memorable brand experience.

This guide walks you through the entire setup so you can launch your first Spin Wheel PopUp in minutes.

---

# **✅ Before You Begin — Enable the App Embed**

For any popup to appear on your storefront, the app embed must be enabled inside your Shopify theme.

Go to:

**Shopify Admin → Sales Channels → Online Store → Themes → Edit Theme → App Embeds**

Then:

* Find **Hoppy Popups**  
* Toggle it **ON**  
* Click **Save**

ℹ️ Without this step, your popup will not render on the storefront even after publishing.

---

# **⚙️ Step 1 — Create a New Spin Wheel PopUp**

Open the **Hoppy PopUps** app.

Then:

→ Click **Create New PopUp**

→ Select **Spin Wheel PopUp** from the list of popup types.

The setup page will open automatically with a pre-built wheel ready to customize.

---

# **📝 Step 2 — Configure the Content**

After opening the setup page, you'll land inside the **Content** tab.

This section controls what your visitors see and how they interact with the popup.

---

## **🏷️ PopUp Name**

This field is used for internal purposes only. Customers will never see this name.

You can use any recognizable name such as:

* Spin & Win Campaign  
* Wheel of Discounts  
* Lucky Spin Popup  
* Birthday Wheel Offer

💡 Using proper internal naming makes it easier to identify setups later, especially if your store runs multiple campaigns.

---

## **💬 Title & Description**

These appear at the top of your popup and should invite visitors to play.

### **Example**

* **Title:** "Spin the wheel & win"  
* **Description:** "Try your luck and unlock a special discount"

You can customize these to match your campaign voice.

---

## **📧 Email & Phone Collection**

Choose which fields to show in your popup:

* **Show email collection field** — captures visitor emails  
* **Show phone number field** — captures phone numbers with country-code selection

You can show both, only one, or neither if you're purely running a game without collection.

---

## **⚙️ Additional Collection & Coupon Settings**

This section gives you additional control over how visitor information is collected and how discounts are presented inside the popup.

---

### **📩 Email Collection Field Placeholder**

Customize the placeholder text shown inside the email input field.

### **Example**

* "Enter your email"  
* "Your best email address"

This helps guide visitors on what information they should enter.

---

### **❌ Email Error Message**

Set the validation message shown when a visitor enters an invalid email address.

### **Example**

* "Please enter a valid email address"

This appears automatically if the entered email format is incorrect.

---

### **📱 Default Country Code**

Choose the default country code for the phone number field.

### **Example**

* United States (+1)  
* United Kingdom (+44)  
* India (+91)

Visitors can still change the country manually unless restricted.

---

### **📞 Phone Number Placeholder**

Customize the placeholder text shown inside the phone number field.

### **Example**

* "Enter your phone number"  
* "Mobile number"

This improves clarity and encourages proper formatting.

---

### **⚠️ Phone Number Error Message**

Set the message displayed when an invalid phone number is entered.

### **Example**

* "Please enter a valid phone number"

This helps visitors understand why submission failed.

---

### **🔘 Button Text**

Customize the call-to-action button text shown inside the popup.

### **Example**

* "Shop Now"  
* "Claim Discount"  
* "Unlock Offer"

Using action-oriented text can improve conversions.

---

### **☑️ Add Opt-In Checkbox**

Choose whether to show an additional opt-in checkbox inside the popup.

This can be used for:

* Marketing consent  
* SMS consent  
* Newsletter subscriptions  
* Terms acknowledgement

Available options:

* **Yes** — displays the checkbox  
* **No** — hides the checkbox

---

### **❎ Close Icon**

Enable or disable the close icon shown on the popup.

* **Enabled** — visitors can manually close the popup  
* **Disabled** — removes the close icon from the popup

This helps control how dismissible the popup experience should be.

---

## **✉️ Success Messages**

After a visitor submits their details and spins the wheel, a success message appears.

* **Success Message:** "Welcome to our store\!"

You can also add a **Success Description** — for example, instructions on how to redeem the prize they just won.

---

## **🖱️ Button Click Behavior**

ℹ️ This option is available only when "Show Email Field" & "Show Phone Number Field" are unchecked.

It allows you to control what happens when a visitor clicks the CTA button inside the popup. It handles either of the following:

1. **Close Popup** — the popup will close  
2. **Reveal Coupon Code** — the coupon code will be revealed to the visitor, but you will have setup the Coupon Code as described above in the "Show Coupon Code" section.  
3. **Redirect to Link** — selecting this would give you an input field called "Link" where you can specify the URL to which the visitor will be redirected

---

## **☁️ Floating Action Button**

You can add a **Floating Action Button** that stays visible on the page so visitors can reopen the popup after closing it.

Choose a position:

* **Bottom right**  
* **Bottom left**  
* **Screen right**  
* **Screen left**

Then enter the **Button Text** — e.g. "Open Offer", "Get Discount", or "Learn More".

To disable the floating button entirely, select **Disable floating action button**.

---

# **🎡 Step 3 — Configure Wheel Rewards**

Still inside the **Content** tab, scroll to the **Wheel Rewards** section.

This is where you define every slice on the wheel — what visitors can win and how likely they are to win it.

---

### **💸 Discount Application**

This option controls how the discount is applied. It has two options:

1. **Customer will have to Apply Discount Manually** — the customer will have to enter the coupon code during checkout to receive the discount.  
2. **Apply Discount Automatically** — the discount will be applied automatically during checkout without the customer having to enter the coupon code.

⚠️ **Important:**

* Our app does not create or manage coupon codes/discounts. You must create them in Shopify Admin → Discounts before using them in the popup.

---

## **🎁 Adding & Editing Slices**

Each slice on the wheel has four settings:

| Setting | What it does |
| ----- | ----- |
| **Label** | The text shown on the wheel slice (e.g. "10% OFF", "Free Ship") |
| **Probability Weight** | A number that controls how often this slice wins. Higher \= more likely. |
| **Discount Code** | The actual coupon code the visitor receives if this slice lands. Can be left blank. |
| **Message** | A custom message shown after spinning (e.g. "Try again next time…") |

### **Example Setup**

| Label | Probability | Code | Message |
| ----- | ----- | ----- | ----- |
| $3 OFF | 20 | SAVE3 | "" |
| FREE SHIP | 20 | FREESHIP7 | "" |
| 7% OFF | 20 | SAVE7P | "" |
| NO LUCK | 10 | "" | "Try again next time…" |
| 12% OFF | 10 | SAVE12P | "" |

---

### **🎟️ Adding Discount Coupon Codes**

To display a coupon code, you can either:

1. Select one of the Coupon Codes which you have created in Shopify Admin → Discounts by clicking on Select/Change Discount.  
2. You can create a new one by clicking on **Create New Discount**.

### **Example**

* SAVE10  
* WELCOME20  
* COUPON123

---

## **➕ Add More Slices**

Click **Add More** to create additional wheel segments. There's no strict limit — add as many as you like to make the wheel feel exciting and varied.

---

## **🗑️ Remove Slices**

Click the trash icon next to any slice to remove it. The probabilities of remaining slices will automatically determine the new win chances.

---

# **🎨 Step 4 — Design Your Wheel (Optional)**

Switch to the **Design** tab to adjust how the spin wheel looks.

Wheel-specific options you'll find here:

* **Slice Colors** — alternating colors for wheel segments  
* **Slice Label Color & Font** — text styling on the wheel itself  
* **Wheel Color** — the outer ring of the wheel  
* **Arrow Color** — the pointer at the top  
* **Center Circle Color** — the hub in the middle  
* **Slice Message Color & Font** — styling for post-spin messages

💡 The Spin Wheel PopUp comes with warm, playful default colors. You can keep them or align them with your brand.

For a complete walkthrough of all design options, see the dedicated Design & Styling documentation.

---

# **🖱️ Step 5 — Set the Trigger & Display Rules**

Move to the **Placement/Targeting** tab to control when and where your Spin Wheel PopUp appears.

Key settings you'll encounter:

* **Trigger Type** — After Time, Page Scroll, Exit-intent, Add to cart button clicked or After page views  
* **Display Frequency** — Show every time, once per visit, or limit with a cooldown  
* **Page Targeting** — Every page, home only, specific products, collections, or tags  
* **Customer Targeting** — Login status, customer tags, lifetime spent  
* **Geolocation** — All world or specific countries  
* **Scheduling** — Optional start and end dates

For deep explanations of each targeting option, see the dedicated Advanced Targeting documentation.

---

# **✅ Step 6 — Save & Publish**

Once everything looks good:

1. Click **Save** to store your configuration   
2. Click **Publish** to make the popup live on your storefront 

⚠️ **Saving alone does not make the popup visible to customers.** You must publish it.

If the app embed is not yet enabled, a banner will remind you to activate it in your Shopify theme editor.

---

# **🎉 Final Result**

Once configured successfully:

✅ Visitors see an interactive spin wheel on your storefront   
✅ Each spin delivers a randomized reward based on your probability settings   
✅ Emails and phone numbers are collected automatically (if enabled)   
✅ Discount codes are revealed after spinning   
✅ Your popup respects targeting rules, scheduling, and device settings

Your Spin Wheel PopUp is now live and ready to delight your visitors 🚀

---