--- title: "Reward Milestones guide" slug: "reward-milestones-guide" updated: 2026-02-05T20:47:16Z published: 2026-02-06T19:48:02Z --- > ## Documentation Index > Fetch the complete documentation index at: https://help.skio.com/llms.txt > Use this file to discover all available pages before exploring further. # Reward Milestones guide > [!WARNING] > Before enabling Reward Milestones, you should have at least one **active** [Surprise and Delight rule](/help/docs/how-to-set-up-a-surprise-delight-rule). ## What is the Reward Milestones feature? Reward Milestones is a visual progress tracker that displays a customer's journey toward earning rewards through your [Surprise and Delight rules](/help/docs/how-to-set-up-a-surprise-delight-rule). This feature shows customers exactly which order numbers will unlock specific discounts and gifts, creating anticipation and encouraging subscription retention. When enabled, Reward Milestones appears at the top of each customer's subscription page in the Customer Portal, showing a timeline of upcoming rewards. Customers can see what they'll earn on future orders, helping them understand the value of maintaining their subscription over time. ## How Reward Milestones work Reward Milestones work exclusively with Surprise and Delight rules based on order numbers. Each milestone displays what reward a customer will receive when they reach that specific order count-whether it's a discount, a free gift, or both. Milestones only appear for orders the customer hasn't reached yet, plus any reward they're currently earning on their next order. Once a customer completes an order and receives a reward, that milestone appears greyed out and *redeemed* on the timeline. ## How to enable Reward Milestones in the Customer Portal ![](https://cdn.us.document360.io/a953bba6-c70d-43ce-bc77-d7f32a8fc514/Images/Documentation/CleanShot 2026-01-14 at 13.43.58@2x.png) Toggle on **Reward Milestones** in your Customer Portal settings 1. In the lefthand menu of your Skio Dashboard, go to **Storefront**>**Customer Portal** 2. In the **Branding**tab, go to **Layout** 3. Click the **Reward Milestones** toggle to enable 4. Click **Publish** > Once enabled, eligible customers will immediately see Reward Milestones displayed at the top of their subscription page in the **Customer Portal**. ## How Reward Milestones display ### Where customers see milestones ![](https://cdn.us.document360.io/a953bba6-c70d-43ce-bc77-d7f32a8fc514/Images/Documentation/CleanShot 2025-12-04 at 13.37.31.png) Reward Milestones appear at the top of the customer's subscription page in the Customer Portal, above the product details. Customers only see milestones for order numbers they haven't reached yet, plus any reward they're currently earning on their next order. ![](https://cdn.us.document360.io/a953bba6-c70d-43ce-bc77-d7f32a8fc514/Images/Documentation/CleanShot 2025-12-04 at 13.40.02.png) Once they unlock the reward, the “Surprise gift unlocked in the next order” message disappears and the unlocked reward milestone is highlighted in the Reward Milestones widget. ### What customers see for each milestone ![](https://cdn.us.document360.io/a953bba6-c70d-43ce-bc77-d7f32a8fc514/Images/Documentation/CleanShot 2025-12-04 at 13.48.06.png) For **discount rewards**, the milestone displays the discount amount (e.g., "2% off" or "$20 off"). For **gift rewards**, the milestone shows the product image of the gift. If no product image exists, a generic gift box icon displays instead. ### When customers earn multiple rewards on one order If a customer earns multiple rewards on the same order, Reward Milestones displays the most valuable or popular item: - **Multiple discounts:**The highest-value discount displays (e.g., $50 off shows instead of 2% off) - **Multiple gifts:**The most popular gift displays based on your store's product popularity data - **If all gifts have equal popularity:**The first gift item in the rule displays ## How milestones update dynamically ### When you modify rules Reward Milestones update automatically when you add, remove, or modify Surprise and Delight rules. After saving rule changes, click **Sync rules** in your **Rules** settings to immediately reflect updates in customer portals. ### When you add or remove conditions If a Surprise and Delight rule includes conditions (such as minimum total quantity or specific product requirements), the milestone only displays for customers who meet those conditions. When you add conditions to an existing rule, customers who don't meet the criteria will no longer see that milestone. ### How milestones display with fewer rewards If you have only one or two active Surprise and Delight rules, the milestone timeline stretches horizontally to fill the available space. The visual layout adjusts automatically based on the number of configured milestones. ## Common behaviors ### Customer swaps a gift reward If a customer swaps a gift product in their order, the Reward Milestone image continues showing the original gift image. This is expected behavior and helps maintain consistency in what customers anticipate earning. ### Customer cancels an order with an active reward When a customer cancels an order that included a pending reward, that reward no longer displays in their milestones. The milestone timeline updates to reflect only upcoming orders. ### Customer skips an order with a pending reward If a customer skips an order that would have earned a reward, the reward remains attached to that order number. When the customer processes that order in the future, they'll still receive the reward. ### Merchant deletes an active reward rule If you delete a Surprise and Delight rule that customers were progressing toward, that milestone immediately disappears from all customers. --- ### FAQ #### Which customers see Reward Milestones? Customers see Reward Milestones if they have an active subscription and their current order count is less than your highest configured Surprise and Delight rule. For example, if your highest rule triggers on order #15 and a customer has completed 3 orders, they'll see milestones for orders #4 through #15. #### What happens if I change a reward after customers see it? If you modify a Surprise and Delight rule that customers are progressing toward, the milestone updates to reflect the new reward. Click **Sync rules** on your **Rules** page after making changes to immediately update customer portals. #### Can I show Reward Milestones for specific customer segments only? Yes. Use conditions in your Surprise and Delight rules to control which customers see specific milestones. Only customers who meet the rule's conditions will see that milestone in their portal. #### Why don't some customers see any milestones? Customers may not see milestones if: - [ ] They don't have any active subscriptions - [ ] Their current order count exceeds your highest configured Surprise and Delight rule - [ ] They don't meet the conditions set in your active rules - [ ] You haven't configured any Surprise and Delight rules #### Can customers see historically redeemed rewards? Yes, customers can view their milestone progress and unlocked rewards directly in their customer portal in the Reward Milestones widget, which shows both upcoming milestones and those they've already achieved. The Customer Portal is an interface that allows subscribers to manage their subscriptions, including options to pause, modify, or cancel their subscription plans. Your Skio Dashboard is the backend view of Skio where you manage your subscription program. This is the page you see when you log in to the Skio app, and it's where you'll configure products, view customer data, adjust settings, and access analytics to monitor your subscription performance.