Slots and products
A design names a slot; this page says which store product that slot is. Get this wrong and the plan simply does not appear — set it once and every design you ever build is already wired.
A paywall design never names a product. It names a slot — primary, secondary — and this app says which of your store products each slot is.
That indirection is the whole reason one design can serve every app, and it is also the single most common reason a plan is missing from a paywall: the design asks for primary, nothing is mapped to primary, and the card quietly does not render. No error, no crash, just one plan fewer than you drew.
Do this before you build a paywall
A design built in the editor sells slots. With none set, it has nothing to sell and its plan cards do not appear on the phone — in the dashboard preview they look fine, because the preview uses sample prices.
What you need, and exactly where it lives
1. Your product identifiers, from App Store Connect
You can read them by hand, or connect App Store Connect once and have them listed for you.
By hand:
- Go to appstoreconnect.apple.com
- Apps → your app
- Left sidebar, under Monetization → Subscriptions
- Click a Subscription Group (e.g. "Pro Access")
- Click a subscription inside it
- The field you want is Product ID — e.g.
house_ai_pro_weekly
Copy it exactly. It is case-sensitive and has no spaces.
Or connect App Store Connect (worth it — it also powers the check at the bottom of this page):
- appstoreconnect.apple.com → Users and Access → Integrations → App Store Connect API
- Click + to generate a key. Set the role to App Manager — Developer can read but cannot create products
- Download the private key (.p8). Apple lets you download it exactly once
- Copy the Issuer ID (top of that page) and the Key ID (next to your new key)
- In Fictura: sidebar → Monetize → Paywalls → Products → the App Store Connect card → paste Issuer ID, Key ID, and the whole .p8 file contents including the
BEGIN/ENDlines - Pick which app this workspace manages
2. Those products must be in a RevenueCat offering
This is the step people miss, and it is not in Fictura — it is in RevenueCat.
- app.revenuecat.com → your project
- Left sidebar → Product catalog → Products — your App Store products appear here once RevenueCat is connected to App Store Connect
- Left sidebar → Product catalog → Offerings
- Open the offering marked Current (or create one and make it current)
- + Package → give it an identifier (
$rc_weekly,$rc_annual) → attach the product
A product that exists in App Store Connect but sits in no offering is never handed to your app. Fictura cannot fix that from here — but it will tell you (see below).
Setting a slot
Sidebar → Monetize → Paywalls → Products → Add slot. The form has three fields:
The name a design uses. Lowercase letters, numbers and _ only, up to 40 characters. Use the standard names below unless you have a reason not to.
The identifier from App Store Connect or Google Play. Suggestions come from what your app has reported the store offering. On Android you may paste either product_id or product_id:base_plan — both match.
All when both stores use the same identifier — the usual case. Pick iOS or Android only when the two stores disagree, and then set both. A line for one store wins over All on that store.
Or wire them from RevenueCat
Wire slots from RevenueCat, on the same page, reads your offering and fills each slot for iOS and Android: weekly → primary, yearly → secondary, monthly → tertiary, and trial products into the _trial slots. You see every change before anything is saved.
The slot names designs expect
Every starter in the gallery uses these. Set the ones your app sells and leave the rest.
| Slot | What a design means by it |
|---|---|
primary | The plan the design pushes — usually weekly |
primary_trial | The same plan, with a free trial. Used when the trial switch is on |
secondary | The alternative — usually yearly |
secondary_trial | The yearly plan with a trial |
tertiary | A third option, where a design offers one — usually monthly |
tertiary_trial | The monthly plan with a trial |
A design that has no trial switch needs only primary and secondary. A one-plan design needs only primary.
Slots belong to the app, not to a paywall
Changing what primary means changes it for every design that names it. That is the point — it is also why the editor says so where you set it.
Checking it will actually work
Products → the Will these reach a phone? card. It holds three lists at once, which nothing else does:
| Source | What it answers |
|---|---|
| App Store Connect | Does a product with this identifier exist? |
| RevenueCat offerings | Is it in an offering, so the app is handed it? |
| Your own app | Has anyone actually been shown it? |
It stays quiet when everything is fine. When it speaks, it says which of the three to go and fix:
| What it says | What to do |
|---|---|
| App Store Connect has no product with this identifier | A typo, or a product that was deleted. Fix it on this page |
| Real in the store, but in no RevenueCat offering | The identifier is right and the product is approved — RevenueCat just never hands it to the app. Add it to a package in the current offering |
| Only in … , not the current offering | Phones get the current offering. Add it there, or pick that offering in the paywall's Products tab |
| Configured correctly; no user has been shown it yet | Normal for something you added minutes ago. Worth a second look if it has been days |
Above those, it lists any App Store product that won't reach a phone, whether or not a slot uses it, with what to do in RevenueCat.
The same warnings appear inside the editor, under Products → Slots, beside the slot each one is about — so you see them while building rather than after publishing.
Common mistakes
- Slot set, plan still missing. Almost always the product is not in the current offering. Check the card above.
- Works on iOS, not Android. The Android identifier usually carries a base plan (
product:base-plan). Set the Android row explicitly. - Preview looks right, phone is empty. The preview uses sample prices and does not consult your store. Only the check above does.
- Trial switch missing on a returning user. They have used their trial, and the paywall's A plan this user cannot buy setting is Hide it. Choose Show, disabled to keep the switch.
Billing webhooks
An HTTP POST to your server the moment money moves — signed, and shaped so the subscription handler you already run keeps working.
The paywall editor
Build a paywall by moving things on a phone — screens, layers, spacing, live prices — and publish it without an app release. Every control, and what each one does.