Adding the Preferred Language to the User Profile

Contact profile has a language field that indicates the contact language. There are several ways to fill it for existing and new contacts.

Adding the Language for Existing Contacts

There are four ways to fill the Language field in the contact profile.

1. Contacts Import

For example:

。"es," "en";

。"es-AR" (Spanish, Argentina), "en-US" (English, USA).

  • Update the collected data. For companies that have previously recorded the language of their subscribers, it is enough to adjust the language to the above requirements so that the system can map it correctly. To download updates, export the database and then import the updated file.

2. Get the Language From the Browser

Based on the subscriber’s interaction with the campaign, the system records the browser language and inserts it in the language field.

3. Get the Language Using Web Tracking

Data about the language of contacts identified from the webcontact web tracking event can be obtained from the headers of this event if the Language field in the cards of such contacts is empty.

4. Change Data Manually

You can edit the language field in the user profile, regardless of how it was added.



  • Changes made manually would always rank higher than the info automatically collected by the system.
  • In case the language field for the contact has already been filled, the system will not replace the existing data. The browser language would only be recorded for the empty field, and the previously added data is saved by default.

During the import, the data is always updated (replaced)!

Adding the Language for New Contacts

By default, the language field is filled for all new contacts via:

1. API

Transfer of the API languageCode parameter by the subscribe method.



If the contact's profile does not contain the languageCode field, the language chosen by a contact in the mobile app is set as a preferred language in the contact profile.

2. Using our Widgets

  1. Parse the value of the lang attribute in the HTML tag.
  2. Parse the site URL to search for:
    a. Path segment containing the language code in ISO-639-1.
    b. Path segment containing the language code and location (ISO-639-1 + ISO-3166).
  3. Identify the preferred language set in the browser (navigator.language).

Also, you can ask the customer to specify the preferred language in a subscription form, a survey, or their website profile.

3. SDK

When a contact installs your mobile app, the SDK collects the data, including languageCode.
See the following instructions for details:

4. Subscription to Web Push Notifications

When a contact subscribes to web-push notifications, our system collects data about the language used by a contact for data input and writes it to the contact's card.