Paywall Offers: Introductory, Promotional, and Offer Codes
A single subscribe button rarely fits every subscriber. New users, lapsed subscribers, and special segments each arrive with different histories and different reasons to say yes. This guide explains the offer types a paywall can present, how eligibility and targeting work together, and how to configure each flow in the Paywall Editor.
Which offer type fits which audience?
Start by matching the offer mechanism to the customer's subscription history and the platform's rules.
- Introductory offer — aimed at first-time buyers. Usually a free trial or a reduced initial price. When the product has an introductory offer configured on the App Store or Google Play, the offer is presented automatically to eligible customers at checkout.
- App Store offer codes — codes distributed by the developer and redeemed inside the app. Useful for campaigns, events, or partner handouts.
- App Store promotional offers — configured in App Store Connect and linked to a paywall package. Suited to winning back previous subscribers or rewarding loyal customers.
- Play Store multiple introductory offers — a single Google Play product can carry more than one introductory offer, for example one month free or three months at half price.
A quick decision path:
- Is the user new and eligible for a first-purchase offer? Use an introductory offer.
- Is the user a lapsed subscriber on iOS? Consider a promotional offer.
- Are you distributing a code through a campaign or event? Use an App Store offer code with a redemption button.
- Does the Google Play product carry more than one intro option? Use the Play Store-only multiple introductory offers text field so the correct message appears.
Configuring introductory offer copy
To highlight an introductory offer in paywall text:
- In the Paywall Editor, select the text component you want to customize.
- Click the plus icon next to the Text field for an introductory offer.
- Enter a unique string, for example "Start today and get your first week free!" or "Your first 3 months are only $0.99 each."
A meditation app could show "Relax for free this week, your 7-day trial starts now!" only to eligible new users. The point is to make the offer visible in the copy rather than leaving it buried in checkout.
On Google Play, where a product can carry multiple introductory offers, use the Play Store-only multiple introductory offers text field. Secondary offer variables can display the price and duration of the second offer, so a productivity app might show "Enjoy 1 month free" to students and "Get 3 months at 50% off" to professionals.
Offer codes and promotional offers on iOS
Offer codes. Add a redemption button to the paywall. When tapped, the native iOS redemption sheet opens; the user enters the code, accepts the offer, and continues the subscription flow. A language learning app at a conference could hand out "1 free month" codes and let the app handle redemption.
Promotional offers. Configure the offer in App Store Connect, then in the Paywall Editor:
- Open the package component.
- Enter the Promotional Offer Identifier from App Store Connect.
- Configure unique strings for eligible users.
If the user is eligible under Apple's rules — for example, they have subscribed before — the promotional offer text fields appear automatically.
Eligibility vs. targeting: two different controls
These two mechanisms are often confused, but they answer different questions.
- Eligibility is determined by Apple or Google from the user's subscription history. It decides whether the user can technically receive a given offer. When a user qualifies, variables such as
offer_priceandoffer_durationbecome available and can be inserted into paywall text. - Targeting is your decision as the developer. It decides which paywall a given audience sees in the first place, based on customer attributes, paywall placement in the app, or experiment groups.
A useful way to think about it: eligibility is a gate, targeting is a routing choice. A returning subscriber who is also a verified student is not eligible for the intro trial, so targeting can route them to a student-discount paywall instead.
Because eligibility changes the available variables, the same screen can read differently to two customers. A new user might see "Get started with your first 3 months at $1.99/month" while an existing one sees "Continue your journey for $9.99/month." The display adapts to the user's state, but the underlying logic is handled by the system.
Looking for paywall inspiration? Browse real examples at Paywalls.com, where you can filter paywall screens by different UI elements, app category, and trending and top-growth paywalls.
Worked example: three segments, one paywall system
Consider a language learning app with three audiences: brand-new installs, lapsed subscribers, and verified students.
Step 1 — eligibility-driven copy. New installs are marked eligible for the introductory offer by the App Store. Configure the paywall text to insert offer_price and offer_duration, producing something like "Start your journey with 1 month free, then continue at just $9.99/month." The same paywall shows non-eligible users "Keep learning for $9.99/month, cancel anytime." One paywall, two messages.
Step 2 — targeting on top. Route audiences to the right paywall:
- Onboarding: all new users see the introductory-offer paywall.
- Lapsed subscribers: a win-back paywall built around a promotional offer, e.g. "Welcome back! Reactivate your subscription for 3 months at 50% off."
- Verified students: a student-discount paywall, e.g. "As a student, get full access for $4.99/month."
Step 3 — measure. Run A/B tests within targeted groups. In the source's illustrative scenario, one win-back variant ("3 months at 50% off") is reported to produce 25% higher reactivation than the other ("1 month free, then $9.99"), and the winning variant is adopted for that segment. Treat that figure as the source's reported result for this example, not as a general benchmark for your app.
Configuration checklist before launch:
- [ ] Offer configured in App Store Connect or Google Play, with identifiers recorded.
- [ ] Paywall text component includes the correct offer variable or unique string.
- [ ] Google Play products with multiple intro offers use the multiple-offers text field.
- [ ] Offer code paywalls include a working redemption button.
- [ ] Promotional offer identifier entered on the package component.
- [ ] Targeting rules reviewed for overlaps (e.g. student + returning subscriber).
- [ ] A/B test groups defined and a success metric chosen before launch.
Frequently asked questions
What is the difference between offer eligibility and paywall targeting?
Eligibility is set by the platform (Apple or Google) based on the user's subscription history and determines whether the user can receive a particular offer. Targeting is your own routing decision — based on customer attributes, paywall placement, or experiment groups — that determines which paywall the user sees. Both can apply at once: a returning subscriber who is also a student is not eligible for the intro trial, but can be targeted to a student-discount paywall.
Can a single Google Play product have more than one introductory offer?
Yes. A Google Play product can carry multiple introductory offers, such as one month free or three months at 50% off. Use the Play Store-only multiple introductory offers text field to display the correct message, and secondary offer variables to show the price and duration of the second offer.
Where do I enter the Promotional Offer Identifier?
In the Paywall Editor, open the package component and enter the identifier from App Store Connect. Configure unique strings for eligible users; when a user qualifies under Apple's rules, the promotional offer text fields appear automatically.
How do App Store offer codes work on a paywall?
Add a redemption button to the paywall. Tapping it opens the native iOS redemption sheet, where the user enters the code, accepts the offer, and continues the subscription flow.