--- title: Multilingual translations via Weglot slug: multilingual-translations-via-weglot description: Integrate Weglot with Roster to translate your application form and ambassador portal content, giving ambassadors a localized experience. docTags: createdAt: 2024-11-21T13:30:53.002Z --- Integrating Weglot with Roster provides a seamless solution for translating various elements of your ambassador program. Weglot helps translate the application form and campaign content in Roster's ambassador portal, allowing ambassadors see content in multiple languages. The integration is easy to set up, but it involves several steps, including configuring language settings, obtaining the Weglot API key, and adjusting settings within Roster. This guide will walk you through integrating Weglot with Roster, ensuring your ambassador program supports multiple languages effectively. *** ## Step-by-step instructions ::::WorkflowBlock :::WorkflowBlockItem ### Create a Weglot account and project 1. Go to [weglot.com](https://weglot.com) and create an account if you don't have one. 2. After account creation, start a new project. 3. Name your project (e.g., `Roster Ambassador Translations`). 4. Under `website technology`, select `Other`. 5. Click `Next` to proceed. ::: :::WorkflowBlockItem ### Configure language settings 1. Set `English` as the original language. 2. Choose additional languages under `Translated Languages`. Note the pricing tiers might limit the number of languages. 3. Enter `roster.link` under `domain URL`. 4. Click `Next` to configure. ::: :::WorkflowBlockItem ### Obtain and use the Weglot API key 1. In the step labeled `Add Weglot snippet`, locate the `api_key` within the JavaScript provided. 2. Copy the full API key value (without quotes) to your clipboard. - The API key starts with `wg_` followed by a long alphanumeric value. e.g. `wg_5f357807f1ba2d0b66a900d5ff6d47bse` 3. If the `Next` button appears as disabled, then proceed to the next step. If the `Next` button is enabled, then click `Next` ::: :::WorkflowBlockItem ### Add the Weglot API key to your Roster program's settings In order to proceed with the Project setup in Weglot, Weglot requires that the API key is used on a live web page. That's what we'll do in this step. 1. In your Roster account, navigate to `Programs` > `Settings` of the specific program to which you want to add translations. 2. In program settings, click on the `Integrations` tab. 3. In the `Translation via Weglot` section, paste the Weglot API key into the `Weglot API Key` field. 4. Two toggles will appear below the `Weglot API Key` field: - **Application Form**: Applicants can view the program's application form in any of the languages you enable in the Weglot project. - **Campaigns**: Ambassadors in the program can see translations for campaigns to which they are invited. 5. Enable `Application Form` even if you don't plan to enable translations for the application form later on. This is just to get past the next step in the Weglot project setup. ::: :::WorkflowBlockItem ### View the program's hosted application form 1. While still in Program Settings, click on the `Recruitment` tab 2. In the `Recruitment Form` section, click `Copy` > `Copy form link` 3. Open a new browser tab and paste in the recruitment form link. 4. Ensure you see a language switcher at the bottom right of the form. 5. Click the language switcher and select one of the other languages. 6. The form should automatically translate. ::: :::WorkflowBlockItem ### Final configuration in Weglot 1. In Weglot, the Project setup should now automatically updated to show as completed. If not, try refreshing the page. 2. Click to view the new project. 3. Click `General` under the `Settings` section in the left-hand navigation. 4. Locate the `Auto-switch` toggle and enable it. 5. Click `Save changes` 6. Click `App settings` under the `Settings` section in the left-hand navigation. 7. Click the `Add Dynamic` button. 8. In the dialog, enter `body` as the selector, and `Ambassador portal` as the description. 9. Click `Save` ::: :::WorkflowBlockItem ### Translate the Application Form When enabled in Program Settings, the application form will be translated into the languages you selected in the Weglot project. This includes the form description, field labels, and the confirmation page message. ::: :::WorkflowBlockItem ### Translate Campaigns When enabled in Program Settings, the following campaign details for ambassadors who are in a program with translations enabled will be translated: - Campaign title - Campaign overview - Campaign style guide ::: :::WorkflowBlockItem ### View and edit the translations in Weglot 1. In Weglot, click `Languages` 2. This lists the languages you have enabled for your Weglot project, and a count for how many words have been translated for each language. 3. Click on a language to view and edit all the translations made by Weglot. ::: :::: *** ## Need help? If you need any additional assistance with with your Roster account, feel free to contact our support team at [support@getroster.com](mailto\:support@getroster.com). We're here to help!