1. Help Center
  2. Supported formats

Symfony YAML

What is Symfony YAML and how can you employ it in translation projects in Phrase?

File Extensions .yml, .yaml
API Extension yml_symfony
Import Yes
Export Yes
Pluralization supported? Yes
Descriptions supported? No


Symfony is a high-performance PHP framework composed of various predefined PHP components. Localization for applications built with Symfony can take place with file formats, such as XLIFF, YAML, and PHP Arrays. The Symfony development team recommends the use of YAML for small localization projects and XLIFF for larger or more complex ones. Compared with the XML-based XLIFF, YAML is more human-readable, with data nesting achieved using indentation rather than explicit tags.

Per YAML convention, while preparing YAML for translation in Phrase, please make sure indentation is done correctly through regular spaces, rather than TABs.  

Code Sample

---
boolean_key: true
empty_string_translation: ''
key_with_description: Check it out! This key has a description! (At least in some formats)
key_with_line-break: |-
  This translations contains
  a line-break.
nested:
  deeply:
    key: Wow, this key is nested even deeper.
  key: This key is nested inside a namespace.
null_translation:
pluralized_key:
  one: Only one pluralization found.
  other: Wow, you have %s pluralizations!
  zero: You have no pluralization.
sample_collection:
- first item
- second item
- third item
simple_key: Just a simple key with a simple message.
unverified_key: This translation is not yet verified and waits for it. (In some formats we also export this status)