# Lucky wheel

{% embed url="<https://youtu.be/wLZEzMcz2-U?si=8n7J2GEqOMIfy-KP>" %}

The **Lucky wheel** feature delivers discount codes to visitors with a gamified discount pop-up.&#x20;

To receive a discount, all shoppers need to do is spin the wheel! This simple game has been proven to dramatically increase visitor engagement and customer loyalty.

![](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MlL6sK9D7unq8F2VPPp%2Fuploads%2FdOKsg0UF24MErl6PIhIo%2FScreen%20Shot%202021-10-30%20at%2016.41.46.png?alt=media\&token=0d9ece12-8aab-46f8-8359-b370d6ad976b)

{% hint style="success" %}
Steps:

1\. Go to **FoxKit** > **FoxKit power** > Choose **Lucky wheel.**

2\. Make necessary changes.

3\. **Save.**
{% endhint %}

<figure><img src="https://1222926902-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2gqo9glygWoTkEqRV1dN%2Fuploads%2FIuqEOw0VgWDSqJ9HyRfu%2Flivechat883x471%20(1).png?alt=media&#x26;token=2d55e471-68de-413c-8041-8ae9c7f700a3" alt=""><figcaption><p><a href="https://apps.shopify.com/xflow?utm_source=foxecom&#x26;utm_medium=help_center_foxkit_lucky_wheel&#x26;utm_campaign=anchor-text&#x26;utm_term=install_xflow_back_in_stock_automation_free">Install XFlow Back In Stock Automation FREE</a></p></figcaption></figure>

## General

### Status & Limitation

* **Status**
  * **Active**: Check this box to activate the Lucky Wheel.
  * **Show on Mobile**: Ensure this option is checked to make the Lucky Wheel accessible for mobile users.

<figure><img src="https://1222926902-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2gqo9glygWoTkEqRV1dN%2Fuploads%2FsXLsdJcVlOZFcWbn1dqY%2FScreenshot%202025-05-30%20at%2014.57.30.png?alt=media&#x26;token=965a8a31-0e92-466f-8ea5-2f87ef238445" alt=""><figcaption></figcaption></figure>

* **Configuration**
  * **Allow play multiple times with the same email?**:

    * If unchecked, users can spin the wheel only once using the same email, preventing repeated participation.
    * If checked, users can play multiple times with the same email, allowing repeated engagement.

  * **Auto apply coupon on checkout page:**
    * If unchecked, users will need to manually enter the coupon code on the checkout page.&#x20;
    * If checked, the coupon code is automatically applied at checkout page.

<figure><img src="https://1222926902-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2gqo9glygWoTkEqRV1dN%2Fuploads%2FbH49L2ce01roQyPfIPZs%2FScreenshot%202025-05-30%20at%2014.58.07.png?alt=media&#x26;token=abcf3603-0392-4a47-ae05-1c49671fdf94" alt=""><figcaption></figcaption></figure>

* **Fields:** The **Fields** section in the FoxKit Lucky Wheel feature allows you to customize the information you collect from users before they spin the wheel.

<figure><img src="https://1222926902-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2gqo9glygWoTkEqRV1dN%2Fuploads%2FVoj68Bhj3xBwlC0hfl6Q%2FScreenshot%202025-05-30%20at%2015.28.50.png?alt=media&#x26;token=03f62fad-4114-41f7-8840-e8e5a68e82d3" alt=""><figcaption></figcaption></figure>

#### **Default fields**

* **Email (required):** This field is mandatory and ensures you collect valid email addresses for sending rewards or marketing campaigns.

#### **Adding new fields**

You can add more fields to the form by clicking **+ Add more field**. Here's how:

1. Click the **+ Add more field** button.&#x20;
2. Choose a field type from the dropdown menu:

* **First name**: Collect users’ first names.
* **Last name**: Capture last names for better personalization.
* **Phone**: Gather phone numbers for SMS marketing or notifications.
* **Birthday**: Collect birthdates for personalized offers (e.g., birthday discounts).
* **Agree to terms checkbox**: Add a checkbox for users to agree to specific terms or policies.

<figure><img src="https://1222926902-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2gqo9glygWoTkEqRV1dN%2Fuploads%2FYzjUxEHqGNPymCIq7QaC%2FScreenshot%202025-05-30%20at%2015.53.24.png?alt=media&#x26;token=e6c183f6-fb1f-40fa-b5d7-8f7bc4fbce5c" alt=""><figcaption></figcaption></figure>

3. Enter the **Field label** to customize the label users see

<figure><img src="https://1222926902-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2gqo9glygWoTkEqRV1dN%2Fuploads%2FTPYO78Kfa8FIqFZrISfz%2FScreenshot%202025-05-30%20at%2015.53.55.png?alt=media&#x26;token=9c76c8df-7973-4f8f-905a-b445aad93b4e" alt=""><figcaption></figcaption></figure>

4. Check the **Required field** box if the field is mandatory.
5. Click **Add Field** to save the new field.

*For example:*

<div><figure><img src="https://1222926902-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2gqo9glygWoTkEqRV1dN%2Fuploads%2FqlVhGoFh7IRTL9MUHd0B%2Fimage.png?alt=media&#x26;token=8d90d541-02f1-4b5f-bdb6-c4f1121af21c" alt=""><figcaption></figcaption></figure> <figure><img src="https://1222926902-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2gqo9glygWoTkEqRV1dN%2Fuploads%2FWAytGljokgeEukrRaKJZ%2Fimage.png?alt=media&#x26;token=dae64b83-fab9-46e0-9611-5cd772364435" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
You can change the order of these fields by using a simple **drag-and-drop** feature.
{% endhint %}

### Data collection

Decide where the data will be collected:

* Shopify customers list
* FoxKit subscribers list
* Additional integrations like **Klaviyo**, **Mailchimp**, **Omnisend**, or **SendGrid** can be added through the integration menu.

<figure><img src="https://1222926902-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2gqo9glygWoTkEqRV1dN%2Fuploads%2FPmohasYrN6fKAyCzWLH4%2Fimage.png?alt=media&#x26;token=54de7662-8fa0-4b1d-891a-df590345bf0a" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1222926902-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2gqo9glygWoTkEqRV1dN%2Fuploads%2FH5sqiyvr25O7SEOp4xU4%2Fimage.png?alt=media&#x26;token=0c65dfe8-062c-45cd-912d-e241d8887886" alt=""><figcaption></figcaption></figure>

## Content

### Main content

<div><figure><img src="https://1222926902-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2gqo9glygWoTkEqRV1dN%2Fuploads%2FYUY5GJFviCT2RqKjknYZ%2Fimage.png?alt=media&#x26;token=d122313d-18be-4783-b29d-3234f0d5cbac" alt=""><figcaption></figcaption></figure> <figure><img src="https://1222926902-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2gqo9glygWoTkEqRV1dN%2Fuploads%2FFn7IKM4da8MKLV7G2XjU%2Fimage.png?alt=media&#x26;token=d72f55b5-03e0-4527-a070-e8abf1e3b80c" alt="" width="562"><figcaption></figcaption></figure></div>

* **Title**: The main headline that appears above the wheel.
  * Example: *"Spin to get a prize!"*
* **Subtitle**: The supporting text that provides instructions or additional information.
  * Example: *"Enter your email to spin the wheel for a chance to win a coupon."*
* **Button**: The text displayed on the action button.
  * Example: *"Try your luck"*

### Win screen & Coupon card

Add the needed text/phrase for the title and button of the win screen and coupon card when customers win a prize.

<figure><img src="https://1222926902-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2gqo9glygWoTkEqRV1dN%2Fuploads%2FvEzAt1iPoGHde6DCNJeb%2Fimage.png?alt=media&#x26;token=e59a2895-d439-4598-b829-da3a64cf3744" alt=""><figcaption></figcaption></figure>

* **Win screen**
  * **Title:** The main message users see when they win.
    * Example: *"Hurray!"*
  * **Subtitle:** Additional information about the reward.
    * Example: *"You win a \[Reward Name]"*.

<figure><img src="https://1222926902-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2gqo9glygWoTkEqRV1dN%2Fuploads%2FBgW3A2eN7VVpcNp4zbMX%2FScreenshot%202025-05-30%20at%2016.11.54.png?alt=media&#x26;token=7133182a-0b51-4773-88d1-8959822dbabc" alt=""><figcaption></figcaption></figure>

* **Coupon card**
  * **Discount code label:** The text displayed when a discount code is generated.
    * Example: *"Your discount code is"*
  * **Lose label:** The message shown if no prize or discount is awarded.
    * Example: *"Oops, there is no discount code for this!"*
  * **Continue button:** The text on the button users click to proceed after seeing the result.
    * Example: *"Continue & Use Discount"*
  * **Note:** A reminder or additional instruction about using the discount code.
    * Example: *"Remember to use your discount code when you checkout."*

<figure><img src="https://1222926902-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2gqo9glygWoTkEqRV1dN%2Fuploads%2FwONUx1GKBjTaffFNYK8X%2Fimage.png?alt=media&#x26;token=c77fb192-8827-4e5c-b3c9-fc493280ec19" alt=""><figcaption></figcaption></figure>

## Prizes

This setting is to create prizes, including names, background colors, discount codes, and the chance to win them.

{% hint style="warning" %}
Make sure that discount codes are correctly set up in Shopify. Once they are created, paste the codes in the "Discount code" fields.&#x20;

[Learn how to create discount codes with Shopify.](https://help.shopify.com/en/manual/discounts/create-discount-codes)
{% endhint %}

{% hint style="info" %}
Each prize will be displayed 2 times.
{% endhint %}

<figure><img src="https://1222926902-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2gqo9glygWoTkEqRV1dN%2Fuploads%2FMfcrTB0GGN8U7oZnYMkU%2FScreenshot%202025-05-30%20at%2016.13.45.png?alt=media&#x26;token=ef998e79-2d41-476a-abdc-d6c6db68824a" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Easily search and select from a list of available [Shopify Discount](https://help.shopify.com/en/manual/discounts) codes using the module ***discount codes picker.***
{% endhint %}

<figure><img src="https://1222926902-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2gqo9glygWoTkEqRV1dN%2Fuploads%2FUFDB6c31Fbyn6cCkqc5I%2FScreenshot%202025-05-30%20at%2016.14.11.png?alt=media&#x26;token=5e9f17bf-2672-4e13-bad5-2dead3b32525" alt=""><figcaption></figcaption></figure>

## Design

Pick the desired color for text, button, popup background, etc.

<figure><img src="https://1222926902-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2gqo9glygWoTkEqRV1dN%2Fuploads%2F9VjpHvhT0hOv1pY1m1bY%2FScreenshot%202025-05-30%20at%2016.17.47.png?alt=media&#x26;token=87531367-79e9-41e8-b51a-051d5283fa38" alt=""><figcaption></figcaption></figure>

## Display settings

### Trigger conditions

Determine when the pop-up is displayed, it can be either:

* After the page is loaded;
* After a specific time (seconds);
* After the visitor scrolls down the page;
* When the visitor is about to leave the website (desktop view only);
* Not open the pop-up automatically.

<figure><img src="https://1222926902-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2gqo9glygWoTkEqRV1dN%2Fuploads%2F773rXnJXG3cKtOyXxZDk%2FScreenshot%202025-05-30%20at%2016.19.25.png?alt=media&#x26;token=9888035a-6d4a-4e76-80b3-0b17749d84ce" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
This automatic pop-up will not show to customers who have already converted.
{% endhint %}

### Display conditions&#x20;

Determine where the pop-up appears:&#x20;

* on all pages: Show the pop-up on every page.
* only on certain pages of your website
  * **Home page only**: Show the pop-up on the home page only.
  * **Conditions**: Show the pop-up on the specific pages that meet all the rules or any rules you set.&#x20;

    * The condition can be set based on the **page type** or **page URL**. For page URL, don't forget the protocol "http\://", "https\://".
      * **Is equal to**: Add the page type or page URL you want the pop-up to appear on.

    *For example*: 'Page type is equal to Product pages' to display the popup on all product pages of your website.

    * **Is not equal to** Add the page type or page URL you do not want the pop-up to appear on.
    * **Contains**: Add the page type or page path segment value to display the pop-up on URLs that contain that value.

    *For example*: 'Page URL contains all' to display the pop-up on page URLs that have the word 'all'.

    * **Does not contain**: Add the page type or page path segment to exclude the pop-up on certain a page type or URLs that contain that value.

<figure><img src="https://1222926902-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2gqo9glygWoTkEqRV1dN%2Fuploads%2Fb1eb8AZdM8QgDjEIUOaD%2FScreenshot%202025-05-30%20at%2016.20.43.png?alt=media&#x26;token=8650d652-7dc0-45d5-a3c9-16d498cc3e23" alt=""><figcaption></figcaption></figure>

### Display Frequency

You can set the display frequency of the pop-up.

<figure><img src="https://1222926902-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2gqo9glygWoTkEqRV1dN%2Fuploads%2FxUnezadGCN3KJBGKNKUe%2Fimage.png?alt=media&#x26;token=d8882cd3-b045-48ee-a196-467c1411f6e3" alt=""><figcaption></figcaption></figure>

### Teaser button settings

The teaser button appears when the pop-up is not displayed to encourage the users to subscribe later.&#x20;

You can set it to **always show** the teaser button or only **after the popup has opened** and the customer clicks the 'X' close button.

The **position** of the button can be set to Left or Right.

<figure><img src="https://1222926902-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2gqo9glygWoTkEqRV1dN%2Fuploads%2FG9ScGXzNHq70WGcnaivh%2FScreenshot%202025-05-30%20at%2016.24.14.png?alt=media&#x26;token=6df2a067-9001-470e-bf41-9a2dac7c782e" alt=""><figcaption></figcaption></figure>

<div data-full-width="false"><figure><img src="https://1222926902-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2gqo9glygWoTkEqRV1dN%2Fuploads%2FiQVIGG7Toe9zV07mx6Gx%2FFoxEcom%20changelog%20%20%201250%20x%20200-2.png?alt=media&#x26;token=3363fb37-252d-4d8a-87a4-5d49619a388a" alt=""><figcaption><p><a href="https://foxecom.com/pages/affiliate?utm_source=foxecom&#x26;utm_medium=help_center_foxkit_lucky_wheel&#x26;utm_campaign=anchor_text&#x26;utm_term=explore_foxecom_affiliate_program_perks_now">Explore FoxEcom Affiliate Program perks now</a> <span data-gb-custom-inline data-tag="emoji" data-code="2728">✨</span></p></figcaption></figure></div>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.foxecom.com/foxkit-app/sales-boosting/lucky-wheel.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
