IntelliJ Platform Plugin SDK Help

Project Structure

This topic considers the concept of projects based on the IntelliJ Platform and related subjects, such as modules, facets, libraries, and SDK. The project structure and Java classes available to manage projects and modules are discussed.

Project and Its Components

This section briefly discusses the IDEA project structure, project components, and related terms. For more information about projects and their components, refer to Project, Module, Library, Facet in the IntelliJ IDEA Web Help.

Use ProjectSettingsService to open related entries in Project Structure dialog.


In the IntelliJ Platform, a project encapsulates all of a project's source code, libraries, and build instructions into a single organizational unit. Everything done using the IntelliJ Platform SDK is done within the context of a project. A project defines collections referred to as modules and libraries. Depending on the project's logical and functional requirements, you can create a single-module or a multi-module project.


A module is a discrete unit of functionality that can be run, tested, and debugged independently. Modules include such things as source code, build scripts, unit tests, deployment descriptors, etc. In a project, each module can use a specific SDK or inherit the SDK defined at the project level (see the SDK section below in this document). A module can depend on other modules of the project.


A library is an archive of compiled code (such as JAR files) on which modules depend. The IntelliJ Platform supports three types of libraries:

  • Module Library: the library classes are visible only in this module, and the library information is recorded in the module's .iml file.

  • Project Library: the library classes are visible within the project, and the library information is recorded in the project's .ipr file or in .idea/libraries.

  • Global Library: the library information is recorded in the applicationLibraries.xml file in the ~/.IntelliJIdea/config/options directory. Global libraries are similar to project libraries but are visible for different projects.

For more information about libraries, refer to Library.


Every project uses a Software Development Kit (SDK). For Java projects, SDK is referred to as JDK (Java Development Kit).

The SDK determines which API library is used to build the project. If a project is multi-module, the project SDK is common for all modules within the project by default. Optionally, a project can configure an individual SDK for each module.

For more information about SDKs, see Working with SDKs in the IntelliJ IDEA Web Help.


A facet represents a certain configuration, specific for a particular framework/technology associated with a module. A module can have multiple facets. E.g., Spring-specific configuration is stored in a Spring facet.

Facets are documented under Facet and Language and Framework Specific Guidelines in the IntelliJ IDEA Web Help.

Additional Information

For more information on each of these entities, see:

Last modified: 29 March 2023