IntelliJ IDEA 2019.2 Help

Maven Tool Window

View | Tool Windows | Maven

This tool window is marked with the icon Maven logo.

Use the Maven tool window to view the available Maven projects, download sources and Javadocs, and execute phases of the build lifecycle. The tool window displays nodes for each Maven project, with the Lifecycle, Plugins subnodes. If at least one of the pom.xml files contains profile definition, the Profiles node is added to the tool window. This node contains all profiles defined in the Maven projects. The Maven tool window also displays the Dependencies node if dependencies are added to your project.

Toolbar Buttons

Item

Description

Reimport All Maven Projects

Click this button to synchronize all Maven projects with the IntelliJ IDEA project. See Importing tab of the Maven Integration dialog.

Generate Sources and Update Folders for All Projects Click this button to launch Maven goals for generating sources and resources for the source and test directories, and read the resulting directory structure. According to the results of such generation, the IntelliJ IDEA folders are properly marked as the source or test roots.

See import settings.

Download Sources and/or Documentation

Click this button to download missing sources and documentation. Select the desired download option from the submenu.
You can set up automatic downloading of sources and documentation at the Importing page of the Maven Integration dialog.

Add Maven Project

Click this button to add a Maven project. Select the desired pom.xml file in the dialog that opens.

Run Maven Build

Click this button to execute the selected phase of the build lifecycle or a plugin goal. If several goals are selected, they will be executed in the same order as in the tree. Note that by default this button is disabled, to activate it you need to select a build phase or a plugin goal to run.

Execute Maven Goal

Click this button to execute a maven goal using the Run Anything window.

Toggle Offline Mode

Click this button to toggle the offline mode.

Toggle Skip Test Mode

Click this button to turn on the Maven option Skip test mode, and omit running unit tests.

Show Dependencies

Click this button to show the dependencies of the current Maven project in a UML frame.

Collapse All

Click this button to collapse all nodes under the selected Maven project.

Maven Settings

Click this button to configure the settings of the current Maven project in the Maven settings dialog.

Show Options Menu Click this button to show the menu of the show options:
  • Group Modules: select this option to group the nodes by directories.

  • Show Ignored Projects: when this option is selected, the ignored nodes are shown in the tool window with a strikethrough. Otherwise, the ignored nodes are hidden.

  • Show Basic Phases Only: when this option is selected, IntelliJ IDEA shows only the basic build phases; otherwise, the complete list of phases is shown.

  • Always Show ArtifactId: select this option to display the artifactId that is specified in the pom.xml of your Maven project.

  • Show version: when this option is selected, IntelliJ IDEA displays the version of your Maven project that is specified in the pom.xml.

  • Show Toolbar: select this option to show the toolbar for your Maven projects.

  • Pinned, Docked, Floating, Windowed, Split Mode
  • Group Tabs: deselect this option to see the views on separate tabs if more than one view is available in a tool window.

  • Move to: select this option to move the Maven Projects tool window to either top, left or right.

  • Resize: select this option to resize the Maven Projects tool window.

Context Menu Commands of a Lifecycle Phase

Command

Description

Create <project>[phase]

Choose this command to create run/debug configuration for the selected phase of a lifecycle.

Run <project>[phase]

Choose this command to run the selected phase of a lifecycle with the phase-specific run/debug configuration.

Debug <project>[phase]

Choose this command to debug the selected phase of a lifecycle with the phase-specific run/debug configuration.

Execute before Make, Execute after Make

Choose these commands to set triggers for the selected phase of a lifecycle. The Before Make and After Make comments appear next to the name of the node.

Execute before Rebuild, Execute after Rebuild

Choose these commands to set triggers for the selected phase of a lifecycle. In this case Before Rebuild and After Rebuild comments appear next to the name of the node.

Execute before Run/Debug

Choose this command to specify a run/debug configuration, prior to which the selected phase of a lifecycle should be executed. The Before Run comment appears next to the name of the node.

Assign Shortcut

Choose this command to associate the selected phase with a keyboard shortcut. The comment with the shortcut appears next to the name of the node.

Context Menu Commands of a Maven Project

Command

Description

Reimport

Select this option to re-import your Maven project. On invoking this action, IntelliJ IDEA parses the project structure in the Maven tool window.

Ignore Project / Unignore Project

Select the Ignore Project command to ignore project in build. or Unignore Project to include in build the previously ignored project.

In this case, IntelliJ IDEA keeps the ignored Maven projects and modules 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, for example, need to skip an irrelevant subproject.

Edit Ignored Files

This option becomes available if you used the Path patterns field in the Maven settings for entering the files you wanted to exclude from the project's build. Select this option and in the Ignored Files dialog add, change, or delete the patterns.

Remove Projects

Select this option to delete the attached Maven project along with its modules from the Maven structure.

Create / Open 'settings.xml'
Create / Open 'profiles.xml'

Select this option to create settings.xml or profile.xml, or open such file if it has already been created.

Download Sources or/and Documentation

Select one of these options to download missing sources or / and Javadocs.

Show Effective POM

Select this option to generate the effective POM as an XML for this build, with the active profiles and super POM factored in. The effective POM displays the following information:
  • the default project source folders structure

  • the output directory

  • plug-ins required

  • repositories

  • a reporting directory which Maven will be using while executing the desired goals

Show Dependencies / Show Dependencies Popup

Select one of these options to generate the dependencies diagram of the current Maven project in a UML frame

Jump to source

Select this option to open in the editor the pom.xml file for the selected Maven project.

Last modified: 28 August 2019

See Also

Reference:

Concepts: