Localizing Your App

Overview

A great way to get more users is to localize your app. We have over 100 million users worldwide – and many of them aren’t native English speakers.

To benefit more users around the world, we strongly recommend offering your app in at least one language other than English. This can help you get more users, earn higher ratings, and convert more users to premium.

The five most common languages of Wix users are:

  1. English
  2. Spanish
  3. Portuguese
  4. Russian
  5. French
Getting Started
  1. Localize your app’s UI. This involves a variety of tasks: translating the UI strings in your app, modifying dates and times, adjusting layouts, and more. Refer to the design tips below.
  2. Match your app’s language to the user’s language. When the user first installs your app, display your UI in the language the user defined in their language/regional preferences.
  3. (Site components only) Let users customize your app for their target audience. Add these options to your App Settings panel:
    1. Allow users to choose the language that’s suitable for their target audience – add a dropdown with a list of languages. (Since the user’s language preference might be different from the language used in the live site.)
    2. Allow users to change text elements and other regional settings (like measurements).
Design Tips
  • Make sure that any text-based UI elements are designed with plenty of space to accommodate other languages. You can allow for up to 30% more space than the text your default language requires.
  • If your UI cannot accommodate text in one of your target languages, you can create an alternative layout for that language only.
  • Keep in mind that in different locations, different symbols and formats are used for dates, times, numbers, currencies, etc. For example, February 1, 2015 will be 1/2/15 in Europe but 2/1/15 in the U.S.
  • It is important that you have a default set of resources available so that if you get a request to load your app in a location that you do not support, you will have a fallback and your app will not crash. We suggest that you use English as the fallback language.

Implementation
  1. When building your app, we suggest managing all of the UI strings in one place and not adding any hardcoded strings to your code. For example:

2. Match your app’s language to the user’s language. When the user first installs your app, detect the user’s language (it’s defined in their language/regional preferences).
There are two ways to do this:   

a. Server-side rendering: use the locale parameter, which is one of the query parameters we pass over to you when we call your app’s endpoint.

b. Using the SDK: use the Utils.getLocale method to decide which set of strings to use in your App Settings.

Providing Support

If your app is supported in a certain language, users may ask for your help in that language. We recommend engaging with users in their native language, or if that’s not possible, in a common language.

If your app becomes popular in a specific language, consider hiring a native-language speaker for that language to ensure textual accuracy and to provide user support.

Was this page helpful?

What can we do to improve it?

What did you like about it?