Convert String Catalog to YAML online

Upload a Xcode String Catalog (.xcstrings) file and download it as YAML. Translation keys, plurals and placeholders are preserved. Free, no account needed.

Pick the source format or let the converter detect it from the file.

Choose the format you want to download.

YAML

YAML translation files use indentation instead of braces, which makes them easy to read and diff. Ruby on Rails, Symfony and many static site generators keep their locale files in YAML.

One file per language. Format documentation

Need it the other way round? Convert YAML to String Catalog.

From: Xcode String Catalog (.xcstrings)

String Catalogs were introduced in Xcode 15 and store all languages, plural variants and device variations of a project in one JSON-based .xcstrings file.

Used by: Xcode 15+, SwiftUI, iOS 17+. All languages in one file. Read the String Catalog format guide.

{ "sourceLanguage" : "en", "strings" : { "hello world" : { "comment" : "My Hello World description", "extractionState" : "manual", "localizations" : { "pl" : { "stringUnit" : { "state" : "translated", "value" : "Witaj Świecie!" } } } } }, "version" : "1.0" }
{
  "sourceLanguage" : "en",
  "strings" : {
    "hello world" : {
      "comment" : "My Hello World description",
      "extractionState" : "manual",
      "localizations" : {
        "pl" : {
          "stringUnit" : {
            "state" : "translated",
            "value" : "Witaj Świecie!"
          }
        }
      }
    }
  },
  "version" : "1.0"
}

To: YAML

YAML translation files use indentation instead of braces, which makes them easy to read and diff. Ruby on Rails, Symfony and many static site generators keep their locale files in YAML.

Used by: Ruby on Rails, Symfony, Jekyll, Hugo. One language per file. Read the YAML format guide.

hello-world: Hello World! nested: translation: key: Nested translation key other: translation: key: supported: Look this is also supported!
hello-world: Hello World!
nested:
  translation:
    key: Nested translation key
  other:
    translation:
      key:
        supported: Look this is also supported!

How to convert String Catalog to YAML

  1. Drop your .xcstrings file into the converter above, or paste its content.
  2. Click Convert. You get one .yml file per language.
  3. Preview the result, copy it or download the files.

What changes between String Catalog and YAML

  • String Catalog holds every language in one file, so the converter writes one YAML file per language found in the source.
  • Keys are written flat by default. Enable "Write nested keys" to turn a.b.c into nested objects.

Convert and translate in one place

If you need the YAML file in more languages, the fastest route is a free SimpleLocalize project: import the String Catalog file, add languages, run auto-translation with DeepL, Google Translate, OpenAI, Claude or Gemini, and download the result as YAML. The CLI does the same from CI with upload and download commands, so the conversion becomes part of your build. See also translating String Catalog files.

Frequently asked questions

Is the converter free?

Yes. There is no signup and no limit on the number of conversions beyond a few requests per second.

Are my files stored?

No. The file is parsed in memory, converted and returned in the same request. Nothing is written to disk or a database.

What about plurals and placeholders?

Plural forms are normalized to ICU message syntax and written back in the native form of YAML. Placeholders are kept, and Apple and Android specific syntax is translated between platforms. Read more in the pluralization guide.

Translate your YAML files

  • Import String Catalog or YAML files into a free project
  • Auto-translate with DeepL, Google, OpenAI, Claude or Gemini
  • Download in any of the supported formats or publish to the CDN
Start for free
No credit card required5-minute setup
"The product
and support
are fantastic."
Laars Buur|CTO
"The support is
blazing fast,
thank you Jakub!"
Stefan|Developer
"Interface that
makes any dev
feel at home!"
Dario De Cianni|CTO
"Excellent app,
saves my time
and money"
Dmitry Melnik|Developer