Paywall locations
Publish paywalls behind stable slugs your app resolves at runtime.
A paywall is the screen a customer sees. A location is the stable slug your app asks for,
such as onboarding or settings-upsell. Keeping those separate lets you replace a paywall without
shipping a new app version.
Publish a paywall
In Studio:
- Create or open a paywall.
- Add the products customers can purchase.
- Preview the paywall on both platforms, then publish it.
- Open Settings → Paywall locations.
- Create a location and assign the published paywall to it.
The location slug is immutable because it becomes part of your app code. Use a name that describes where the paywall appears, not what the current design looks like.
Change a paywall safely
To update what customers see, publish the new paywall and assign it to the existing location. The app keeps asking for the same slug and receives the new release.
Clearing or archiving a location makes future presentations return the "not assigned" outcome on every platform. Keep a fallback in the app for important entry points — each SDK page shows how: React Native, Swift, Kotlin.
Location slugs
Location slugs are plain strings in every SDK. React Native projects can additionally generate typed slugs so typos become compile errors — see Generated slug types.