Xcode Localization

If you're building an app for iOS, macOS, watchOS, visionOS, or tvOS, this guide will walk you through the complete Xcode localization process — from setting up a String Catalog to importing translated strings.

Step 1: Setup Your String Catalog

Start by gathering all your localizable strings into one file. In Xcode, if you haven't already, go to File -> New File and add a String Catalog.

Step 2: Prepare Your Strings

After setting up your string catalog, build your app to populate your strings. This may take a minute. Verify that all your strings are ready for export.

Step 3: Export String Catalog Files

• Navigate to Product > Export Localizations in the top menu of Xcode.
• Confirm and export your .xcloc files, which you will upload to String Catalog.

This will produce a .xcloc file for each language you set up in Xcode. If this is your first time setting up a string catalog, you only need to export your base language. We will handle the new languages for you.

Step 4: Upload and Choose Languages

Select your .xcloc files and choose the languages you want to localize your app into. We currently support 40 languages. Below, we're adding Spanish to our demo app with English as the base language.

Step 5: Review Translations

Once translated, review all strings to ensure accuracy. If we are unable to localize your string, it will be marked for review. You can filter by status, edit your strings, and search within your dashboard.

Step 6: Import Localized Strings

Integrate the localized strings back into your app. Begin by downloading your files from the String Catalog dashboard and unzipping the .xcloc files. Once you have your files downloaded, open Xcode and choose Import Localizations under the Product menu.

Step 7: Verify Localizations in Xcode

Your app is now localized, and you should see your new languages within Xcode. Congratulations, you're all set with your new languages! 🎉

If you encounter any issues or have any questions, please don't hesitate to reach out. I'd love to hear from you and happy to help!

FAQs About Xcode Localization

What is Xcode localization?

Xcode localization is the process of translating your app's user interface into different languages using Xcode's built-in tools like String Catalog and .xcloc files.

How do I localize my app in Xcode?

You can localize your app by setting up a String Catalog, exporting .xcloc files, and then re-importing translated versions into Xcode.

Does Xcode support localization for visionOS and macOS?

Yes! The same process works across iOS, macOS, visionOS, tvOS, and watchOS.