Build your own UI with a Linked Paywall

Learn how to link a custom paywall implementation so it can be managed from the cloud

In this article, learn how to link a custom Paywall implementation to Nami, so you manage it from the cloud.

This approach is recommended if you have an existing paywall implementation or require a highly-customized paywall design .

If you are building a new app or would like to add a paywall without requiring code, consider using the Paywall Creator.

Link a Custom Paywall to Nami


Developer Note

Linking Nami to your custom paywall requires your developer to connect your paywall implementation to the Nami SDK so it can be managed from the Nami Control Center.

  1. Navigate to Nami Control Center > Paywalls

  2. Click the "+ Add Paywall" button

  1. Choose "Code your own paywall design"

Then click Get Started to configure the new paywall


Configure a Linked Paywall

  1. Name the paywall

The paywall name is used throughout the Nami Control Center to identify your paywall and is not visible to your app's end users. Click the Pencil icon ✏️ to edit Paywall Content. Enter a paywall name in the Overview > Name field then click "Update" to save your changes.

  1. Navigate to the Images section. Upload background artwork, then click "Update" to save your changes.

This is used to visually identify your paywall throughout the Nami Control Center, including on the Paywall tile view.



Artwork Specifications

Compressed JPEG

Phone 2,000 x 1,000
Tablet: 2,000 x 2,000

  1. Navigate to the Content section. Input a title and body, then click "Update" to save your changes.

The title text is the key headline and the body is supporting text.

  1. Click the Tag icon 🏷 to navigate to the Products tab.


Adding In-App Purchase Products to a Paywall

In order to add Product SKUs to a Paywall, you will need to complete the following steps.

  1. Add an App Platform.
  2. Add Product SKUs.
  3. Associate Product SKUs with an Entitlement.

Until you complete these steps, you may not see any in-app purchase products that can be added to your paywall.

Follow the links to each of the guides to complete these steps.

Select an App Platform from the dropdown. The Disabled Products list will populate with the Product SKUs for that platform. Drag products from Disabled Products to Enabled Products to display on your paywall. Select Product SKUs for each App Platform that this paywall is going to run on.


On each App Platform your app runs on, your users will only see the product SKUs for that specific platform.

Choose up to three in-app purchase products to sell through this paywall.

Click "Update" to save your changes

  1. Navigate to Legal tab. Setup paywall legalese. Click "Update" to save your changes.

Paywalls can display Purchase Terms and link to your Terms of Use and Privacy Policy.

Purchase Terms are configured per paywall.

Terms of Use and Privacy Policy are configured per-app, navigate to App Settings to populate.



Legal & App Review

Apple App Store apps must somewhere surface a Privacy Policy and Terms of Use. This does not have to be done within the paywall, but that is a best practice.

If the Privacy Policy and Terms of Use fields in App Settings are left blank, no legal links will be displayed within the paywall.

Developer Details

Connecting the Linked Paywall data defined in the Control Center to your mobile app requires a little development work. Please consult this guide for details.