IntelliJ IDEA 2018.2 Help

Import from Maven. Page 1

Use this page to specify the import preferences. The default import settings are defined in the Maven Integration dialog.



Root directory

Specify the directory where the Maven projects you want to import are located.

Search for projects recursively

Select this checkbox to make import look for the nested pom.xml files.

Project format

Select the format in which you want to store your project. For the details on the two available formats, refer to the Working with projects section.

Keep project files in

Select this checkbox to specify the desired location for storing project and module files.

Import Maven projects automatically

Select this checkbox if you want IntelliJ IDEA to perform reimport automatically each time you change your pom.xml.

Create IntelliJ IDEA modules for aggregator projects (with 'pom' packaging)

Clear this checkbox to skip creating IntelliJ IDEA modules. You might want to do that if the Maven project you import is an aggregator, and its packaging element has the value pom.

Create module groups for multi-module Maven projects

If this checkbox is selected, IntelliJ IDEA will create a module group from an aggregative Maven project, with the nested modules included in this group.

Keep source and test folders on reimport

If this checkbox is selected, the source and test folders are kept when you reimport a project.

Exclude build directory

Clear this checkbox to disable the automatic exclusion of target folders.

Note if a /target directory contains /target/generated-sources, then the /target directory cannot be excluded since /target/generated-sources directory is marked as sources. Other subdirectories in the /target directory are excluded.

Use Maven output directories

If this checkbox is not selected, the build is created in the regular IntelliJ IDEA's output directory USER_HOME\IdeaProjects\<project>\classes\Production\.
If this checkbox is selected, the build is generated in the Maven's output directory, and the results of IntelliJ IDEA's compilation are reused. However, IntelliJ IDEA itself does not reuse Maven build results and performs compilation from scratch.

Generated sources folders

Specify the directory of your source root when you reimport a project.
You can select one of the following options:
  • Detect automatically This is a default option. When you select this option, IntelliJ IDEA automatically detects the location of the generated sources. IntelliJ IDEA also detects which directory to mark as a source root.

    Note that IntelliJ IDEA searches for the generated sources only in target/generated-sources and target/generated-sources/* directories.

  • target/generated-sources This option enables you to mark the directory as a source root manually.

  • subdirectories of "target/generated-sources" This option enables you to mark a subdirectory as a source root manually.

Phase to be used for folders update

Select Maven phase to be used for folders update. This might be useful if you adjust your plugins so that the additional sources are loaded at some phase.

Automatically download

Specify the automatic download of sources and documentation comments into a local repository when you open a Maven project.
You can select one or both of the following checkboxes:
  • Sources

  • Documentation

Dependency types

Use this field to specify dependency types that you want to include in your import.

Environment settings

Click this button to specify Maven Environment settings.

Last modified: 20 November 2018

See Also