> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gameball.co/llms.txt
> Use this file to discover all available pages before exploring further.

# How Do I Set Up Milestone?

> Reward customers when they hit spending or item-count thresholds within a timeframe.

| Platform     | Plan   |
| ------------ | ------ |
| Shopify      | Add-on |
| Salla        | Add-on |
| Non-Platform | Add-on |

The **Milestone Campaign** is a rule-based campaign that accumulates a customer's eligible spend or item count across orders during a defined period (e.g., **SAR 500 per month**). Help increase **AOV** and **repeat purchase frequency**.

**Use Cases:**

1. **Spending Milestones**
   Reward based on total spend within a period.
   *Example:* "Spend **$1000** and get a **$100** gift card."

2. **Collection/Tag/SKU/Branch-Specific Milestones**
   Only spending on a chosen collection/category/SKU counts.
   *Example:* "Spend **$500** on **Electronics** and get **$50** off your next order."

3. **Items-Purchased Milestones (count)**
   Reward by quantity of items, regardless of price.
   *Example:* "Buy **10** items and get **20%** off next order."

<Frame>
  <img src="https://mintcdn.com/gameball/7MhWO6bij8idxYce/images/product-docs/rewards-campaigns/templates/engagement-gamification/milestone-preview.png?fit=max&auto=format&n=7MhWO6bij8idxYce&q=85&s=82d7058b70173da67b0074695ab4c342" alt="Milestone preview" width="3192" height="1934" data-path="images/product-docs/rewards-campaigns/templates/engagement-gamification/milestone-preview.png" />
</Frame>

***

## How to Set Up

<Steps>
  <Step title="Open Gameball">
    Log in to your Gameball dashboard.
  </Step>

  <Step title="Add a Reward Campaign">
    Click **Add Reward Campaign**.
  </Step>

  <Step title="Select the Template">
    Choose the **Milestone** template.
  </Step>

  <Step title="Configure the Campaign">
    Edit the campaign's setup to match your goals.
  </Step>

  <Step title="Activate">
    Click **Set Live** to activate the campaign.
  </Step>
</Steps>

***

## Campaign Trigger

<Steps>
  <Step title="Select Attribute">
    Select the **attribute to track** (e.g., *Total price*).
  </Step>

  <Step title="Choose Progress Method">
    Choose the **progress method**: **Cumulative** (adds up across orders).
  </Step>

  <Step title="Set Threshold">
    Set the **milestone threshold** that triggers the reward (e.g., **\$1,000**).
  </Step>

  <Step title="Add Filters (Optional)">
    Add **filters/conditions** -- e.g., item **quantity**, specific **collection/category/SKU**, branch, etc.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/gameball/7MhWO6bij8idxYce/images/product-docs/rewards-campaigns/templates/engagement-gamification/milestone-trigger.png?fit=max&auto=format&n=7MhWO6bij8idxYce&q=85&s=6f60e62e97ef9dda64448a3778803991" alt="Milestone trigger configuration" width="5058" height="1816" data-path="images/product-docs/rewards-campaigns/templates/engagement-gamification/milestone-trigger.png" />
</Frame>

This template uses the standard reward campaign setup. See the [Generic Setup Guide](/product-documentation/rewards-campaigns/start-from-scratch/setup-reward-campaign) for details.

***

## How It Works for Customers

<Steps>
  <Step title="Begin Milestone">
    A customer begins the milestone by placing an order that **meets the configured conditions**.
  </Step>

  <Step title="Progress Accumulates">
    Each **eligible order** counts **toward** the customer's progress.
  </Step>

  <Step title="Milestone Completed">
    Once the milestone is **completed**, the configured reward is issued **immediately** (e.g., points, discount, badge).
  </Step>

  <Step title="New Round (if repeatable)">
    If the milestone is **repeatable**, completion starts a **new round**: the next eligible order resets progress, and the widget displays the **new progress** toward the next milestone.
  </Step>
</Steps>

## Customization

**Design & Content**

You can fully customize each stage of the campaign through dedicated tabs representing the different screens in the flow:

* **Main Screen**
* **Success Screen**
* **Terms & conditions**

For each screen, you can tailor the following elements:

* **Branding**: Adjust background colors, text colors, and upload custom artworks.
* **Content**: Edit the headlines, descriptions, and call-to-action messages to match your tone and messaging.

This allows you to create a fully branded, on-theme experience that aligns with your business identity.

<Frame>
  <img src="https://mintcdn.com/gameball/7MhWO6bij8idxYce/images/product-docs/rewards-campaigns/templates/engagement-gamification/milestone-customization.png?fit=max&auto=format&n=7MhWO6bij8idxYce&q=85&s=832f6a1e0abf6fd91915343c443d74e3" alt="Milestone customization" width="4088" height="2150" data-path="images/product-docs/rewards-campaigns/templates/engagement-gamification/milestone-customization.png" />
</Frame>

***

## Related Articles

<CardGroup cols={2}>
  <Card title="Set up a reward campaign" icon="flag" href="/product-documentation/rewards-campaigns/start-from-scratch/setup-reward-campaign">
    Step-by-step guide to configuring any reward campaign.
  </Card>

  <Card title="Reward types in Gameball" icon="gift" href="/product-documentation/rewards-campaigns/start-from-scratch/setup-reward-campaign">
    Explore the different reward types you can offer customers.
  </Card>

  <Card title="Notification after earning a reward" icon="bell" href="/product-documentation/rewards-campaigns/start-from-scratch/setup-reward-campaign">
    Configure how customers are notified when they earn a reward.
  </Card>
</CardGroup>
