Best Practices for App Localization in Swift

In today’s globalized world, reaching users from different countries and cultures is crucial for the success of any mobile app. App localization in Swift allows you to adapt your app's content, language, and format to different regions, ensuring a better user experience for people worldwide. In this article, we’ll explore some best practices for effectively localizing your Swift app.

1. Plan for Localization from the Start

When designing your app, consider localization early in the development process. This includes using NSLocalizedString for all user-facing text and avoiding hardcoding strings directly in your Swift files. By planning ahead, you can prevent costly redesigns and refactoring later on.

Example:

let welcomeMessage = NSLocalizedString("welcome_message", comment: "Welcome messageon the home screen")

2. Use Base Internationalization

Base internationalization separates the user interface layout from the language-specific content. It stores your storyboard or XIB files in a base language (like English) and keeps the translatable text in separate .strings files. This approach makes it easier to update your UI without impacting translations.

To enable base internationalization:

• Go to your project settings.
• Under the “Info” tab, enable “Use Base Internationalization.”
• Select your storyboard or XIB files to use as the base.

3. Organize Localizable Strings

Maintain a clean and organized project by storing your localized strings in separate .strings files for each language. Use descriptive keys to make it easier for translators to understand the context.

Example of Localizable.strings (English):

"welcome_message" = "Welcome!";
"error_message" = "An error has occurred.Please try again.";

Example of Localizable.strings (Spanish):

"welcome_message" = "¡Bienvenido!";
"error_message" = "Ha ocurrido un error. Por  favor, inténtalo de nuevo.";

4. Handle Text Expansion

Different languages take up different amounts of space. For example, German text is typically longer than English. Design your UI with flexible layouts, like using UILabel with dynamic height or auto-layout constraints, to handle text expansion gracefully.

Tips:

• Avoid fixed-width labels.
• Use auto-layout constraints.
• Test with longer strings to ensure the UI adjusts properly.

5. Localize Images and Media

If your app uses images or media containing text, consider localizing them. Xcode allows you to provide localized versions of assets.

To localize images:

• Add the image to your asset catalog.
• Select the image and click “Localize…”
• Choose the languages you want to support.
• Provide language-specific versions of the image.

6. Date, Time, and Number Formatting

Different regions use different formats for dates, times, and numbers. Use DateFormatter and NumberFormatter to display them according to the user’s locale.

Get Commit Studio’s stories in your inbox

Join Medium for free to get updates from this writer.

Remember me for faster sign in

Example:

let dateFormatter = DateFormatter()
dateFormatter.dateStyle = .long
dateFormatter.locale = Locale(identifier: "fr_FR")
let dateString = dateFormatter.string(from: Date())
print(dateString) // e.g., "16 février 2025"

7. Test with Multiple Languages

Always test your app with multiple languages to ensure a consistent and error-free user experience. Use Xcode's simulator to change the language settings or adjust the preferred language order in iOS settings.

To test localization:

• Go to iOS Settings > General > Language & Region.
• Change the language or adjust the preferred language order.
• Run your app to see the localized content.

8. Continuous Localization

Keep your localized content up to date as your app evolves. Use tools like Xcode’s “Export for Localization” feature to generate .xliff files for translators and easily import updated translations.

To export for localization:

• In Xcode, go to Product > Export Localizations.
• Select the base language and export the .xliff file.
• Send the file to translators.
• Once translated, import it back using Product > Import Localizations.

9. Avoid Hardcoding and Concatenation

Avoid hardcoding strings or concatenating localized strings with variables, as different languages have different grammar rules and sentence structures. Instead, use string interpolation or formatted strings.

Example:

let itemCount = 3
let message = String(format: NSLocalizedString("items_in_cart", comment: "Items incart message"), itemCount)

Localizable.strings (English):

"items_in_cart" = "You have %d items inyour cart.";

Localizable.strings (French):

"items_in_cart" = "Vous avez %d articlesdans votre panier.";

10. Collaborate with Professional Translators

Work with professional translators who understand the cultural nuances of your target audience. This helps avoid miscommunication and ensures that your app resonates well with users worldwide.

Conclusion

App localization in Swift is more than just translating text. It involves adapting your app’s content, layout, and user experience to meet the cultural expectations of different regions. By following these best practices, you can build a truly global app that reaches a wider audience and enhances user satisfaction.

Start localizing your Swift app today and expand your reach across the world!