---
title: String.LocalizationValue
framework: swift
role: symbol
role_heading: Structure
path: swift/string/localizationvalue
---

# String.LocalizationValue

A reference to a localizable string, with optional string interpolation.

## Declaration

```swift
struct LocalizationValue
```

## Overview

Overview Use this type when the localization key is the localized string value in the development language.  This type also supports creating localized strings that depend on a value you provide at runtime. For example, if your app’s strings catalog contains a localizable entry for "Hello, \(userName).", you create a localized string like the following:     let greeting = String(localized: "Hello, \(userName).") If you want to use an arbitary string as your localization key, use String initializers that take a StaticString and a defaultValue parameter, like init(localized:defaultValue:table:bundle:locale:comment:) and init(localized:defaultValue:options:table:bundle:locale:comment:). If you need to provide localized strings to another process that might be using a different locale, initialize with a LocalizedStringResource, using init(localized:) or init(localized:options:).

## Topics

### Creating a string localization value instance

- [init(_:)](swift/string/localizationvalue/init(_:).md)

### Supporting types

- [String.LocalizationValue.Placeholder](swift/string/localizationvalue/placeholder.md)

## Relationships

### Conforms To

- [Copyable](swift/copyable.md)
- [Decodable](swift/decodable.md)
- [Encodable](swift/encodable.md)
- [Equatable](swift/equatable.md)
- [Escapable](swift/escapable.md)
- [ExpressibleByExtendedGraphemeClusterLiteral](swift/expressiblebyextendedgraphemeclusterliteral.md)
- [ExpressibleByStringInterpolation](swift/expressiblebystringinterpolation.md)
- [ExpressibleByStringLiteral](swift/expressiblebystringliteral.md)
- [ExpressibleByUnicodeScalarLiteral](swift/expressiblebyunicodescalarliteral.md)
- [Sendable](swift/sendable.md)
- [SendableMetatype](swift/sendablemetatype.md)

## See Also

### Creating a Localized String

- [init(localized:table:bundle:locale:comment:)](swift/string/init(localized:table:bundle:locale:comment:).md)
- [init(localized:options:table:bundle:locale:comment:)](swift/string/init(localized:options:table:bundle:locale:comment:).md)
- [String.LocalizationOptions](swift/string/localizationoptions.md)
- [init(localized:defaultValue:table:bundle:locale:comment:)](swift/string/init(localized:defaultvalue:table:bundle:locale:comment:).md)
- [init(localized:defaultValue:options:table:bundle:locale:comment:)](swift/string/init(localized:defaultvalue:options:table:bundle:locale:comment:).md)
- [init(localized:)](swift/string/init(localized:).md)
- [init(localized:options:)](swift/string/init(localized:options:).md)