Your first paywall
From a brand-new app to a live paywall, in order, with every field and where to find it. About thirty minutes, most of it waiting on Apple.
This is the whole path. Nothing here assumes you have read anything else, and every identifier says exactly which screen it comes from.
What you need before you start
- An app in App Store Connect with at least one subscription created
- A RevenueCat account with that app connected
- Your app shipping the Fictura SDK — see SDK quickstart
- The app's free trial started, or the app activated. Until then only Setup and Tools open, and every other tab says to connect your coding agent, which starts the free 30-day trial
1. Create the app in Fictura
The app switcher at the top right → Add new app. On a brand-new account, the dashboard sends you there first. Paste your store link, or choose to add the app by hand with just a name.
You get an SDK app key (gk_…). That goes into your app's SDK init, and it stays in Setup → Keys & webhook. Full details in Create an app.
2. Create your subscriptions in App Store Connect
Skip if you already have them.
- appstoreconnect.apple.com → Apps → your app
- Left sidebar, under Monetization → Subscriptions
- Create a Subscription Group (e.g. "Pro Access") — a group is a ladder users move between; plans in different groups cannot be swapped
- Inside the group, Create a subscription. You will set:
- Reference Name — internal only, users never see it
- Product ID — this is the one that matters. Lowercase, no spaces, cannot be changed later. e.g.
myapp_pro_weekly - Subscription Duration
- Price per territory
- Repeat for each plan. For a free trial, open the subscription → Introductory Offers → Create → Free Trial
A trial is a separate offer, not a separate product — except when you want both
Many apps create a second product for the trial version so the paywall can offer "weekly" and "3 days free, then weekly" as two cards. If you do that, you will set both primary and primary_trial in step 5 below.
3. Put those products in a RevenueCat offering
This is the step that is easiest to miss, and the one that silently empties a paywall.
- app.revenuecat.com → your project
- Left sidebar → Product catalog → Products. Your App Store products appear here once RevenueCat is connected to App Store Connect. If they are not, connect that first in Project settings → Apps
- Left sidebar → Product catalog → Offerings
- Open the offering marked Current, or + New one and set it current
- + Package → identifier (
$rc_weekly,$rc_annual, or your own) → Attach the product
Anything not in the current offering is never handed to your app.
4. Connect App Store Connect to Fictura
Optional, but it is what lets Fictura tell you when step 3 has gone wrong.
- appstoreconnect.apple.com → Users and Access → Integrations → App Store Connect API
- + to generate a key. Role: App Manager
- Download the
.p8. Apple allows this exactly once - Copy the Issuer ID (top of the page) and the Key ID (beside your key)
- Fictura → sidebar Monetize → Paywalls → Products → the App Store Connect card → paste all three, then choose your app. The App Store Connect tile in Tools opens the same form
5. Map your slots
Sidebar → Monetize → Paywalls → Products → Slots. Wire automatically fills them from your RevenueCat offering if RevenueCat is connected in Setup → Import data. Otherwise press Add slot.
A design names a slot, never a product — that is what lets one design work for every app. Set these:
| Slot | Product ID to use |
|---|---|
primary | Your main plan, usually weekly |
primary_trial | The same plan with a trial, if you made one |
secondary | The alternative, usually yearly |
secondary_trial | The yearly plan with a trial, if you made one |
Leave Store on All unless iOS and Android use different identifiers.
With App Store Connect connected, read the Will these reach a phone? card on the same page. It is silent when everything is right, and names the exact problem when it is not. Full reference: Slots and products.
6. Pick a design
Sidebar → Monetize → Paywalls → Browse templates.
Every card is the real page. Open in editor loads a design so you can look and change it — screens, words, colours, order — and creates nothing until you save. Use this template makes it a draft paywall of your own, waiting in Paywalls.
Good ones to start with:
| Starter | When |
|---|---|
| Template 3 — Fig+ | One screen that says what happens today, when the reminder comes, when the charge lands. For people who decline a trial because they do not know when they will be charged |
| Template 7 — Homework AI | A trial the person switches on. The switch turns both plan cards to their trial wording |
| Template 8 — Photograph | A full-bleed photograph, then a plain sheet with the two ways to pay |
| Template 1 — Sports | Four screens: the promise, what you get, a reminder before the trial ends, then the price |
7. Make it yours
In the editor: click anything on the phone to select it, or pick it in the Layers list.
The quickest real changes:
- Words — select a text node, type in Content
- Colours — Style → Background and Text colour. Alpha is the last two digits:
#FFFFFF0Ais white at 4% - Spacing — drag the green handles on the phone
- Order — drag a row in Layers, or drag the thing itself on the phone
- Prices — never type one. Use
{price},{per_week},{period},{trial_days},{save}
Switch to Preview to walk it as a user: the buttons work and the trial switch flips.
Full reference: The paywall editor.
8. Publish
Publish in the top right. Phones pick it up on their next launch — no App Store release, no review.
9. Check it on a device
Launch the app and reach the placement. Then look at:
- Sidebar → Analytics → Events —
paywall_shown,paywall_cta_tapped,purchase_completed - Sidebar → Monetize → Paywalls → Products — the reach card should still be quiet
A plan is missing
In order of likelihood:
- Its slot is not set — Products page
- Its product is not in the current RevenueCat offering — the reach card says so
- On Android, the identifier needs its base plan (
product:base-plan) — set the Android row explicitly - It is a trial the user has already used, and the paywall hides refused plans. Editor → Products → A plan this user cannot buy → Show, disabled
What to do next
- Test two of them. Sidebar → Monetize → Experiments — see A/B experiments
- A different paywall per placement. A paywall is tied to a placement; your app decides which placement to open. To choose by audience, see Placements & campaigns
- Change it again whenever. Nothing here needs another release