See Also
Some features described here are available in Ultimate edition only.

File | New Module
From the Project tool window: select a module folder, then New | Module in the context or main menu
From the Project Structure dialog: Modules | add | New Module

Specify what you are going to use your module for by selecting the necessary option in the selector pane (in the left-hand part of the page). Specify the associated settings in the right-hand part of the page (the module name, location, etc.).

The available options, roughly, correspond to module types and, as a rule, name a platform or runtime that the module is intended for (Java, Android, Flash, etc.).

Note that the set of options you can select from depends on which plugins are currently enabled in IntelliJ IDEA.

Selector pane

Use the selector pane (located in the left-hand part of the page) to select the necessary option (e.g. the module type to be created).

To check if the selected option is the one you want, read its description (shown in the right-hand part of the page under Description).

Java: Java Module

Select this option if you are going to use your new module to develop a Java application.

ItemDescription
Module name Specify the module name.
Content root Specify the path to the module content root folder. (This is where all the files that make up you module will be stored; for more information, see Content Root.)

By default, a folder having the same name as the module is created in the project directory (recommended).

To use a different folder, click browseButton (Shift+Enter) and select the necessary folder in the dialog that opens. (You can create a new folder in that dialog, e.g. by using icon_newFolder.)

Module file location Specify the path to the folder where the .iml module file should be created.

By default, this file is created in the module content root folder (recommended).

To use a different folder, click browseButton (Shift+Enter) and select the necessary folder in the dialog that opens. (You can create a new folder in that dialog, e.g. by using icon_newFolder.)

Module SDK If IntelliJ IDEA can guess which SDK you are likely to use in your module, the controls for specifying the module SDK are not provided. This may be the case when an SDK of the appropriate type is defined as the project SDK, or there is already a module in you project where an appropriate SDK is used, etc.

Otherwise, you can specify the SDK to be used in your module.

If the necessary SDK is already defined in IntelliJ IDEA, select it from the list.

Otherwise, click New and select the SDK type. (It's likely that it's the JDK option that you want at the moment.) Then, in the dialog that opens, select the installation folder of the desired SDK. (By this time, the corresponding SDK must already be installed on your computer. If it isn't, download and install it first.)

More Settings Click the arrow (arrow_right_show_settings or arrow_down_hide_settings) to show or hide additional settings (discussed below).
Create source root Select the check box to create a directory for your source code.

By default, the src directory is created in the module content root folder (recommended).

If you want this directory to have a different name, edit the text in the field.

To specify a different directory, click browseButton (Shift+Enter) and select the directory in the dialog that opens. (You can create a new directory in that dialog, e.g. by using icon_newFolder.)

Java: IntelliJ Platform Plugin

Select this option if you are going to use your new module to develop a plugin for IntelliJ IDEA or other IntelliJ Platform-based IDE.

ItemDescription
Module name Specify the module name.
Content root Specify the path to the module content root folder. (This is where all the files that make up you module will be stored; for more information, see Content Root.)

By default, a folder having the same name as the module is created in the project directory (recommended).

To use a different folder, click browseButton (Shift+Enter) and select the necessary folder in the dialog that opens. (You can create a new folder in that dialog, e.g. by using icon_newFolder.)

Module file location Specify the path to the folder where the .iml module file should be created.

By default, this file is created in the module content root folder (recommended).

To use a different folder, click browseButton (Shift+Enter) and select the necessary folder in the dialog that opens. (You can create a new folder in that dialog, e.g. by using icon_newFolder.)

Module SDK If IntelliJ IDEA can guess which SDK you are likely to use in your module, the controls for specifying the module SDK are not provided. This may be the case when an SDK of the appropriate type is defined as the project SDK, or there is already a module in you project where an appropriate SDK is used, etc.

Otherwise, you can specify the SDK to be used in your module.

If the necessary SDK is already defined in IntelliJ IDEA, select it from the list.

Otherwise, click New and, in the dialog that opens, select the installation folder of the desired IntelliJ IDEA version. (An IntelliJ IDEA installation acts as an IntelliJ IDEA Plugin SDK.) (By this time, the corresponding IntelliJ IDEA version must already be installed on your computer. If it isn't, download and install it first.)

More Settings Click the arrow (arrow_right_show_settings or arrow_down_hide_settings) to show or hide additional settings (discussed below).
Create source root Select the check box to create a directory for your source code.

By default, the src directory is created in the module content root folder (recommended).

If you want this directory to have a different name, edit the text in the field.

To specify a different directory, click browseButton (Shift+Enter) and select the directory in the dialog that opens. (You can create a new directory in that dialog, e.g. by using icon_newFolder.)

Java: J2ME Module

Select this option if you are going to use your new module to develop for Java ME.

ItemDescription
Module name Specify the module name.
Content root Specify the path to the module content root folder. (This is where all the files that make up you module will be stored; for more information, see Content Root.)

By default, a folder having the same name as the module is created in the project directory (recommended).

To use a different folder, click browseButton (Shift+Enter) and select the necessary folder in the dialog that opens. (You can create a new folder in that dialog, e.g. by using icon_newFolder.)

Module file location Specify the path to the folder where the .iml module file should be created.

By default, this file is created in the module content root folder (recommended).

To use a different folder, click browseButton (Shift+Enter) and select the necessary folder in the dialog that opens. (You can create a new folder in that dialog, e.g. by using icon_newFolder.)

Module SDK If IntelliJ IDEA can guess which SDK you are likely to use in your module, the controls for specifying the module SDK are not provided. This may be the case when an SDK of the appropriate type is defined as the project SDK, or there is already a module in you project where an appropriate SDK is used, etc.

Otherwise, you can specify the SDK to be used in your module.

If the necessary SDK is already defined in IntelliJ IDEA, select it from the list.

Otherwise, click New and, in the dialog that opens, select the installation folder of the desired Java ME SDK. (By this time, the corresponding SDK must already be installed on your computer. If it isn't, download and install it first.)

More Settings Click the arrow (arrow_right_show_settings or arrow_down_hide_settings) to show or hide additional settings (discussed below).
Create source root Select the check box to create a directory for your source code.

By default, the src directory is created in the module content root folder (recommended).

If you want this directory to have a different name, edit the text in the field.

To specify a different directory, click browseButton (Shift+Enter) and select the directory in the dialog that opens. (You can create a new directory in that dialog, e.g. by using icon_newFolder.)

Java: Maven Module

Select this option if you are going to use your new module to develop a Java application with dependencies managed by Maven.

ItemDescription
Module name Specify the module name.
Content root Specify the path to the module content root folder. (This is where all the files that make up you module will be stored; for more information, see Content Root.)

By default, a folder having the same name as the module is created in the project directory (recommended).

To use a different folder, click browseButton (Shift+Enter) and select the necessary folder in the dialog that opens. (You can create a new folder in that dialog, e.g. by using icon_newFolder.)

Module file location Specify the path to the folder where the .iml module file should be created.

By default, this file is created in the module content root folder (recommended).

To use a different folder, click browseButton (Shift+Enter) and select the necessary folder in the dialog that opens. (You can create a new folder in that dialog, e.g. by using icon_newFolder.)

Module SDK If IntelliJ IDEA can guess which SDK you are likely to use in your module, the controls for specifying the module SDK are not provided. This may be the case when an SDK of the appropriate type is defined as the project SDK, or there is already a module in you project where an appropriate SDK is used, etc.

Otherwise, you can specify the SDK to be used in your module.

If the necessary SDK is already defined in IntelliJ IDEA, select it from the list.

Otherwise, click New and, in the dialog that opens, select the installation folder of the desired Java SDK. (By this time, the corresponding SDK must already be installed on your computer. If it isn't, download and install it first.)

Java: Command Line App

Select this option if you are going to use your new module to develop a Java application.

IntelliJ IDEA will create a Java module. The module will contain a class with a main() method. You'll be able to run this class right away.

ItemDescription
Module name Specify the module name.
Content root Specify the path to the module content root folder. (This is where all the files that make up you module will be stored; for more information, see Content Root.)

By default, a folder having the same name as the module is created in the project directory (recommended).

To use a different folder, click browseButton (Shift+Enter) and select the necessary folder in the dialog that opens. (You can create a new folder in that dialog, e.g. by using icon_newFolder.)

Module file location Specify the path to the folder where the .iml module file should be created.

By default, this file is created in the module content root folder (recommended).

To use a different folder, click browseButton (Shift+Enter) and select the necessary folder in the dialog that opens. (You can create a new folder in that dialog, e.g. by using icon_newFolder.)

Module SDK If IntelliJ IDEA can guess which SDK you are likely to use in your module, the controls for specifying the module SDK are not provided. This may be the case when an SDK of the appropriate type is defined as the project SDK, or there is already a module in you project where an appropriate SDK is used, etc.

Otherwise, you can specify the SDK to be used in your module.

If the necessary SDK is already defined in IntelliJ IDEA, select it from the list.

Otherwise, click New and select the SDK type. (It's likely that it's the JDK option that you want at the moment.) Then, in the dialog that opens, select the installation folder of the desired SDK. (By this time, the corresponding SDK must already be installed on your computer. If it isn't, download and install it first.)

Groovy: Groovy Module

Select this option if you are going to develop a Groovy application.

ItemDescription
Module name Specify the module name.
Content root Specify the path to the module content root folder. (This is where all the files that make up you module will be stored; for more information, see Content Root.)

By default, a folder having the same name as the module is created in the project directory (recommended).

To use a different folder, click browseButton (Shift+Enter) and select the necessary folder in the dialog that opens. (You can create a new folder in that dialog, e.g. by using icon_newFolder.)

Module file location Specify the path to the folder where the .iml module file should be created.

By default, this file is created in the module content root folder (recommended).

To use a different folder, click browseButton (Shift+Enter) and select the necessary folder in the dialog that opens. (You can create a new folder in that dialog, e.g. by using icon_newFolder.)

Module SDK If IntelliJ IDEA can guess which SDK you are likely to use in your module, the controls for specifying the module SDK are not provided. This may be the case when an SDK of the appropriate type is defined as the project SDK, or there is already a module in you project where an appropriate SDK is used, etc.

Otherwise, you can specify the SDK to be used in your module.

If the necessary SDK is already defined in IntelliJ IDEA, select it from the list.

Otherwise, click New and select the SDK type. (It's likely that it's the JDK option that you want at the moment.) Then, in the dialog that opens, select the installation folder of the desired SDK. (By this time, the corresponding SDK must already be installed on your computer. If it isn't, download and install it first.)

More Settings Click the arrow (arrow_right_show_settings or arrow_down_hide_settings) to show or hide additional settings (discussed below).
Create source root Select the check box to create a directory for your source code.

By default, the src directory is created in the module content root folder (recommended).

If you want this directory to have a different name, edit the text in the field.

To specify a different directory, click browseButton (Shift+Enter) and select the directory in the dialog that opens. (You can create a new directory in that dialog, e.g. by using icon_newFolder.)

Groovy: Grails Module

Select this option if you are going to use your new module to develop a Grails application.

ItemDescription
Module name Specify the module name.
Content root Specify the path to the module content root folder. (This is where all the files that make up you module will be stored; for more information, see Content Root.)

By default, a folder having the same name as the module is created in the project directory (recommended).

To use a different folder, click browseButton (Shift+Enter) and select the necessary folder in the dialog that opens. (You can create a new folder in that dialog, e.g. by using icon_newFolder.)

Module file location Specify the path to the folder where the .iml module file should be created.

By default, this file is created in the module content root folder (recommended).

To use a different folder, click browseButton (Shift+Enter) and select the necessary folder in the dialog that opens. (You can create a new folder in that dialog, e.g. by using icon_newFolder.)

Module SDK If IntelliJ IDEA can guess which SDK you are likely to use in your module, the controls for specifying the module SDK are not provided. This may be the case when an SDK of the appropriate type is defined as the project SDK, or there is already a module in you project where an appropriate SDK is used, etc.

Otherwise, you can specify the SDK to be used in your module.

If the necessary SDK is already defined in IntelliJ IDEA, select it from the list.

Otherwise, click New and select the SDK type. (It's likely that it's the JDK option that you want at the moment.) Then, in the dialog that opens, select the installation folder of the desired SDK. (By this time, the corresponding SDK must already be installed on your computer. If it isn't, download and install it first.)

Groovy: Griffon Module

Select this option if you are going to use your new module to develop a Griffon application.

ItemDescription
Module name Specify the module name.
Content root Specify the path to the module content root folder. (This is where all the files that make up you module will be stored; for more information, see Content Root.)

By default, a folder having the same name as the module is created in the project directory (recommended).

To use a different folder, click browseButton (Shift+Enter) and select the necessary folder in the dialog that opens. (You can create a new folder in that dialog, e.g. by using icon_newFolder.)

Module file location Specify the path to the folder where the .iml module file should be created.

By default, this file is created in the module content root folder (recommended).

To use a different folder, click browseButton (Shift+Enter) and select the necessary folder in the dialog that opens. (You can create a new folder in that dialog, e.g. by using icon_newFolder.)

Module SDK If IntelliJ IDEA can guess which SDK you are likely to use in your module, the controls for specifying the module SDK are not provided. This may be the case when an SDK of the appropriate type is defined as the project SDK, or there is already a module in you project where an appropriate SDK is used, etc.

Otherwise, you can specify the SDK to be used in your module.

If the necessary SDK is already defined in IntelliJ IDEA, select it from the list.

Otherwise, click New and select the SDK type. (It's likely that it's the JDK option that you want at the moment.) Then, in the dialog that opens, select the installation folder of the desired SDK. (By this time, the corresponding SDK must already be installed on your computer. If it isn't, download and install it first.)

Java Enterprise: JavaEE Web Module

Select this option if you are going to use your new module to develop a Java Web application.

In addition to what you normally get for a Java module, IntelliJ IDEA will create:

  • web\WEB-INF\web.xml (the deployment descriptor file).
  • web\index.jsp (a file which, with minor modifications, you can use as a starting page of your Web application).
  • An artifact specification for your Web application.
ItemDescription
Module name Specify the module name.
Content root Specify the path to the module content root folder. (This is where all the files that make up you module will be stored; for more information, see Content Root.)

By default, a folder having the same name as the module is created in the project directory (recommended).

To use a different folder, click browseButton (Shift+Enter) and select the necessary folder in the dialog that opens. (You can create a new folder in that dialog, e.g. by using icon_newFolder.)

Module file location Specify the path to the folder where the .iml module file should be created.

By default, this file is created in the module content root folder (recommended).

To use a different folder, click browseButton (Shift+Enter) and select the necessary folder in the dialog that opens. (You can create a new folder in that dialog, e.g. by using icon_newFolder.)

Module SDK If IntelliJ IDEA can guess which SDK you are likely to use in your module, the controls for specifying the module SDK are not provided. This may be the case when an SDK of the appropriate type is defined as the project SDK, or there is already a module in you project where an appropriate SDK is used, etc.

Otherwise, you can specify the SDK to be used in your module.

If the necessary SDK is already defined in IntelliJ IDEA, select it from the list.

Otherwise, click New and select the SDK type. (It's likely that it's the JDK option that you want at the moment.) Then, in the dialog that opens, select the installation folder of the desired SDK. (By this time, the corresponding SDK must already be installed on your computer. If it isn't, download and install it first.)

Android: Application Module

Select this option if you are going to use your new module to develop an application for the Android OS.

ItemDescription
Module name Specify the module name.
Content root Specify the path to the module content root folder. (This is where all the files that make up you module will be stored; for more information, see Content Root.)

By default, a folder having the same name as the module is created in the project directory (recommended).

To use a different folder, click browseButton (Shift+Enter) and select the necessary folder in the dialog that opens. (You can create a new folder in that dialog, e.g. by using icon_newFolder.)

Module file location Specify the path to the folder where the .iml module file should be created.

By default, this file is created in the module content root folder (recommended).

To use a different folder, click browseButton (Shift+Enter) and select the necessary folder in the dialog that opens. (You can create a new folder in that dialog, e.g. by using icon_newFolder.)

Module SDK If IntelliJ IDEA can guess which SDK you are likely to use in your module, the controls for specifying the module SDK are not provided. This may be the case when an SDK of the appropriate type is defined as the project SDK, or there is already a module in you project where an appropriate SDK is used, etc.

Otherwise, you can specify the SDK to be used in your module.

If the necessary SDK is already defined in IntelliJ IDEA, select it from the list.

Otherwise, click New and, in the dialog that opens, select the installation folder of the desired Android SDK. (By this time, the corresponding SDK must already be installed on your computer. If it isn't, download and install it first.)

Android: Empty Module

Select this option if you are going to use your new module to develop for Android but haven't decided yet whether this module will implement an application or a shared Android library.

ItemDescription
Module name Specify the module name.
Content root Specify the path to the module content root folder. (This is where all the files that make up you module will be stored; for more information, see Content Root.)

By default, a folder having the same name as the module is created in the project directory (recommended).

To use a different folder, click browseButton (Shift+Enter) and select the necessary folder in the dialog that opens. (You can create a new folder in that dialog, e.g. by using icon_newFolder.)

Module file location Specify the path to the folder where the .iml module file should be created.

By default, this file is created in the module content root folder (recommended).

To use a different folder, click browseButton (Shift+Enter) and select the necessary folder in the dialog that opens. (You can create a new folder in that dialog, e.g. by using icon_newFolder.)

Module SDK If IntelliJ IDEA can guess which SDK you are likely to use in your module, the controls for specifying the module SDK are not provided. This may be the case when an SDK of the appropriate type is defined as the project SDK, or there is already a module in you project where an appropriate SDK is used, etc.

Otherwise, you can specify the SDK to be used in your module.

If the necessary SDK is already defined in IntelliJ IDEA, select it from the list.

Otherwise, click New and, in the dialog that opens, select the installation folder of the desired Android SDK. (By this time, the corresponding SDK must already be installed on your computer. If it isn't, download and install it first.)

More Settings Click the arrow (arrow_right_show_settings or arrow_down_hide_settings) to show or hide additional settings (discussed below).
Create source root Select the check box to create a directory for your source code.

By default, the src directory is created in the module content root folder (recommended).

If you want this directory to have a different name, edit the text in the field.

To specify a different directory, click browseButton (Shift+Enter) and select the directory in the dialog that opens. (You can create a new directory in that dialog, e.g. by using icon_newFolder.)

Android: Library Module

Select this option if you are going to create an Android library module, one that contains shared source code and resources that can be referenced in other Android modules (e.g. used in a number of your Android applications).

ItemDescription
Module name Specify the module name.
Content root Specify the path to the module content root folder. (This is where all the files that make up you module will be stored; for more information, see Content Root.)

By default, a folder having the same name as the module is created in the project directory (recommended).

To use a different folder, click browseButton (Shift+Enter) and select the necessary folder in the dialog that opens. (You can create a new folder in that dialog, e.g. by using icon_newFolder.)

Module file location Specify the path to the folder where the .iml module file should be created.

By default, this file is created in the module content root folder (recommended).

To use a different folder, click browseButton (Shift+Enter) and select the necessary folder in the dialog that opens. (You can create a new folder in that dialog, e.g. by using icon_newFolder.)

Module SDK If IntelliJ IDEA can guess which SDK you are likely to use in your module, the controls for specifying the module SDK are not provided. This may be the case when an SDK of the appropriate type is defined as the project SDK, or there is already a module in you project where an appropriate SDK is used, etc.

Otherwise, you can specify the SDK to be used in your module.

If the necessary SDK is already defined in IntelliJ IDEA, select it from the list.

Otherwise, click New and, in the dialog that opens, select the installation folder of the desired Android SDK. (By this time, the corresponding SDK must already be installed on your computer. If it isn't, download and install it first.)

Package name Specify the package name for your module. Note that it's a Java package name that is specified here. For more information, see, for example, Android package name and Naming a package.

Android: Test Module

Select this option if you are going to use your new module to develop tests for your Android application (represented by an Android application module). See the documentation for the Android testing framework used.

ItemDescription
Module name Specify the module name.
Content root Specify the path to the module content root folder. (This is where all the files that make up you module will be stored; for more information, see Content Root.)

By default, a folder having the same name as the module is created in the project directory (recommended).

To use a different folder, click browseButton (Shift+Enter) and select the necessary folder in the dialog that opens. (You can create a new folder in that dialog, e.g. by using icon_newFolder.)

Module file location Specify the path to the folder where the .iml module file should be created.

By default, this file is created in the module content root folder (recommended).

To use a different folder, click browseButton (Shift+Enter) and select the necessary folder in the dialog that opens. (You can create a new folder in that dialog, e.g. by using icon_newFolder.)

Module SDK If IntelliJ IDEA can guess which SDK you are likely to use in your module, the controls for specifying the module SDK are not provided. This may be the case when an SDK of the appropriate type is defined as the project SDK, or there is already a module in you project where an appropriate SDK is used, etc.

Otherwise, you can specify the SDK to be used in your module.

If the necessary SDK is already defined in IntelliJ IDEA, select it from the list.

Otherwise, click New and, in the dialog that opens, select the installation folder of the desired Android SDK. (By this time, the corresponding SDK must already be installed on your computer. If it isn't, download and install it first.)

Tested module Select the module to be tested. This may be any Android Application module in the same project.

Other: Flash Module

Select this option if you are going to develop for the Adobe Flash runtimes using Flex or ActionScript.

ItemDescription
Module name Specify the module name.
Content root Specify the path to the module content root folder. (This is where all the files that make up you module will be stored; for more information, see Content Root.)

By default, a folder having the same name as the module is created in the project directory (recommended).

To use a different folder, click browseButton (Shift+Enter) and select the necessary folder in the dialog that opens. (You can create a new folder in that dialog, e.g. by using icon_newFolder.)

Module file location Specify the path to the folder where the .iml module file should be created.

By default, this file is created in the module content root folder (recommended).

To use a different folder, click browseButton (Shift+Enter) and select the necessary folder in the dialog that opens. (You can create a new folder in that dialog, e.g. by using icon_newFolder.)

Other: Web Module

Select this option if you are going to develop a Web application using HTML/CSS, JavaScript, PHP and related frameworks.

Note that a Web module cannot be used for developing in Java.

ItemDescription
Module name Specify the module name.
Content root Specify the path to the module content root folder. (This is where all the files that make up you module will be stored; for more information, see Content Root.)

By default, a folder having the same name as the module is created in the project directory (recommended).

To use a different folder, click browseButton (Shift+Enter) and select the necessary folder in the dialog that opens. (You can create a new folder in that dialog, e.g. by using icon_newFolder.)

Module file location Specify the path to the folder where the .iml module file should be created.

By default, this file is created in the module content root folder (recommended).

To use a different folder, click browseButton (Shift+Enter) and select the necessary folder in the dialog that opens. (You can create a new folder in that dialog, e.g. by using icon_newFolder.)

Samples Gallery: Java Hello World

If you select this option, IntelliJ IDEA will create a Java module. The module will contain a class implementing a Hello World application. You'll be able to run this application right away.

ItemDescription
Module name Specify the module name.
Content root Specify the path to the module content root folder. (This is where all the files that make up you module will be stored; for more information, see Content Root.)

By default, a folder having the same name as the module is created in the project directory (recommended).

To use a different folder, click browseButton (Shift+Enter) and select the necessary folder in the dialog that opens. (You can create a new folder in that dialog, e.g. by using icon_newFolder.)

Module file location Specify the path to the folder where the .iml module file should be created.

By default, this file is created in the module content root folder (recommended).

To use a different folder, click browseButton (Shift+Enter) and select the necessary folder in the dialog that opens. (You can create a new folder in that dialog, e.g. by using icon_newFolder.)

Module SDK If IntelliJ IDEA can guess which SDK you are likely to use in your module, the controls for specifying the module SDK are not provided. This may be the case when an SDK of the appropriate type is defined as the project SDK, or there is already a module in you project where an appropriate SDK is used, etc.

Otherwise, you can specify the SDK to be used in your module.

If the necessary SDK is already defined in IntelliJ IDEA, select it from the list.

Otherwise, click New and select the SDK type. (It's likely that it's the JDK option that you want at the moment.) Then, in the dialog that opens, select the installation folder of the desired SDK. (By this time, the corresponding SDK must already be installed on your computer. If it isn't, download and install it first.)

See Also

Concepts:

Web Resources: