Maven projects
IntelliJ IDEA lets you manage Maven projects. You can link, ignore projects, synchronize changes in Maven and IntelliJ IDEA projects, and configure the build and run actions.
Navigate to POM
In the Maven tool window, right-click a linked project.
- From the context menu, select Jump to Source F4.
IntelliJ IDEA navigates to the appropriate Maven configuration file, and the related POM opens in the editor.
Ignore a Maven project
You can de-activate a Maven project using the Ignore Projects option. In this case, IntelliJ IDEA keeps the ignored Maven projects and subprojects in the Maven tool window, but stops their import (modules, content roots, goals, and so on) to the project. However, IntelliJ IDEA synchronizes the ignored projects with the current one. It might be helpful if you need to skip an irrelevant subproject.
In the Maven tool window, right-click the project that you want to ignore.
From the context menu, select Ignore Project.
In the window that opens, click Yes if you want to remove the project from the Projects tool window.
If you want to activate your Maven projects or subprojects, select Unignore Projects from the context menu.
Re-import a Maven project
If you select the Import Maven projects automatically option in the Maven settings dialog, then IntelliJ IDEA will re-import the project automatically every time you make changes to the pom.xml file.
However, if you want to control the importing of your project, you can manually trigger the action.
In the Maven tool window, right-click a linked project.
- From the context menu, select Reimport
. On invoking this action, IntelliJ IDEA parses the project structure in the Maven tool window.
IntelliJ IDEA cannot re-import just a part of your project, it re-imports the whole project including subprojects and dependencies.
If you configure a dependency through the Project Structure dialog (click
, from the main menu), the dependency will only appear in the IntelliJ IDEA Project tool window, not in the Maven tool window. Note that the next time you re-import your project, IntelliJ IDEA will remove the added dependency since IntelliJ IDEA considers the Maven configuration as a single source of truth.
Link and unlink a Maven project
You can have multiple Maven projects inside one IntelliJ IDEA project. It might be helpful if you keep parts of code in different projects or have some legacy projects on which you need to work. You can link such projects in IntelliJ IDEA and manage them simultaneously. You can also quickly remove such projects from the Maven structure.
Link a Maven project
to attach a Maven project. Unlink a Maven project
When you unlink a Maven project, IntelliJ IDEA removes all relevant projects and content roots, removes the Maven project from both the Maven tool window and the Project tool window, and stops its synchronization. It might be helpful if you need to fully remove the previously linked Maven project from the current IntelliJ IDEA project.
In the Maven tool window, right-click a linked project.
From the context menu, select Unlink Maven Projects (Delete ). Alternatively, you can select the linked project and click
on the tool window's toolbar.Click OK.
Delegate build and run actions to Maven
By default, IntelliJ IDEA uses the native IntelliJ IDEA builder to build a Maven project. It might be helpful if you have a pure Java or a Kotlin project since IntelliJ IDEA supports the incremental build which significantly speeds up the building process. However, if you have a configuration that changes the compilation on the fly, or your build generates an artifact with a custom layout, then Maven would be preferable for the building process.
Build a project with Maven
Click
in the Maven tool window. Alternatively, from the main menu select . Click Maven and from the list, select Runner.
On the Runner page, select Delegate IDE build/run actions to maven.
Click OK.
From the main menu, select Ctrl+F9. IntelliJ IDEA invokes the appropriate Maven goals.
Click
on the status bar to view the results of the sync in the Build tool window. 
Run and debug with Maven
When the Delegate IDE build/run actions to maven is selected, IntelliJ IDEA runs and debugs your code using Maven. HotSwap is also gets triggered, and the classes are reloaded during a debugging process.
You can use regular run and debug actions as you would in any other projects.
Depending on what action you want to use, from the main menu, select or .
Check the results in the Run tool window or in the Debug tool window if you are debugging your code. For example, when you run the main method Ctrl+Shift+F10 in your Java project, IntelliJ IDEA uses Maven to run the class.
