Paywall Design Best Practices for Subscription Apps
Updated 19 Oct 2026 8 min readPaywallsMonetisationSubscriptionsPolicy & reviewOnboarding
On this page· 10
- Placement: where the paywall lives
- Timing: how much onboarding before the ask
- Plan layout and anchoring
- Annual default and trial toggles
- Copy that converts without tricking
- Anatomy of a compliant paywall
- Compliance: what Apple and Google actually require
- What developers say about dark patterns
- How this shows up in the charts
- Checklist before you ship a paywall
A good paywall shows up at the moment the user understands the value, offers two or three plans with the billed price as the largest number on screen, and makes the trial terms impossible to misread. Everything else, from anchoring to social proof, is a lift on top of those basics, and the tricks that go past them are now being rejected by Apple and called out by developers.
Placement: where the paywall lives
Almost every subscription starts on install day. Adapty's 2026 report puts 89.4% of trial starts on day 0, and onboarding paywalls without a trial converted at 37.45% of views in its dataset, though it warns that those buyers deliver the lowest long-term value 10. That is the central tension of placement: the onboarding paywall is where the volume is, and also where the least-committed buyers are.
Superwall's July 2024 guidance names three placements worth instrumenting: the first interaction of a session, the moment a user abandons a purchase sheet, and the moment a user closes the first paywall 8. Feature gates, where the paywall appears when someone taps a premium feature, are the other high-intent trigger 8. A reasonable default is one onboarding paywall, one feature-gate paywall, and a settings entry point for people who come back ready to pay.
Timing: how much onboarding before the ask
Superwall analysed just over 40 million onboarding paywall opens between February and May 2026 and found multi-page onboarding paywalls converting at 12.41% versus 9.07% for single-page ones, a relative lift of 37% 7. A few screens that ask about the user's goal and promise a personalised plan give the paywall something to refer to. Apple's guidance cuts the other way for the purchase flow itself: a lengthy sign-up lowers conversion, so keep that step short 2.
Plan layout and anchoring
Superwall's 2022 analysis of 32.3 million paywall opens (3.77% converted overall) found two-product paywalls converted 61% better than single-product ones, and three beat two by 44% 6. One caveat: hidden "more plans" buttons counted as extra products, so the lift is about choice existing, not cramming the screen 6. If you need cash upfront for ad spend, one annual plan is still defensible 6.
Anchoring is the most common pattern among top-grossing apps. Superwall's August 2025 teardown describes the "anchor and decoy" layout, where a high monthly price makes the annual plan look cheap, with Calm as the example, and the target plan is enlarged, bordered or tagged "Most Popular", as MacroFactor does 5. RevenueCat's pricing-psychology piece reports a test by Mojo that framed the annual plan as a monthly figure while stating it was billed annually: new revenue per paywall impression rose 45% in Brazil, 26% in Mexico and 8% in the US 9. Note the "billed annually" part; Apple requires the total billed amount to be the most prominent price element, with per-month equivalents in a subordinate size 2.
Annual default and trial toggles
Preselecting the annual plan is normal and allowed, as long as the billed amount is the biggest number and the alternatives are visible. What Apple no longer accepts is the free-trial toggle. According to Superwall's June 2026 account of a meeting with Apple, trial toggles on paywalls are not allowed at all, because developers were using the switch to silently move users from a monthly plan to a yearly one and reviewers could not separate honest implementations from deceptive ones 4. The replacement is to attach the trial to a specific product and describe it plainly. The same meeting confirmed that paywall A/B testing and remote updates are allowed, provided every variant complies 4. These were answers given in a meeting, not a published guideline change, so treat them as reported rather than official 4.
Copy that converts without tricking
Three copy patterns recur in the top-grossing teardown 5:
- A value stack: a short bulleted list of outcomes, each starting with a verb, rather than a feature list.
- Social proof with specifics: Speak cites more than 5 million users and a 4.8-star rating from over 140,000 reviews.
- Soft commitment: the button says "Start free trial" with "Cancel anytime" and "No payment due now" beneath it, and Strava and Cal AI add a timeline that says what happens on day 1, when the reminder arrives and when billing starts.
Small copy changes can move revenue a lot at small scale. One r/iOSProgramming developer reported in January 2026 that dropping the free trial and labelling the weekly plan "Try for Week" took MRR from roughly $100 to $700 on the same organic traffic (a single self-reported case, unverified) 15. The lesson is that paywall copy is cheap to test and rarely tested.
Anatomy of a compliant paywall
Compliance: what Apple and Google actually require
Apple's guideline 3.1.2(c) says you must clearly describe what the user gets for the price before asking them to subscribe, and 3.1.2(a) adds that apps which trick users into subscribing under false pretences, or run bait-and-switch flows, will be removed along with the developer account 1. Apple's subscription documentation spells out the sign-up screen: the subscription name and duration, what the user receives, the full renewal price shown clearly and localised, a way for existing subscribers to sign in or restore, and links to terms and privacy policy in the app and store metadata 2. For a free trial, the screen must state how long it lasts and what is billed when it ends 2. The billed amount must be the most prominent price on the layout, with savings claims and per-month breakdowns in a smaller, secondary position 2.
Google Play's requirements are similar in substance. Developers must be transparent about the offer, including cost, billing frequency, whether the app requires a subscription and how to cancel, and users must not need extra steps to see those terms 3. Promotions and splash screens must state the offer clearly, subscription names must be accurate (a paid plan cannot be called "Free Trial"), benefit text cannot mention trials or prices, and apps must offer an easy online way to cancel 3.
In the US, the FTC adopted a click-to-cancel rule in October 2024 requiring clear disclosure before collecting billing details, express consent to auto-renewal, and cancellation as simple as sign-up 16. The rule was later challenged in court and its enforcement status should be checked before relying on it unconfirmed.
What developers say about dark patterns
The developer community is less tolerant of aggressive paywalls than it was. A July 2025 r/iOSProgramming thread asked whether it is even allowed to close a $99/year paywall and immediately get a second sheet offering the same thing for $9.99; the poster called it scammy and the thread drew 48 comments 12. By November 2025 another developer reported a rejection under guideline 5.6 (Developer Code of Conduct) for showing an additional discount when the reviewer tried to exit the subscription page, with Apple describing it as manipulating customers into unwanted purchases 13. Together the posts suggest exit-intent discount sheets have moved from grey area to rejection risk, at least for some reviewers.
Consumers have been angry far longer. The highest-voted example we found is a 2018 r/assholedesign post, with roughly 35,000 upvotes, about a "free" app that charged £90 a week after a three-day trial 14. We could not reach X directly for this piece, so opinions there are not cited unconfirmed.
How this shows up in the charts
Paywall changes rarely move Top Free, because downloads happen before anyone sees the wall. They move Top Grossing, and they move reviews. An app that shifts from a soft onboarding paywall to a hard wall can climb the iOS grossing chart within weeks as day-0 conversions stack, while its rating drifts down if the terms were unclear. On the Android charts, where engagement signals carry more weight, a transparent paywall with a visible cancel path tends to protect rank better than a high-pressure one. When an app jumps on the movers list with no visible marketing, a paywall or pricing test is one of the first things to check.
Checklist before you ship a paywall
- Billed total is the largest price; per-month equivalent is smaller 2.
- Trial length, price after trial, renewal period and how to cancel are on the screen 2,3.
- Two or three plans, no trial toggle, annual preselected only if the alternatives are visible 4,6.
- Close control is present from the start; no exit-intent discount sheet 1,13.
- Restore purchases, terms and privacy links are present 2.
- Copy is a value stack with an outcome headline and specific social proof 5.
- Every A/B variant is checked against the same rules before it goes live remotely 4.
Sources
- Apple: App Review Guidelines (3.1.2 Subscriptions, 5.6 Developer Code of Conduct)
- Apple Developer: Auto-renewable subscriptions, Clearly describing subscriptions
- Google Play Console Help: Create a subscription (offer transparency requirements)
- Superwall: External checkout, A/B testing and trial toggles, confirmed Apple's rules for iOS (3 Jun 2026)
- Superwall: 5 paywall patterns used by million-dollar apps (15 Aug 2025)
- Superwall: How many products should you offer on your paywall? (14 Nov 2022)
- Superwall: Multi-page onboarding paywalls convert 37% better than single-page (26 May 2026)
- Superwall: Show a paywall during these three high-converting app experiences (15 Jul 2024)
- RevenueCat: Subscription pricing psychology (6 Feb 2025)
- Adapty: State of in-app subscriptions 2026
- RevenueCat blog: The State of Subscription Apps in 10 minutes (19 Mar 2026)
- Reddit r/iOSProgramming: Don't want to pay 99 USD/year for this simple app? How about 9.99? (26 Jul 2025)
- Reddit r/iOSProgramming: Guideline 5.6 rejection for showing a discount option on exit (30 Nov 2025)
- Reddit r/assholedesign: This free app gives you a 3 day free trial then charges you £90 a week (1 Jan 2018)
- Reddit r/iOSProgramming: One small paywall text change took my app from $100 to $700 MRR (28 Jan 2026)
- FTC press release: Final click-to-cancel rule (16 Oct 2024)