CSV

Simple CSV files, fields separated by comma.

File Extensions .csv
API Extension csv
Format Options key_index, translation_index, comment_index, column_separator, quote_char, header_content_row, enable_pluralization
Import Yes
Export Yes
Pluralization supported? Yes
Descriptions/Comments supported? Yes

Example

app_title,My Software Project,This is the main title
apples.zero,zero apples,my comment
apples.one,one apple
apples.many,many apples
greeting,"Hello 'User'!
How are you doing today?"

Format Options

Option Type Upload Download Default Description
key_index integer 1 Index of the column containing the key names.
translation_index integer 2 Index of the column containing the actual translation content.
comment_index integer 3 Index of the column containing description for the key.
column_separator string , Char that is used to separte rows.
quote_char string " Char that is used to quote CSV columns.
header_content_row boolean false Indicates whether the first row contains only header information and should be skipped.
enable_pluralization boolean false Enables detection of pluralized keys. All matching keys will be persisted as pluralized keys.

File structure

A typical CSV file should be structured like this:

1 (Key column), 2 (Translation column), 3 (Comment column)
app_title,      My Software Project,    This is the main title
apples.zero,    one apple,              my comment
...

Pluralization

This format uses named categories to identify the different pluralizations of a key. The following categories are reserved for pluralization:

.zero | .one | .two | .few | .many | .other

Example key names:
inbox.messages.notification.one
inbox.messages.notification.other

This way pluralized keys can be identified, persisted and marked accordingly.
Learn more about pluralization?