Presenting Paywalls from One Another
Learn how to present a different paywall from one that’s already presented.
It’s possible to present another paywall from one already showing. This can be useful if you want to highlight a special discount, offer, or emphasize another feature more effectively using a different paywall. Check out the example here:
- A placement is evaluated when the button is tapped. Superwall sees that the user isn’t subscribed, so a paywall is shown.
- Next, the user taps the “Custom Icons Too 👀” button.
- The current paywall dismisses, and then presents the icons-centric paywall.
![](https://mintlify.s3-us-west-1.amazonaws.com/superwall-docs/images/presentPaywallEx.jpg)
There are two different ways you can do this, with custom placements or by using deep links. We recommend using custom placements, as the setup is a little easier.
They both have the same idea, though. You create a new campaign specifically for this purpose, attach a paywall and either add a filter (for deep linking) or a new placement (for custom placements) to match users to it.
Use Custom Placements
Add a Custom Placement Tap Behavior
Select a component on your paywall and add a Custom Placement Tap Behavior, and name it whatever you wish (i.e. showIconPaywall).
![](https://mintlify.s3-us-west-1.amazonaws.com/superwall-docs/images/customPlacementLink.png)
Finally, be sure to click Publish at the top of the editor to push your changes live
Create a campaign for the other paywall to show
Create a new campaign specifically for this purpose, here — it’s called “Custom Placement Example”:
![](https://mintlify.s3-us-west-1.amazonaws.com/superwall-docs/images/customPlacementCampaign.png)
Add the placement
In your new campaign, add a new placement that matches the name of your custom action you added in step one. For us, that’s showIconPaywall
:
![](https://mintlify.s3-us-west-1.amazonaws.com/superwall-docs/images/customPlacementCreate.png)
Choose a paywall to show
Finally, choose a paywall that should present by clicking on the Paywalls button at the top:
![](https://mintlify.s3-us-west-1.amazonaws.com/superwall-docs/images/customPlacementPaywall.png)
Use Deep Links
Setup Deep Links
You’ll need deep links setup for your app. This is how Superwall will query parameters and later launch your desired paywall.
Trigger the deep link from an existing paywall
Choose the paywall you want to open another paywall from. Then, click the element (a button, text, etc.) that should open the new paywall:
- In its component properties on the right-hand side, add a Tap Behavior.
- Set its Action to Open Url.
- For the URL, use your deep link scheme from step one, and then append a parameter which will represent which other paywall to present. This is specific to your app, but here —
offer
is the key andicons
is the value. Your resulting URL should be constructed like this:deepLinkScheme://?someKey=someValue
. - Set its Type to Deep Link.
- Click Done.
Here’s what it should look like (again, with your own values here):
![](https://mintlify.s3-us-west-1.amazonaws.com/superwall-docs/images/openPaywallParams.png)
Finally, be sure to click Publish at the top of the editor to push your changes live.
Create a campaign for the other paywall to show
Create a new campaign specifically for this purpose, here — it’s called “Deeplink Example”:
![](https://mintlify.s3-us-west-1.amazonaws.com/superwall-docs/images/openPaywallCampaign.png)
Add the placement
Edit the audience filter
Edit the default audience’s filter to match params.[whatever-you-named-the-parameter]
. Recall that in our example, the parameter was offer
and the value was icons
. So here, we’d type params.offer
and click the + button:
![](https://mintlify.s3-us-west-1.amazonaws.com/superwall-docs/images/openPaywallParamsEditor.png)
Superwall will ask what type of new parameter this is — choose Placement and enter the parameter name once more (i.e. “offer”). Click Save:
![](https://mintlify.s3-us-west-1.amazonaws.com/superwall-docs/images/openPaywallParamsCreate.png)
Finally, choose the is operator and type in the value of your parameter (in our case, “icons”). Then, click the + Add Filter button. Here’s what it should look like:
![](https://mintlify.s3-us-west-1.amazonaws.com/superwall-docs/images/openPaywallFinal.png)
Choose a paywall to show
Finally, choose a paywall that should present by clicking on the Paywalls button at the top:
![](https://mintlify.s3-us-west-1.amazonaws.com/superwall-docs/images/openPaywallPaywall.png)
Test Opens
After following the steps above for either method, be sure to test out your presentation. Open the relevant paywall on a device and tap on whichever button should trigger the logic. The currently presented paywall should dismiss, and then immediately after — the other paywall will show.