1# SwiftUI Text Patterns Reference
2 
3> For broader localization guidance — String Catalogs, `#bundle` for packages, `LocalizedStringResource`, locale-aware formatting, RTL layout, and translator comments — see `references/localization.md`. This file covers only the verbatim-vs-localized decision for a single `Text`.
4 
5## Table of Contents
6 
7- [Text Initialization: Verbatim vs Localized](#text-initialization-verbatim-vs-localized)
8 
9## Text Initialization: Verbatim vs Localized
10 
11**Default: always use `Text("…")`.** Only use `Text(verbatim:)` when explicitly required for a string literal that must not be localized.
12 
13```swift
14// Localized literal - "Save" is used as the localization key and looked up in Localizable.strings (only if one exists in the project)
15Text("Save")
16 
17// String variable - bypasses localization automatically; no verbatim needed
18let filename: String = model.exportFilename
19Text(filename)
20 
21// Non-localized literal - use verbatim only when the literal must not be localized
22Text(verbatim: "pencil")
23```
24 
25### Decision Flow
26 
27```
28Is the input a String variable or dynamic value?
29└─ YES → Text(variable)          // bypasses localization automatically
30 
31Is the string literal intended for localization?
32├─ YES → Text("…")               // default; key looked up in Localizable.strings
33└─ NO  → Text(verbatim: "…")     // only when explicitly non-localized
34```
35