How to use String Catalogs for pluralization in Swift

At WWDC23, Apple introduced String Catalogs which replaces the way we add localization to iOS projects. In the previous article on how String Catalogs work, we covered the basics on localization with String Catalogs.

In this article, we'll look at how we can use them for pluralization.

Preparing for a technical iOS job interview

Check out my new book on preparing for a technical iOS job interview with over 200 questions & answers. Test your knowledge on iOS topics such as Swift & Objective-C, SwiftUI & UIKit, Combine, HTTP Networking, Authentication, Core Data, Concurrency with async/await, Security, Automated Testing and more.

LEARN MORE

Before String Catalogs, we had to use .stringdict files to add localized pluralization support. To learn how that worked, check out this article on how to localize plurals by using the Localizable.stringsdict file.

String Catalogs come with built-in support for String pluralization. To localize plurals with String Catalogs, we have to:

1. Define a format specifier within the localization key, for example applesSelection.title.%lld
2. Use the format specifier within the translations, for example %lld apples
3. Right-click on the created key-value and choose Vary by plural:

4. Xcode prefills all values for us. What's left to do is to adjust the translations for different pluralization cases:

Now, we can use the localized String as follows:

LocalizedStringKey("applesSelection.title.\(5)")

In case we need pluralization for more than one value in a String, we can use variables:

Xcode provides options to create variables when we add more than one format specifier. We can also define them by enclosing the variable name as follows: %#@applesCount@

Preparing for a technical iOS job interview

Check out my new book on preparing for a technical iOS job interview with over 200 questions & answers. Test your knowledge on iOS topics such as Swift & Objective-C, SwiftUI & UIKit, Combine, HTTP Networking, Authentication, Core Data, Concurrency with async/await, Security, Automated Testing and more.

LEARN MORE