What is the .idea folder?

The .idea folder (hidden on OS X) in the solution root contains IntelliJ’s project specific settings files. These include per-project details such as VCS mapping and run and debug configurations, as well as per-user details, such as currently open files, navigation history and currently selected configuration.

Some files should be committed to source control, some should be excluded. Usually, one needs to share the following:

indexLayout.xml - this file is for the information about external folders attached to the solution, which are not the part of a .NET project. Such folders can be added via right-click on a solution -> “Attach Existing Folder...”.

vcs.xml - this file is for VCS-related internal information, as which VCS is enabled, etc.

runConfigurations - this folder is for shared run configurations.

Other files inside of .idea folder can be safely excluded from VCS (ex. modules.xml and riderModule.iml), as Rider can generate them again.

Please refer to this JetBrains.gitignore on GitHub to see what exactly should be ignored.

89 out of 149 found this helpful

But that linked .gitignore file doesn't exclude modules.xml or riderModule.iml.


Can I set .idea folder to some general location I set somewhere, unrelated to my source/Cmakefiles directories? if so where should I configure its location?


I think there should be a link to comprehensive list of files that should be included.


Can one mark that folder as "Excluded" from project itself?


There is .gitignore file in .Idea folder, should I add it to GIT?


Does the "ex." in "Other files inside of .idea folder can be safely excluded from VCS (ex. modules.xml and riderModule.iml), as Rider can generate them again." mean "for example" or "excluding"?

In English convention for "for example" is "e.g.".


This is really confusing. I am on my project folder but I see no `.idea` folder. Where is it suppose to be?


anyway to hide this in Windows  file explorer and from the Git Bash terminal? thanks!


Where is the "solution root"?


Please sign in to leave a comment.

Have more questions?

Submit a request