Offer chain

Offer chains let you create a sequence of steps, each offering an item that can be either claimed for free or purchased. Users move through the chain step by step, unlocking the next offer only after completing the current one.

Use offer chains to drive repeat engagement and retention. They encourage users to return to the game and complete the chain before it expires.

Glossary

Offer
A step in the chain where the user either claims or purchases an item.
Offer chain
A set of offers completed in a defined order. Each new offer becomes available only after the previous one has been claimed or purchased.
Partly available
An item that is hidden from the catalog and can only be accessible via the offer chain.

How it works

Offer chain visibility and behavior

  • Unauthenticated users can see all offer chains available in the store.
  • Once logged in, users only see offer chains available to them based on display conditions.
  • If the user has already claimed or purchased items within a chain, their current progress is displayed — including completed steps and the next available action.
  • If the chain is configured to reset (weekly/monthly), the user’s progress is reset on schedule. After that, the user starts again from the first step.
  • If the user completes all steps, the chain is shown as completed.

Step logic and pricing

Each step in the offer chain is associated with a specific SKU. The price of the step is automatically inherited from the assigned item:

  • If the item is free, the step is also considered free.
  • If the item has a price, the step is paid, and the item must be purchased to move forward in the offer chain.

Note
If the item has a price, but you want the step to be free, set the Offer free reward toggle to On when creating the step in the offer chain via Publisher Account.

SKU visibility and behavior

  • If a SKU is only available through the offer chain, set its status to Partly available in the item settings in Publisher Account to hide it from the general catalog.
  • If a SKU is available for direct purchase, users can buy it separately. However, direct purchases do not affect their progress in the offer chain.

Ignored SKU properties

The offer chain does not consider the following item’s configurations:

  • personalization rules
  • purchase limits
  • scheduled availability (start/end date)
  • promotions and discounts

Offer chain limitations

  • A maximum of 30 steps per offer chain is allowed.
  • Each step must contain only one item.

Refunds

If a purchased item is refunded, the user’s progress in the offer chain is reduced. The associated step is marked as incomplete, and the user cannot proceed further until they claim the item again by purchasing it once more.

Note
Any rewards claimed before the refund are retained. Repeat purchases and refunds are automatically tracked and reflected in the user’s progression history.

Example:

The user completed steps 1, 2, and 3, then requested a refund for the item on step 2. Steps 1 and 3 remain completed, but step 4 is locked until the user completes step 2 again.

User flow

  1. The user goes to the store.
  2. The user sees the available offer chain and the rewards for each step.
  3. The user logs in.
  4. Their current progress in the offer chain is displayed.
  5. The user completes the current step:
    • If the step is free: the user clicks Claim reward.
    • If the step is paid: the user completes a purchase and receives the item.
  6. The user advances to the next step in the offer chain.

How to get it

To set up the offer chain feature in your project, you will need the following details:

DescriptionExampleLimitations
NameWelcome Offer ChainCharacter limit — 35
Explanatory textUnlock new exclusive offers with every step you complete.Character limit — 175
Period01.07.2023 — 15.07.2023Optional
Note
If no end date is provided, the offer chain will run indefinitely.
To set up the offer chain steps, you will need to specify:
DescriptionExampleLimitations
Step content (SKU)sword_1Must match item SKUs in your catalog.
Note
Item images are not set manually. When you assign SKU to a step, the system automatically pulls the item’s name and image.
In your store UI, make sure to display:
  • steps and their status
  • offer chain duration
  • user progress
  • unlocked offers with action buttons

Set up via Publisher Account

Note
Before creating an offer chain, you need to create virtual items, virtual currency, bundles or free items.

Create offer chain

  1. In your project in Publisher Account, go to the LiveOps > Offer chains section.
  2. Click Create offer chain.
  1. Specify the following parameters:
    • Offer chain name.
    • Description (optional).
  2. Click Next.
  1. To configure offer chain steps, click Add step.
  1. Specify the SKU the user can get at this step:
Notice
Each step must contain one SKU.
  1. If the user can get this item for free, set the Offer free reward toggle to On.
  2. Click Save.
  1. Click Add step and repeat 5-8 to add more steps.
  2. Click Next when finished.
  1. Specify the following parameters in Time zone settings:
    • Time zone
    • Start date
    • Start time
    • End date (optional)
    • End time (optional)
Note
If no end date is specified, the offer chain will run indefinitely.
  1. If you want to make the offer chain recurring, set the Make offer chain renewable toggle to On and specify the following parameters:
    • Renewal period
    • Renewal day
    • Renewal time (optional)
  2. Click Create. The offer chain is created with status Inactive.
  1. To activate it, click next to the offer chain.
  2. Click Publish action, offer chain status will change to Active.

Edit offer chain

To edit the offer chain chain:
  1. In your project in Publisher Account, go to the LiveOps > Offer chains section.
  2. Click next to the chain.
  3. Click Edit and make the changes you need.
  4. Click Next.
  1. To add steps in the offer chain, click Add step.
    1. Specify the SKU the user can get at this step:
Note
Each step must contain exactly one SKU.
    1. If the user can get this item for free, set the Offer free reward toggle to On.
    2. Click Save.
  1. To edit an existing step, click the pencil icon and make the changes you need.
  1. To delete a step, click Delete.
  1. Click Next when finished.
  1. Make changes in Time zone settings if needed.
  2. Check the Make offer chain renewable toggle and the following parameters.
  3. Click Save.

Delete offer chain

To delete the offer chain:
  1. In your project in Publisher Account, go to the LiveOps > Offer chains section.
  2. Choose the desired offer chain from the list and click next to it.
  3. Click Delete.

Set up via API calls

You can use methods from the Admin subsection of the Offer chains method group to manage the offer chains.

You can use methods from the Client subsection of the Offer chains method group to manage the offer chains.

You can also modify, disable, or delete the offer chains.

Was this article helpful?
Thank you!
Is there anything we can improve? Message
We’re sorry to hear that
Please explain why this article wasn’t helpful to you. Message
Thank you for your feedback!
We’ll review your message and use it to help us improve your experience.
Last updated: August 31, 2025

Found a typo or other text error? Select the text and press Ctrl+Enter.

Report a problem
We always review our content. Your feedback helps us improve it.
Provide an email so we can follow up
Thank you for your feedback!
We couldn't send your feedback
Try again later or contact us at doc_feedback@xsolla.com.