WebStorm 2026.1 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.

WebStorm marks these files with the following icon: Properties file.

WebStorm 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. From the context menu of the target directory, choose New | File.

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

Encoding of properties files

WebStorm applies system default encoding to properties files.

To use other encodings, feed them as escape sequences and Unicode characters. Alternatively, define the default encoding for properties files on the project level and use a different API that can read properties files in the encoding you have defined.

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. The default properties file encoding setting
  4. 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.

26 March 2026