IntelliJ IDEA 2024.3 Help

Properties files

Properties files are text files with the .properties extension, containing localization strings in the form of key and value pairs that can be accessed and rendered in the UI.

IntelliJ IDEA marks these files with the following icon: Properties file.

IntelliJ IDEA also recognizes properties files in XML format. They are marked with the icon XML properties file.

Several properties files with the same base name and a language-specific suffix can be combined into a resource bundle for convenience.

Create a properties file

  1. Right-click a directory where you would like to create the file.

  2. From the context menu of the target directory, choose New | File.

  3. In the New File dialog, type the filename with the corresponding extension .properties, and click OK.

Encoding of properties files

As of Java 9, properties files switched from being loaded using the ISO-8559-1 encoding to the UTF-8 encoding. For more information, refer to the Oracle documentation.

In IntelliJ IDEA, the default encoding for properties files is UTF-8. You can also use escape sequences for characters not defined by the selected encoding. Alternatively, you may choose to define a different default encoding for properties files on the project level.

Configure default encoding for properties files

  1. In the Settings dialog (Ctrl+Alt+S) , select Editor | File Encodings.

  2. Select the encoding from the Default encoding for properties files list.

  3. If necessary, enable Transparent native-to-ascii conversion to show native characters (those not defined in ISO-8859-1) in place of the corresponding escape sequences.

For more information, refer to Encoding.

If the default encoding for properties files is set to the UTF-8 properties default option in your settings and IntelliJ IDEA encounters a character in the properties file not supported by UTF-8, then IntelliJ IDEA will automatically switch the encoding of that properties file to ISO-8559-1.

The default properties file encoding setting

If your properties files are using the UTF-8 encoding and IntelliJ IDEA identifies that Java code that is version 8 or earlier (for example, in the runtime of your server) accesses properties files with characters not defined in the ISO-8859-1 character set, the Convert to escape sequences inspection allows you to convert the non-compliant characters into escape sequences for compatibility.

The convert to escape sequences inspection
Last modified: 17 October 2024