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 the two separate lets you replace a paywall
without shipping a new app version. This page shows how to publish a paywall, assign it to a
location, and change it later.
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. Name it after where the paywall appears, not after what the current design looks like.
Change a paywall safely
To change 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.
If you clear or archive a location, every future presentation returns the "not assigned" outcome on every platform. For important entry points, keep a fallback in the app. Each SDK page shows how: React Native, Swift, and Kotlin.
Location slugs
Location slugs are plain strings in every SDK. React Native projects can also generate typed slugs, so a typo becomes a compile error. See Generated slug types.