<!--
{
  "documentType" : "article",
  "framework" : "Xcode",
  "identifier" : "/documentation/Xcode/importing-localizations",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "Importing localizations"
}
-->

# Importing localizations

Import the files that you translate or adapt for a language and region into your
project.

## Overview

After you localize the contents of a catalog, import the localizations back into
your project. When you import localizations, Xcode updates the strings files in your
project from the localized versions in the XLIFF file in the catalog.

### Import localizations using Xcode

In the Project navigator, select the project, then choose Product > Import Localizations.
In the import dialog that appears, select the Xcode Localization Catalog folder,
and click Import. Xcode ingests the files and warns you if there are untranslated
files.

In the sheet that appears, review the warnings and errors. In the left column, click
the Issues View button in the toolbar, then select a message that appears below.
In the comparison editor on the right, the imported catalog version of the file appears
on the left and the current project file appears on the right.

![Screenshot of an import localization sheet where you review changes and errors.](images/com.apple.Xcode/importing-localizations-1@2x.png)

To review all the changes, click the File View button in the toolbar, and select
a file in the navigator below. When you’re ready to import the files, click Import.
Xcode updates the strings and `.stringsdict` files from the localized versions in
the catalog. Xcode also updates any localizable resources and assets in an asset
catalog.

### Import localizations using commands

You can also import the catalog with the `xcodebuild` command using the `-importLocalizations`
argument:

`xcodebuild -importLocalizations -project <projectname> -localizationPath <dirpath>`

Be sure to test your app for the languages and regions in your project.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)