WebStorm Help

Content Root

On this page:

Basics

In the terms of WebStorm, content is a collection of files with which you are currently working, possibly organized in a hierarchy of subfolders. The folder which is the highest in this hierarchy is called content root folder or content root (shown as folder) for short. A project has at least one content root folder, by default it is the project folder itself.

Having several content roots enables you to work with files from several directories that do not have a common immediate parent. This is helpful when you use some static contents, for example, icons. You can just save them all in a folder and then specify this folder as an extra content root in several projects.

Types of content roots

By default, all the files in a content root folder are involved in indexing, searching, parsing, code completion, etc. To change this status, folders within a content root can be assigned to the following categories:

  • Test source roots (or test source folders; shown asrootTest).
  • Excluded roots (marked as rootExcluded) are ones that WebStorm "partially ignores".

    These roots contain files and folders ignored by WebStorm when indexing, searching, parsing, watching etc.

    Excluded roots are not visible to WebStorm. Usually, one would like to exclude temporary build folders, generated output, logs, and other project output. Excluding the unnecessary paths is a good way to significantly improve performance.

  • Resource roots (or resource folders; marked as rootResourceIJ).

    These roots are intended for resource files in your application (images, style sheets. etc.) By assigning a folder to this category, you tell WebStorm that files in it and in its subfolders can be referenced relative to this folder instead of specifying full paths to them.

See Also

Last modified: 22 May 2015