Understanding the Offer mode
This article explains about how the offer mode works in the Screen composer
Offer mode in Purchasely screen composer allows you to display an alternative copy or price for your offers. This feature is perfect for new user acquisition, retention and winback an expired user and lets you leverage the same Screen / Paywall both for end-users who are eligible to an Offer and those who are not.
When is Offer Mode displayed?
Offer Mode is displayed only when the end-user is eligible for the Offer associated with the plan—either an Introductory Offer or a Promotional Offer configured in the Offering. If no specific text has been defined for Offer Mode, the SDK automatically falls back to the Regular Mode text.
If the user is eligible for the two offers, iOS and Android do not use the same offer. See Which offer the SDK uses.
Which offer the SDK uses
A plan can have an introductory offer (for example a free trial) and a promotional offer in its Offering. The SDK selects one offer. It uses this offer for the Offer mode texts, the offer price tags and the purchase. iOS and Android select the offer in a different order, because the App Store and Google Play give offers to users in different ways.
| Platform | Order | Why |
|---|---|---|
| iOS | 1. The introductory offer, if the user is eligible for it. 2. If not, the promotional offer of the Offering, if the App Store gives it to the user. 3. If not, the Regular mode. | The App Store gives promotional offers only to current and past subscribers. |
| Android | 1. The offer of the Offering (promotional or developer determined offer), if Google Play gives it to the user. 2. If not, the introductory offer (the default offer of the base plan), if the user is eligible for it. 3. If not, the Regular mode. | Google Play gives a "New customer acquisition" offer only to an eligible user. Thus the offer of the Offering already follows the eligibility rules of Google Play. |
The default offer of an Android base plan is its first offer without the ignore-offer tag.
Example: a plan has a 7-day free trial, and its Offering contains a 40% discount offer.
- On Android, a new user sees and buys the 40% discount, not the free trial.
- On iOS, the same user sees and buys the free trial.
In Observer mode, the SDK sends the selected offer to your purchase interceptor. On Android, the Purchase action contains this offer in offer and subscriptionOffer.
Developer determined offers (Google Play)
Google Play gives a "Developer determined" offer to all users. Your app decides which users are eligible. Thus, on Android, if the Offering contains a developer determined offer, the SDK shows the Offer mode and buys this offer for all users. isEligibleToOffer(storeOfferId) also returns true for all users.
To give this offer only to the users that you select, use one of these solutions:
- A user attribute. Set a custom user attribute from your app (for example
eligible_promo_offer). Use it in a conditional visibility rule or in an Audience. Show the purchase button with the Offering only to these users. - The eligibility to the introductory offer. Use the Eligibility for an Offer condition. Show a purchase button without Offering to the users who are eligible for the introductory offer. Show the purchase button with the developer determined offer to the users who are not eligible.
The "Eligibility for an Offer" conditionThe Eligibility for an Offer condition checks only the introductory offer, on iOS and on Android. It does not check the promotional offer of the Offering. Thus, on Android, a component with this condition can stay hidden while the purchase button buys the promotional offer.
How to customize a paywall for offer mode:
Once you have prepared a paywall for Regular Mode, you turn on the offer mode radio button on the top of the screen and customize each and every text element you have filled for the regular mode you can customize it for offer mode.

How to display the offer price for different regions ?
Purchasely provides you with tags to automatically to fetch the offer price and offer duration.
Use the following tag to show the the introductory offer or new user acquisition offer & promotional offer or developer determined offer price.
| Tag | Usage | Example |
|---|---|---|
OFFER_PRICE | Displays the winback offer price. | For a winback offer :
|
OFFER_AMOUNT | Displays the winback offer amount. | For a winback offer :
|
OFFER_PERIOD | Displays the winback offer period. | For an extension of a free trial:
|
OFFER_DURATION | Displays the winback offer duration. | For a winback:
|
OFFER_PRICE_COMPARISON | Displays the price difference between the discounted offer and the regular price of the plan for the higher duration. | With:
|
OFFER_DISCOUNT_PERCENTAGE | Displays the discount percentage between the discounted offer and the regular price of the plan. | With:
|
Get user eligibility to introductory offer
Purchasely SDK provides a method to retrieve easily from your application if a user is eligible to a introductory offer (or free trial)
More information in the dedicated article
Updated 19 days ago
What’s Next
Check Dynamic Offering to learn more about how to associate multiple offering to a same Paywall

