Skip to main content
Version: 3.x.x


.properties files are usually used to store configuration & localization data for Java applications. To read more about the Java Resource Bundle localization, see the official Java Docs.

note: As of Java 9, the default encoding for .properties files is UTF-8. So, we export the data with UTF-8.

When exporting in .properties format, you can choose from various placeholder & message formats listed below.

Tolgee doesn't support arrays or nesting in the .properties files.

Example of a .properties file

# Password field label in the user settings form
user-settings.password.label = Password
dogs_count = {count, plural, one {One dog} other {# dogs}}

As visible in the example, the .properties file stores key-value pairs. Also, imports and exports of the comment are used as key descriptions.

The message format and placeholder conversion

When importing data to Tolgee from the .properties files, you can either enable or disable the conversion to the Tolgee Universal ICU placeholders. The conversion is enabled by default. You can also disable the conversion globally in the project settings. We recommend keeping the conversion enabled, as it brings many benefits. Read more about the benefits of Tolgee Universal ICU placeholders.

When the conversion is disabled, the original placeholders (e.g., %s, %d). are preserved. The message format is automatically detected when importing data in .properties format. When exporting, you can choose from message & placeholder formats listed above.

Importing / Exporting in general

To read more about importing and exporting with Tolgee, continue to import section or export section.