Unknown Option On Gradle Import


Hi There,

I'm trying to import a gradle project and can't work out what the "Store generated project files externallyoption does as it seems to have no tooltip and no mention of it when pressing F1 to get the documentation...

Does anyone know what this option does?



This will not generate .iml and library files in .idea directory so that your project is easier to share via version control, since sharing generated files makes very little sense, see https://intellij-support.jetbrains.com/hc/articles/206544839.


Ahhh OK so this stores the project config files somewhere other than in the Gradle project? I'm guessing in the ~/.IntelliJIdea<version> folder instead?

(Also thanks for such a fast reply!)


Yes. In this case generated files will be stored in idea.system.path: https://intellij-support.jetbrains.com/hc/articles/206544519.


Please, documented this in the help.


@Elena: Thanks. You probably meant https://www.jetbrains.com/help/idea/2017.3/gradle.html#project_create_gradle? But even there I cannot find that option (is it a recent change that must be published yet?)

By the way, I was also a bit irritated because I realized that the online documentation wasn't up-to-date, and tried hard to find that fantastic url you have now referred to (with the `idea/2017.3` in it). It'd be very useful to have a link from the official online "current" help to the "development" version. For the reverse direction there is already a very prominent link (thanks!)


Elena has shared an internal link of the documentation that is still work in progress, it cannot be accessed outside of JetBrains network. Sorry for that. Once 2017.3 version is released, you'll be able to access it at the usual location.


@Serge Baranow I just checked https://github.com/JetBrains/intellij-community/blob/master/plugins/gradle/src/org/jetbrains/plugins/gradle/settings/GradleProjectSettings.java and it seems to me that this settings is not saved to gradle.xml? Correct?

Cause I'm trying to create a share checked in project definition in a gradle project and this setting does not seems to be persisted properly.

Overall the experience of trying to version control only what's needed when using gradle/intellij is underwhelming. A proper guide for this would be great.


Staffan, could you try IDEA 2017.3 RC (it should be available soon)? And if the issue still will be actual for you, please, file the bug at youtrack with logs attached and the steps to reproduce. Thanks in advance!


I will try as soon as it's out, I guess it will pop up in toolbox any day now?


This seems to work better now in RC.


Now in 2017.3.1 the option "Group modules: [] using explicit module groups [x] using qualified names" is undocumented.


Staffan, I've added a link to the grouping modules' chapter that is located in 


The actual Gradle topic will be republished asap.

Thank you for the comment.


Currently you can find the description here https://www.jetbrains.com/help/idea/gradle.html#project_create_gradle

>By default, a newly created or imported project is stored externally. That means that generated .iml and library files are stored in idea.system.path instead of the .idea directory. It might be helpful for sharing your project via version control.

>If you need to change this behavior, open the Gradle settings (Settings | Gradle) and clear the Store generated project files externally checkbox.

We will add it very soon for the Gralde settings page also. Thank you.


"External annotations" is not yet complete, (e.g., https://youtrack.jetbrains.com/issue/IDEA-200003) and will be removed from the UI in 2018.3.1


Please sign in to leave a comment.