Fictura
Paywalls & onboarding

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:

  1. Go to appstoreconnect.apple.com
  2. Apps → your app
  3. Left sidebar, under Monetization → Subscriptions
  4. Click a Subscription Group (e.g. "Pro Access")
  5. Click a subscription inside it
  6. 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):

  1. appstoreconnect.apple.com → Users and Access → Integrations → App Store Connect API
  2. Click + to generate a key. Set the role to App Manager — Developer can read but cannot create products
  3. Download the private key (.p8). Apple lets you download it exactly once
  4. Copy the Issuer ID (top of that page) and the Key ID (next to your new key)
  5. 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/END lines
  6. 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.

  1. app.revenuecat.com → your project
  2. Left sidebar → Product catalog → Products — your App Store products appear here once RevenueCat is connected to App Store Connect
  3. Left sidebar → Product catalog → Offerings
  4. Open the offering marked Current (or create one and make it current)
  5. + 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:

Slot name
text

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.

Store product ID
text

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.

Store
select

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.

SlotWhat a design means by it
primaryThe plan the design pushes — usually weekly
primary_trialThe same plan, with a free trial. Used when the trial switch is on
secondaryThe alternative — usually yearly
secondary_trialThe yearly plan with a trial
tertiaryA third option, where a design offers one — usually monthly
tertiary_trialThe 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:

SourceWhat it answers
App Store ConnectDoes a product with this identifier exist?
RevenueCat offeringsIs it in an offering, so the app is handed it?
Your own appHas 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 saysWhat to do
App Store Connect has no product with this identifierA typo, or a product that was deleted. Fix it on this page
Real in the store, but in no RevenueCat offeringThe 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 offeringPhones 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 yetNormal 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.

On this page