# Maven tool window

> **TL;DR**
> Required plugins: Maven ([installed](managing-plugins.html) and enabled by default)
>
>
>
> Access: `View | Tool Windows | Maven`

The Maven tool window is enabled automatically when you create or open your Maven project.

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 a [profile](work-with-maven-profiles.html) definition, the Profiles node is added to the tool window. The Maven tool window also displays the Dependencies node if [dependencies](work-with-maven-dependencies.html) are added to your project.

> **Note:**
> If you removed the Maven tool window from the sidebar, select `View | Tool Windows | Maven` from the main menu to reopen it.

## Toolbar Buttons

| Item | Description |
| --- | --- |
|  ![Reimport All Maven Projects](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app-client.expui.general.refresh.svg)  | Click this button to synchronize all Maven projects with the IntelliJ IDEA project. See [Importing tab](maven-importing.html) of the Maven Integration dialog.  |
|  ![Generate Sources and Update Folders for All Projects](https://resources.jetbrains.com.cn/help/img/idea/2026.2/maven.images.expui.build.updateFolders.svg)  |    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](maven-importing.html).     |
|  ![Download Sources and/or Documentation](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app.expui.general.download.svg)  |    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](maven-importing.html) page of the Maven Integration dialog.     |
|  ![Add Maven Project](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app-client.expui.general.add.svg)  | Click this button to add a Maven project. Select the desired `pom.xml` file in the dialog that opens.  |
|  ![Run Maven Build](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app-client.expui.run.run.svg)  | 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](work-with-maven-goals.html) to run.  |
|  ![Execute Maven Goal](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app-client.expui.general.runAnything.svg)  | Click this button to execute a maven goal using the [Run Anything](work-with-maven-goals.html#run_maven_command_line) window.  |
|  ![Toggle Offline Mode](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app-client.expui.build.toggleOfflineMode.svg)  | Click this button to toggle the [offline mode](working-offline.html#maven).  |
|  ![Toggle Skip Test Mode](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app.expui.run.showIgnored.svg)  | Click this button to turn on the Maven option [Skip test mode](work-with-tests-in-maven.html#skip_test), and omit running unit tests.  |
|  ![Analyze Dependencies](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app-client.expui.build.dependencyAnalyzer.svg)  | Click this icon to open the [Dependency Analyzer](work-with-maven-dependencies.html#dependency_analyzer) window.  |
|  ![Show Dependencies](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app-client.expui.fileTypes.diagram.svg)  | Click this button to show the dependencies of the current Maven project in a [UML frame](work-with-maven-dependencies.html#maven_dependency_diagram).  |
|  ![Collapse All](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app-client.expui.general.collapseAll.svg)  | Click this button to collapse all nodes under the selected Maven project. |
|  ![Build Tools Settings](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app-client.expui.general.settings.svg)  |    Use this icon to access the following settings:        * Auto-Reload Setting: select this option to configure the reloading process of your Gradle project in the [Build Tools settings](settings-build-tools.html) dialog.    * Maven Settings: select this option to configure the settings of the current Maven project in the [Maven settings](maven.html) dialog.    |
|  ![Show Options Menu](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app-client.expui.general.moreVertical.svg)  |     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:select this option to display the [ignored projects](delegate-build-and-run-actions-to-maven.html#ignore_maven_project) the tool window. In the Maven tool window, the ignored projects are greyed out. ![Maven tool window: Ignored projects](https://resources.jetbrains.com.cn/help/img/idea/2026.2/ignored_project_maven.png)    * 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: by default, this option is selected and the Maven tool window displays a toolbar with different actions from which you can select. If you don't want to view the toolbar, unselect this option.    * [Pinned Mode, Docked Mode, Floating Mode, Split Mode](project-tool-window.html#viewing_modes)    * 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](work-with-maven-goals.html#run_maven_goal_run_config) 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](work-with-maven-goals.html#debug_goal) of a lifecycle with the phase-specific run/debug configuration.  |
| Execute Before Build | Use this command to [set a trigger](work-with-maven-goals.html#trigger_goal) for the selected goal. When you use this trigger, a goal is executed before you run your project's build (`Build \| Build Project`). The Before Build comment appears next to the name of the node.  |
|  Execute After Build  | Use this command to [set a trigger](work-with-maven-goals.html#trigger_goal) for the selected goal. When you use this trigger, a goal is executed after you run your project's build (`Build \| Build Project`). The After Build comment appears next to the name of the node.  |
| Execute before Rebuild, | Use this command to [set a trigger](work-with-maven-goals.html#trigger_goal) for the selected goal. When you use this trigger, a goal is executed before you run the rebuild action (`Build \| Rebuild Project`). The Before Rebuild comment appears next to the name of the node.  |
| Execute After Rebuild | Use this command to [set a trigger](work-with-maven-goals.html#trigger_goal) for the selected goal. When you use this trigger, a goal is executed after you run the rebuild action (`Build \| Rebuild Project`). The After Rebuild comment appears next to the name of the node.  |
| Execute Before Run/Debug | Choose this command to specify a [run/debug configuration](work-with-maven-goals.html#run_maven_goal_run_config), 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](work-with-maven-goals.html#goal_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 a                             project](delegate-build-and-run-actions-to-maven.html#ignore_maven_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 (they become greyed out), 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](maven-ignored-files.html) 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.  |
| Unlink Maven Projects | Select this option to [detach the Maven                         project](delegate-build-and-run-actions-to-maven.html#unlink_maven_project) along with its modules from the Maven tool window as well as from the [Projects tool window](project-tool-window.html).  |
|    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](http://maven.apache.org/plugins/maven-help-plugin/usage.html#The_help:effective-pom_Goal) 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](work-with-maven-dependencies.html#maven_dependency_diagram)  |
| Jump to source | Select this option to open in the editor the `pom.xml` file for the selected Maven project.  |

## Maven Repositories

When your project is created or imported, IntelliJ IDEA displays [Maven repositories](maven-repositories.html) under the `Repositories` node.

If you need to add the new Maven repository, use `pom.xml`. For more information, refer to the [Maven](https://maven.apache.org/guides/introduction/introduction-to-repositories.html) documentation.

| Item | Description |
| --- | --- |
| local | This is a repository specified on your local machine with the cached jars and dependencies required by your project and other artifacts. |
| central | This is a [central repository](https://repo.maven.apache.org/maven2/) that is available for downloading the dependencies in your Maven project. |

Right-click a repository and select the `Reindex repository` option if you wish to update it.

## See also

### Getting Started

[Tool windows](tool-windows.html)

### Concepts

[Maven](maven-support.html)

### Reference

[Maven](maven.html)