# Managing App Localizations

The ARwayKit Sample App utilizes the [Unity Localization package](https://docs.unity3d.com/Packages/com.unity.localization@1.3/manual/QuickStartGuideWithVariants.html) to configure the localization settings.

**You will need to modify the localization strings to remove any mention of ARway** if you want to customize your own app with unique branding.

## Choosing a Default Locale <a href="#choose-a-default-locale" id="choose-a-default-locale"></a>

Follow this [guide ](https://docs.unity3d.com/Packages/com.unity.localization@1.3/manual/QuickStartGuideWithVariants.html#choose-a-default-locale)by Unity to select which locale your application will use by default.

## Importing and Exporting <a href="#importing-and-exporting-csv-files" id="importing-and-exporting-csv-files"></a>

The Unity localization package offers three ways to modify and export: CSV, Google Sheets, and XLIFF.

### Importing and Exporting CSV files <a href="#importing-and-exporting-csv-files" id="importing-and-exporting-csv-files"></a>

You can use the CSV (Comma Separated Values) format to import and export [String Table Collections](https://docs.unity3d.com/Packages/com.unity.localization@1.3/manual/StringTables.html). This makes it easier to work with translators who use CSV for translation; you can export String Table Collections from Unity to CSV files, send them to the translator for modification, and then re-import the modified files back into Unity.

#### Exporting the CSV

1. Navigate to "Window -> Asset Management -> Localization Tables"

   <figure><img src="/files/rzIauQ8s8SoVe80AEJ0I" alt=""><figcaption><p>Navigating to Localization Tables</p></figcaption></figure>
2. In Localization Tables window, click on the "Edit Table Collection" tab to open the table collection with the name "StringTable\_Localization"

   <figure><img src="/files/OhWQQRp4udfLRdAXD726" alt="" width="375"><figcaption><p>StringTable_Localization Table Collection</p></figcaption></figure>
3. Click the three vertical dots at the top right of the window and select "Export -> CSV…".

   <figure><img src="/files/rbMCsGYjQ7WWmnS4K5YS" alt=""><figcaption><p>CSV export menu</p></figcaption></figure>
4. Then select a location to store the CSV and then save.

After you have exported the CSV, you can make changes to the different string stored in each cell.

#### Importing the CSV

1. Navigate to "Window -> Asset Management -> Localization Tables"

   <figure><img src="/files/rzIauQ8s8SoVe80AEJ0I" alt=""><figcaption><p>Navigating to Localization Tables</p></figcaption></figure>
2. In Localization Tables window, click on the "Edit Table Collection" tab to open the table collection with the name "StringTable\_Localization"

   <figure><img src="/files/OhWQQRp4udfLRdAXD726" alt="" width="375"><figcaption><p>StringTable_Localization Table Collection</p></figcaption></figure>
3. Click the three vertical dots at the top right of the window and select "Import -> CSV…".

   <figure><img src="/files/Asngv5zMlVNXpLRPqUOX" alt=""><figcaption><p>CSV import menu</p></figcaption></figure>
4. Select CSV file to be imported.
   * Note: When importing, make sure that the structure / headers of the CSV file that was exported remains the same.
5. Once imported, check the data in the Table Collection to ensure that the imported data is correct.

### Google Sheets

The Unity Localization package allows you to synchronize [Google Sheets](https://docs.google.com/spreadsheets) data with the content of a String Table Collection. By default, this feature can synchronize a String Table’s keys, values, and comment metadata. You can also add support for additional data through scripts.

More information can be found on the [Localization Unity package](https://docs.unity3d.com/Packages/com.unity.localization@1.3/manual/Google-Sheets.html) page.

### XLIFF <a href="#xliff" id="xliff"></a>

XML Localisation Interchange File Format (XLIFF) is a standardized way to store localization data. It is supported by many different Computer Aided Translation (CAT) tools, which allows for a smoother translation pipeline when working with translators.

You can export String Table Collections from Unity to one or more XLIFF files, modify them with external CAT tools, and finally re-import them back into Unity with the updated translations.

More information can be found on the [Localization Unity package](https://docs.unity3d.com/Packages/com.unity.localization@1.3/manual/XLIFF.html) page.

## Building the Localization Assets <a href="#preview-and-configure-your-build" id="preview-and-configure-your-build"></a>

To use the localized assets in the player, you must build the Addressables player content.&#x20;

After updating source codes, take these conditions into account to determine if building Addressable is necessary:

* If this is the initial build after checking out the source code.
* If Addressable hasn't been built successfully in previous attempts.
* If there have been modifications to String Tables.

To do this, in the Addressables window:

1. Navigate to "Window -> Asset Management -> Addressable -> Groups".
2. In the Addressables Groups window, click on "Build -> New Build -> Default Build Script".

{% hint style="info" %}
When making any changes that affect localization strings, you will need to update the Addressables Groups.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.arway.ai/arway-sdk/managing-app-localizations.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.