> ## Documentation Index
> Fetch the complete documentation index at: https://help.standards.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Localization

<Badge color="red" size="lg" shape="pill">Enterprise</Badge>

Translate your guidelines into multiple languages to reach a broader audience and increase engagement.

<Frame>
  <img src="https://mintcdn.com/standards/ehCcBR584ReEZevk/images/hero-01.gif?s=f6cfb11db1fb939df6d3a2248c4d0e29" alt="Guidelines changing from english to spanish" width="1800" height="900" data-path="images/hero-01.gif" />
</Frame>

***

## Basics

All Standards projects start with the default language English. Additional languages can be added (up to 20), translated, and published. Once published, these additional languages can be switched between by the viewer of the site. They also can automatically be chosen by the viewer’s browser if they are in a region matching the added language.

### Fundamentals

* All visual assets, styles, and site design match between languages
* Text content can (and should) differ between languages
* Text content can be reset back to the default language and content
* Files used in fills like inside Media elements can differ per language

### Default language

The default language is both what displays in the **design** mode of the editor, and is the base language for automatic translations of other languages.

***

## Adding

<Frame>
  <img src="https://mintcdn.com/standards/CR_kF1BrWgp3pcsY/images/add_language.gif?s=3cf9b812e7e37557a18c974f920e1730" alt="Add language window overlay with list of available languages" width="1200" height="600" data-path="images/add_language.gif" />
</Frame>

<Steps>
  <Step title="Select language dropdown">
    Within the design or content editor, select the language dropdown from the top bar.
  </Step>

  <Step title="Add new language">
    From the dropdown select `New language`
  </Step>

  <Step title="Choose language">
    From the add language interface, select the language you would like to add
  </Step>

  <Step title="Optional: Autotranslate">
    Lastly, choose if you want to automatically translate the new language.
  </Step>
</Steps>

<Info>
  **Tip:** Autotranslations can be overriden or completely reset.
</Info>

***

## Editing

Once your site has multiple languages, each language’s text can be edited independently from one another. Keep in mind all visual assets, styles, and site design match between languages

<Frame>
  <img src="https://mintcdn.com/standards/ehCcBR584ReEZevk/images/language_edit.gif?s=4c842bd58a7913380d7640532c1745bd" alt="Editing translated text" width="1200" height="600" data-path="images/language_edit.gif" />
</Frame>

### Select language to edit

Select a language from the globe icon dropdown in the top bar to enter the **Content** editing mode of that language.

### Editing

* Within the **Content** editing mode of the editor, select text by left-clicking on the text container, then clicking the text within
* Use the left and right icons to cycle to the previous and next block of text
* Use the translate icon to translate only the selected text block
* Translated text can be reset back to match the default language

### Hotkeys

Edit text quicker and mouse-free by utilizing keyboard hotkeys.

* **Left arrow:** Previous
* **Right arrow:** Next
* **Return:** Focus
* **Esc:** Unfocus

### Workflow

* Select some text with your mouse
* Press **return** on your keyboard
* Type edits or new text
* Press **esc** on your keyboard
* Press **right arrow** on your keyboard
* Repeat

***

## Automatic translations

Translate your site to a new language quickly using automatic translations. All text can be edited after the automatic translation completes, for fine-tuning.

<Frame>
  <img src="https://mintcdn.com/standards/ehCcBR584ReEZevk/images/new-language.png?fit=max&auto=format&n=ehCcBR584ReEZevk&q=85&s=26c64f475be6fb9b7ad60724bddcf549" alt="New language overlay" width="1200" height="600" data-path="images/new-language.png" />
</Frame>

### Translate all copy when adding language

In the process of adding a language, choose **Yes** to automatically the new language as it’s added.

<Frame>
  <img src="https://mintcdn.com/standards/CR_kF1BrWgp3pcsY/images/batch_translate.gif?s=ce4c0f9010823c7c5a8a058957399d40" alt="Batch translate chooser" width="1200" height="600" data-path="images/batch_translate.gif" />
</Frame>

### Translate all copy after languages have been added

Entire languages can be translated at any time. Within the **Content** editor, select the `Translate` button. Keep in mind this will automatically translate the chosen languages based on the default language, and all copy edits previously made will be lost.

<Frame>
  <img src="https://mintcdn.com/standards/ehCcBR584ReEZevk/images/selective-translate.png?fit=max&auto=format&n=ehCcBR584ReEZevk&q=85&s=b84ad9f9f0dd98594a460b632a0a96e5" alt="Contextual toolbar with autotranslate button available" width="1200" height="600" data-path="images/selective-translate.png" />
</Frame>

### Selective

Within the **Content** editor, single blocks of text can be selectively translated by pressing the translate icon button that appears near text when it’s selected

***

## Change language

Once another language has been added and translated, you will want to create a way for viewers to toggle between them. The primary way of letting viewers change languages, is to set the behavior **On click » Change language** on some buttons.

<Frame>
  <img src="https://mintcdn.com/standards/ehCcBR584ReEZevk/images/language_selection.gif?s=acda1c7f4f61abd5ebec323b1a4ad2b9" alt="Guidelines with languages being changed between using buttons" width="2000" height="1000" data-path="images/language_selection.gif" />
</Frame>

### Add change language buttons

<Steps>
  <Step title="Add a button">
    Within the design editor, select the add button tool <kbd>B</kbd> then select in body where to add it
  </Step>

  <Step title="Add click behavior">
    Select the button, then select the click button (cursor clicking icon) from the contextual toolbar
  </Step>

  <Step title="Choose change language behavior">
    Within the click behavior settings, selec the change language behavior. Then select the language the button will change the guidelines to.
  </Step>

  <Step title="Optional: Repeat for more languages">
    Follow the same steps to add more buttons for additional languages
  </Step>
</Steps>

<Info>
  **Tip:** If there are many languages to switch between you could add the buttons inside of a dropdown <kbd>D</kbd>
</Info>

Learn more about [buttons](/button) and [dropdowns](/dropdown)

***

## Alternate media

Standards’ localization goes beyond the text on screen, enabling alternate media to be chosen per language. This is especially helpful when media has ‘baked in’ text to show example designs, so every language has its own version.

<Frame>
  <img src="https://mintcdn.com/standards/CR_kF1BrWgp3pcsY/images/alternate_media.gif?s=4144f63442f45f7228a71e493178e26b" alt="Replacing a file with another in the content mode of the editor" width="1200" height="600" data-path="images/alternate_media.gif" />
</Frame>

<Steps>
  <Step title="Select language">
    From within the project editor, select the preferred language to edit content from the top bar. The editor will change to content mode where copy and media can be changed
  </Step>

  <Step title="Select media">
    Select media to show the file and description.
  </Step>

  <Step title="Choose different file">
    Select the file, then choose another from the right sidebar, then select `done`
  </Step>
</Steps>

<Info>
  **Tip:** On media fills, you can change both the file used per language and breakpoint. For instance, a media element can have a mobile optimized version chosen, and a language optimized version of it can be chosen as well.
</Info>

***

## Language settings

Every Standards site has language settings where the default language and text direction is set. All additional languages will also show here where the text direction can be set, and where they’re removed.

### Access language settings:

<Steps>
  <Step title="Select language dropdown">
    From within the project editor, select the language dropdown (globe icon) from the top bar
  </Step>

  <Step title="Select language settings">
    From the localization dropdown, select **Language settings** at the bottom
  </Step>

  <Step title="Modify settings">
    Manage the language settings in the right sidebar that appears. Choosing the text direction is a common setting update.
  </Step>
</Steps>

***

## FAQ

<AccordionGroup>
  <Accordion title="How do I upgrade to enable localization?">
    Please fill our [<u>customer requirements form</u>](https://forms.standards.site/customer_requirements) and we’ll follow up
  </Accordion>

  <Accordion title="How many languages can I have in a single guidelines?">
    Up to 20
  </Accordion>

  <Accordion title="Do I need to duplicate my site for each language?">
    No, there is essentially a single default site that additional languages use. Only text content needs to be updated for each language, all edited from the same editor.
  </Accordion>

  <Accordion title="What technology do you use for the automatic translations?">
    Standards uses Google’s cloud translation API
  </Accordion>

  <Accordion title="Do translations work on proper nouns, idioms, and other trickier words?">
    Automatic translations will attempt to translate to the fullest degree, but proper nouns and idioms may not be translated. It is important to proof each language for accuracy after it has been added.
  </Accordion>
</AccordionGroup>
