Localization

Introduction

If your app supports multiple languages, the chat SDK has support for localizations. For example, you can add more languages, or you can change translations for the existing texts used throughout the SDK.

Adding a New Language

1. If you don't have strings or stringsdict files in your project, add those new files to Localizable.strings and Localizable.stringsdict.
2. Next add new language to the project.
3. Copy the StreamChatSwiftUI localization keys into your strings and stringsdict files. You can find the latest version here.
4. Set the localizationProvider to provide your Bundle instead of the one provided by StreamChatSwiftUI SDK (as early as possible in the App lifecycle, for example in the AppDelegate):

Appearance.default.localizationProvider = { key, table in
    Bundle.main.localizedString(forKey: key, value: nil, table: table)
}

5. Now, you're ready to implement your strings and stringsdict files for different languages.

Override Existing Languages

Overriding the existing language works in the same as adding a new language.

Override Specific Keys

If you only need to change a few strings without replacing the entire localization file, you can capture the default provider and fall back to it for keys you don't need to customize:

let defaultProvider = Appearance.default.localizationProvider

Appearance.default.localizationProvider = { key, table in
    switch key {
    case "channel.name.missing":
        return Bundle.main.localizedString(forKey: "my-own-channel-name-key", value: nil, table: nil)
    default:
        return defaultProvider(key, table)
    }
}

This approach lets you selectively override individual keys while keeping the SDK's default translations for everything else.

Resources

Every string included in StreamChat can be changed and translated to a different language. All strings used by UI components are in these two files:

• Localizable.strings
• Localizable.stringsdict