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

Adding localizations and languages

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.

When you are localizing strings, the editor will reflect the locale you’re editing against so you can see a live preview of how the text will appear.

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:

You can use variables with localized strings, too. Simply use liquid syntax within your localized string values to access any variable. Currently, variables themselves are not able to be localized. Learn more about using variables here.

Localized strings are globally available

Any localized strings you enter are available across any paywall attached to your app. As such, the general localizing flow typically looks like this:

  1. Add a new language to localize within the paywall editor.
  2. Add or edit strings within the editor in the localization tab.
  3. If you later update, change or add any other strings across paywalls, you can triage them within the Localization tab on your app’s overview page. See this doc for more.

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: