Right-click on the module, select "Add framework support...", and check the "Maven" technology.

(This also creates a pom.xml for you to modify.)

If you mean adding source repository elements, I think you need to do that manuallyโ€“not sure.

Pre-IntelliJ 13 this won't convert the project to the Maven Standard Directory Layout, 13+ it will.

Answer from Dave Newton on Stack Overflow
๐ŸŒ
JetBrains
jetbrains.com โ€บ help โ€บ idea โ€บ maven-support.html
Maven | IntelliJ IDEA Documentation
IntelliJ IDEA supports a fully functional integration with Maven that helps you automate your building process. You can create a new Maven project, open and sync an existing one, add a Maven support to any existing IntelliJ IDEA project, configure and manage a multi-module project.
๐ŸŒ
JetBrains
jetbrains.com โ€บ help โ€บ idea โ€บ convert-a-regular-project-into-a-maven-project.html
Add Maven support to an existing Java project | IntelliJ IDEA Documentation
Let's create and executable JAR to conclude our tutorial. From the main menu, select Build | Build Project () to build project. IntelliJ IDEA generates target folder. Note that IntelliJ IDEA only compiles sources and doesn't create either a .jar ...
Discussions

IntelliJ - Convert a Java project/module into a Maven project/module - Stack Overflow
Is there a way to have IntelliJ just generate a basic empty pom.xml for me, with a name and an artifactId and a repository? Or, is there a way to import the project as a Maven project in the first place? (Whenever I try to create a project from existing source, it only gives me the option of ... More on stackoverflow.com
๐ŸŒ stackoverflow.com
java - How do you "Mavenize" a project using Intellij? - Stack Overflow
I have seen many posts about using eclipse to Mavenize a project. Is there a easy way to do that in IntelliJ? From what I understand about "Mavenize", it's just add some xml in pom.xml and the directory structure is in src/main/java, src/main/test .... ... Essentially, just right-click on the folder. In this example, it's called StackOverFlow and choose Add Framework Support and then check the Maven box. Please note, that this option only exists when you have created ... More on stackoverflow.com
๐ŸŒ stackoverflow.com
Can't add Maven support to existing project
Can you share the errors you mentioned encountering? I have not run into any issues with IntelliJ and Maven. More on reddit.com
๐ŸŒ r/IntelliJIDEA
9
4
June 18, 2025
creating new maven managed git controled project using intellij - Stack Overflow
I got an empty repository hosted externally. I now want to locally create a intellij/maven managed java project which is source controled by that origin. I tried: 1>check out from source contr... More on stackoverflow.com
๐ŸŒ stackoverflow.com
๐ŸŒ
JetBrains
jetbrains.com โ€บ guide โ€บ java โ€บ tutorials โ€บ working-with-maven โ€บ creating-a-project
Creating a Maven project - JetBrains Guide
February 17, 2023 - Let's create a brand-new Maven project. From the Welcome Screen select New Project, or if you already have an IntelliJ IDEA project open, select File -> New -> Project...
๐ŸŒ
JetBrains
jetbrains.com โ€บ guide โ€บ java โ€บ tutorials โ€บ working-with-maven โ€บ importing-a-project
Importing a Maven project - JetBrains Guide
February 17, 2023 - However, if you know the project, and you believe the code and the dependencies it downloads are safe, select Trust Project. IntelliJ IDEA will use the Maven definition to figure out the structure of the application, and of course download all the required dependencies and add them to the project.
๐ŸŒ
GeeksforGeeks
geeksforgeeks.org โ€บ java โ€บ how-to-create-a-maven-project-in-intellij-idea
Creating a Maven Project in IntelliJ IDEA - GeeksforGeeks
To create a simple Maven project ... a new project in IntelliJ. ... Step 2: We can also create project from existing ongoing project with the New> project option....
Published ย  January 9, 2026
๐ŸŒ
HowToDoInJava
howtodoinjava.com โ€บ home โ€บ maven โ€บ guide to maven projects in intellij ide
Guide to Maven Projects in IntelliJ IDE
July 11, 2023 - At this step, we also need to select ... the folder structure according to the selected archetype. Press the create button and the project will be created in the workspace. Sometimes, we may have a Maven project previously developed in other IDEs such as Eclipse. We can convert it to the IntelliJ project using ...
Find elsewhere
๐ŸŒ
Quora
quora.com โ€บ How-do-you-build-an-existing-Maven-project-in-IntelliJ
How to build an existing Maven project in IntelliJ - Quora
Answer: Maven - IntelliJ In IntelliJ IDEA - Using New Project Wizard you will be able to import existing Maven project. By following below step: Select Menu > New > Project Option or Hit [code ]Ctrl+Shift+A[/code] and Search for the Project from Existing Sources action. Please refer to Intell...
๐ŸŒ
Reddit
reddit.com โ€บ r/intellijidea โ€บ can't add maven support to existing project
r/IntelliJIDEA on Reddit: Can't add Maven support to existing project
June 18, 2025 -

The title pretty much sums up the issue but I will provide more context here. I am self learning Java so the error could be on me but I can't seem to get IntelliJ to do this.

I have a simple console application that I built and my next step in learning was to add Maven support (not suggested by me). I followed the instructions in the docs to a T but it seems to fail on step 5. Here is step 5:

"IntelliJ IDEA detects a Maven build script and displays a notification suggesting to load a Maven project. Click Load Maven Project. IntelliJ IDEA adds a default POM to the project and generates the standard Maven layout in Project tool window."

I've created the pom.xml file and clicked 'Load Maven Project' on the rare occasions that the button does pop up but I get nothing. It does not generate the standard Maven layout and I run into all kinds of errors when I try to do that manually.

Has anyone else ran into this? I am on version 2025.1.2 on IntelliJ btw.

EDIT: Turns out manually adding the project file structure was a skill issue on my part. I did not correctly import my files with the new files.

IntelliJ still does not automatically create the project structure as stated in their docs though.

Top answer
1 of 1
5

The key is how IDEA prompts you after checking out code. There are two similar messages:

  1. "Would you like to create an IDEA project for the sources you have checked out? or
  2. "You have checked out an IntelliJ IDEA project file: {path}/pom.xml Would you like to open it?

If the first one is shown (which it appears it was for you), then IDEA will create a project from the sources and not from the maven POM. In the event of the second one, it will create it from the pom and your IDEA project will be linked to the maven POM. Even so, I personally like to select No to the auto create dialog. The reason is that when selecting yes, it opens the project immediately. Doing the below runs through a couple of configuration dialogs and gives me a bit more flexibility in how I set things up.

In general, the following sequence works for either of the above:

  1. Check out from source control
  2. Select No to the "Do you want to create a project" dialog.
  3. File > Import Project
    • not to be confused with New Project
  4. In the file chooser dialog, select the root pom.xml POM in the check out location from step #1
  5. Configure your maven project via the dialogs

If your initial checkout does not have a POM, you need to do the following to create a maven linked IDEA project:

  1. Check out from source control
  2. Select No to the "Do you want to create a project" dialog.
  3. File > New Project
  4. In the New Project dialog:
    1. Select "Maven" in the "Java" section of the project types
    2. Set the "Project Name"
    3. Set the "Project Location" value to the root directory of the project you checked out.
    4. Click Next
    5. Set your maven coordinates for your new project
    6. Select an archetype if you do not want to create a standard Java JAR project
    7. Click Finish
  5. Optionally, go to Project > Settings > [Project Settings] > Maven and tweak any configurations
  6. Add the pom file to VCS via the context menu or the VCS menu
  7. Edit your POM and start coding
๐ŸŒ
Mkyong
mkyong.com โ€บ home โ€บ intellij โ€บ convert a java project to maven project in intellij idea
Convert a Java project to Maven project in IntelliJ IDEA - Mkyong.com
May 24, 2021 - Right clicks on the project name, clicks Add Framework Support..., and then selects Maven. 3.1 The IntelliJ IDEA will generate a default pom.xml and configure the project to support Maven.
๐ŸŒ
JetBrains
jetbrains.com โ€บ help โ€บ idea โ€บ delegate-build-and-run-actions-to-maven.html
Maven projects | IntelliJ IDEA Documentation
In the Project tool window, right-click a directory where you want to create a file. In the context menu, select New | File. In the dialog that opens, enter a name of the file (maven.config or jvm.config) and click OK.
๐ŸŒ
Medium
medium.com โ€บ java-mvp โ€บ java-guide-setting-up-and-running-an-existing-maven-project-in-intellij-ecc081759ae4
Java Guide: Setting Up and Running an Existing Maven Project in IntelliJ | by datatec.studio | Java MVP | Medium
October 8, 2023 - In my github repository, i have prepared a very simple java project in maven. If you not use github and just wanna know how to setting up an unzipped Project, you will also find the answer here. This article shows how to setup IntelliJ to build and run this project on MacOS, also the JUnit Test will be executed when everything prepared.
๐ŸŒ
Medium
medium.com โ€บ @iamfaisalkhatri โ€บ what-is-maven-and-how-to-create-maven-project-using-intellij-6c1924edba04
What is Maven and how to create Maven Project using IntelliJ? | by Mohammad Faisal Khatri | Medium
December 9, 2024 - Congratulations, we have created the Maven Project successfully using IntelliJ. ... Maven automatically creates the project structure for you. Hence you donโ€™t have to worry about organizing your project folders.
๐ŸŒ
Stack Overflow
stackoverflow.com โ€บ questions โ€บ 67226639 โ€บ how-to-configure-new-maven-project-in-intellij-idea
java - How to configure new Maven project in IntelliJ IDEA? - Stack Overflow
My answer assumes that official documentation doesn't work and you have a valid Maven project. You will need to do one of these 2 actions. Mark your folder as Source/Test Source Root, the same applies to the Source/Test Source resources folder. Another solution, modify the *.iml file (not recommended): Both solutions will work independently of OS and IntelliJ IDEA versions.
๐ŸŒ
javathinking
javathinking.com โ€บ blog โ€บ how-do-you-mavenize-a-project-using-intellij
How to Mavenize a Project in IntelliJ: Step-by-Step Guide to Setting Up Directory Structure & pom.xml โ€” javathinking.com
Maven enforces a standard directory layout, which ensures consistency across projects. This "convention-over-configuration" approach reduces setup time and makes projects easier to maintain. Hereโ€™s the structure IntelliJ generates (or that youโ€™ll need to manually create for existing projects):
๐ŸŒ
Applitools
testautomationu.applitools.com โ€บ intellij โ€บ chapter2.3.html
Chapter 2.3 - Importing project from existing sources
We can select from the locations that we have, or we can just directly type the location of the project we want to import into IntelliJ. Once we do that, we can just click the OK button. A new screen appears where we are asked what we want to do โ€” Create project from existing sources or Import the project from an external model. If you have a Maven project as I have in this example, it is good to choose the Import project from external model because that way, the project will be automatically imported as a Maven project with all of its proper setup being done.
๐ŸŒ
TutorialsPoint
tutorialspoint.com โ€บ maven โ€บ maven_intellij_idea.htm
Maven - IntelliJ IDEA IDE Integration
Following example will help you to leverage benefits of integrating IntelliJ IDEA and Maven. We will import Maven project using New Project Wizard. Open IntelliJ IDEA. Select File Menu > New Project Option. Select import project from existing model.