Convert YAML to String Catalog online

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

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

Used when the source format holds one language per file. Also used as the source language for XLIFF output.

Choose the format you want to download.

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.

All languages in one file. Format documentation

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

From: 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!

To: 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"
}

How to convert YAML to String Catalog

  1. Drop your .yml file into the converter above, or paste its content.
  2. Confirm the language of the file. It is guessed from the file name, for example de.json or messages_pt-BR.properties.
  3. Click Convert. You get a single .xcstrings file with all languages.
  4. Preview the result, copy it or download the file.

What changes between YAML and String Catalog

  • String Catalog keeps all languages together. A single YAML file produces a String Catalog file with one language column; upload more files to a SimpleLocalize project to merge languages.

Convert and translate in one place

If you need the String Catalog file in more languages, the fastest route is a free SimpleLocalize project: import the YAML file, add languages, run auto-translation with DeepL, Google Translate, OpenAI, Claude or Gemini, and download the result as String Catalog. The CLI does the same from CI with upload and download commands, so the conversion becomes part of your build. See also translating YAML 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 String Catalog. Placeholders are kept, and Apple and Android specific syntax is translated between platforms. Read more in the pluralization guide.

Translate your String Catalog files

  • Import YAML or String Catalog 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