# init(localized:defaultValue:options:table:bundle:locale:comment:) Creates a localized string from an arbitrary static string key, applying the specified options. ``` init(localized key: StaticString, defaultValue: String.LocalizationValue, options: String.LocalizationOptions, table: String? = nil, bundle: Bundle? = nil, locale: Locale = .current, comment: StaticString? = nil) ``` ## Parameters `defaultValue` A default value to use if looking up a localized string from the bundle fails. This is typically the localizable string in the development language. `options` A localization options instance that specifies localization options to apply, such as replacement values for formatted strings. `table` The bundle’s string table to search. If `table` is `nil` or is an empty string, the method attempts to use the table named `Localizable`. The default is `nil`. `bundle` The bundle to use for looking up strings. If `nil`, an app searches its main bundle. The default is `nil`. `locale` The locale to use when localizing interpolated values, such as numbers. This doesn’t change which locale the system uses to look up the localized string. If `nil`, this initializer uses the current locale. The default is `nil`. `comment` The comment to place above the key-value pair in the strings file. This parameter provides the translator with some context about the localized string’s presentation to the user. ## Discussion Use the `defaultValue` initializers when you want to use an explicit *key* to look up localized strings. This is useful if the localizable string in your development language is ambiguous. For example *call* in English can be a noun or a verb. In this case, you might want to use `.strings` file entries like `CALL_NOUN` and `CALL_VERB` to disambiguate the uses for localizers. You then use this initializer, providing both a key and a default value to use if the system can’t find the key at runtime. ```swift // Assume the strings file or catalog contains the following: // English: CALL_VERB = "Call", CALL_NOUN = "Call" // French: CALL_VERB = "Appeler", CALL_NOUN = "Appel" let callVerb = String(localized: "CALL_VERB", defaultValue: "Call") let callNoun = String(localized: "CALL_NOUN", defaultValue: "Call") // callVerb == "Call" in en locale, "Appeler" in fr locale. // callNoun == "Call" in en locale, "Appel" in fr locale. ``` Use the `options` parameter to include any replacement values to insert into the localized formatted string. The following example shows how to insert strongly-typed replacement values into a string: ```swift // Assume the strings file or catalog contains the explicit key "POSITION_IN_QUEUE", // with localizations "Position in queue: %lld." for English and // "Position dans la file d’attente: %lld." for French. var options = String.LocalizationOptions() options.replacements = [12] let localized = String (localized: "POSITION_IN_QUEUE", defaultValue:"Position in queue: \(placeholder: .int).", options: options) // localized = "Position in queue: 12." in en locale, "Position dans la file d’attente: 12." in fr locale. ``` To use the default localization as the key rather than an explicit key, use [`init(localized:options:table:bundle:locale:comment:)`](/documentation/Swift/String/init(localized:options:table:bundle:locale:comment:)) instead. If you need to provide localized strings to another process that might be using a different locale, use [`init(localized:options:)`](/documentation/Swift/String/init(localized:options:)). --- Copyright © 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)