WebStorm 2020.1 Help

File Encodings

File | Settings | Editor | File Encodings for Windows and Linux
WebStorm | Preferences | Editor | File Encodings for macOS
Ctrl+Alt+S the Settings/Preferences icon

Use this settings page to configure encoding options globally, for the current project, or for any file or directory in your project.

If the file or directory encodings are not defined, then the project encoding is used. In case the project encoding cannot be taken (for example, when the project is not yet created), WebStorm uses global encoding.

The file or directory encodings take precedence over the project encoding, which, in turn, takes precedence over the global encoding.



Global Encoding

Select the encoding to be used by default if no other encoding options are specified.

The chosen encoding will be applied, for example, when you specify settings of a default project or check out sources from a version control storage.

Choose System Default to use the default encoding of your operating system.

Project Encoding

Choose the default encoding to be used in the folders for which no encoding is appointed in the Default encoding field below.

Choose System Default to use the default encoding of your operating system.


This column displays the paths to files or directories.

Default encoding

This column displays encoding for files or directories specified in Path.

If encoding is defined within a file and cannot be changed, it's shown greyed out.

If encoding is configurable, select it from the list of options.

Encoding information embedded in a file overrides the selected one; encoding information for the nested files or directories overrides that for the outer directories or the whole project.

Default encoding for properties files

Specify the encoding for the properties files in your project.

Transparent native-to-ASCII conversion

Select this option to have national characters (non-ISO 8859-1), stored as escape sequences, shown in the property files.

If this checkbox is cleared, WebStorm doesn't show national characters.

Create UTF-8 files

Use this selector to choose how WebStorm should create UTF-8 files:

This option can be helpful if you work on an OS other than Windows and want more flexibility for the UTF-8 file encoding.

Keep in mind that the UTF-8 with BOM option may cause problems with software which is not compatible with BOM or with scripts that need to be run by an interpreter.

Last modified: 8 April 2020