Paywall Localization

To localize your paywall, click on the Localization button from the sidebar:

There are two ways to localize your paywall:

1. Simple: Here, you can use AI to localize your paywall into any language. You can manually refine each value at any point. Quick and accurate.
2. Advanced: User external .strings files to localize your paywall. This is ideal when you are using external localization services.

Simple localization

Once enabled, a new side panel will present to help you localize you paywall:

You can control localization with the options at the top:

Here's what each options does, left-to-right:

To start the AI localization process, click on the Add Language button. Then, choose AI Localize. Superwall will being to localize each value, while respecting the AI Localize settings in place:

Once finished, you'll see all localized values:

AI localization settings

You can customize how AI localization behaves by changing the settings in the AI Localize Settings menu:

The Formality Style lets you toggle between formal and informal language. Use the Localization Style Guide to provide specific instructions to your brand's voice accurately.

Managing languages

To remove or reset a language, click on the three dotts button next to the language:

To switch back and forth between languages, simply click the language at the top:

Advanced localization

After opening the localization panel referenced above, click on the Add Language button. Choose the language identifier of the locale you're localizing for, and click on Add:

If there are any existing text components on your paywall, all of them with currently unlocalized strings will populate in the sidebar (in this example, we're localizing our text for Spanish speakers):

Click on the Localize button on any of them to enter in localized values. When you're done, click Save:

From there, go through and localize all of the values. Keep an eye on the progress bar at the top to see how far along you are. Remember to click on the Publish button at the top right of the editor to commit any localization edits.

Associating localized strings to new or existing text components

When you add new text components, or need to associate a different localization to an existing one — click the Localize button when the text component is selected. You can either use an existing localized string, or add a new one by clicking the plus button:

When a text component has a localized string attached to it, you'll see the localized string's key in place of the localize button:

Using .strings files

You can download and import .strings files to speed up your translations. This is ideal when you are using external localization services or have a large number of strings to localize.

Exporting .strings files

Select Localization from the left sidebar, click on the Import button. Choose "Download template" and the .strings file will be downloaded with all of your currently localized strings:

Importing .strings files

Select Localization from the left sidebar, click on the Import button. Choose "Import Strings File" and select your local .strings file to upload. Then, all of the updated values will be reflected in the editor.

Testing localized strings

You can preview how localized strings will appear on device. To set this up:

1. Make sure you've got in-app previews configured.
2. Open the paywall editor and click "Preview":
3. When it opens, tap the menu located at the top left and choose "Localization":
4. Then, select the language to display and the preview will reload with it: