Complete Guide to Installing a Spring Boot Plugin in IntelliJ IDEA

Check version compatibility first

The plugin is distributed as a zip package. Before installation, the most important step is matching the plugin version with your IntelliJ IDEA major version. IDEA 2026.1.x should use a 2026.1.x compatible package; older IDE versions should use the closest matching package from the version history page.

Do not rely only on the release date. IDE plugins often depend on platform APIs. After a major IDE upgrade, an old plugin may still install but fail during completion, indexing, or configuration metadata reading.

• Check the exact IntelliJ IDEA version from the About dialog
• Choose the matching plugin zip from the version history page
• Restart the IDE after installation and verify with a minimal project

Install the plugin from disk

Open IntelliJ IDEA settings, go to Plugins, and choose Install Plugin from Disk. Select the downloaded zip file and confirm installation. If the IDE asks for a restart, restart before testing the plugin.

If opening application.yml triggers a prompt to install another marketplace plugin, do not overwrite the local plugin immediately. Cancel the prompt first, then check whether Intellij Spring Initializr is installed and enabled.

• Settings / Preferences -> Plugins
• Choose Install Plugin from Disk
• Select the zip package downloaded from this site
• Restart IntelliJ IDEA after installation

How to verify the installation

Create a minimal Spring Boot project, add application.yml, and type spring. or server. to check whether completion suggestions appear. Then create application.properties and type server. or management. to verify Properties completion.

If a new project works but an existing project does not, the problem is usually related to indexing, file type recognition, or project import state. Avoid reinstalling repeatedly; try reopening the file, invalidating caches, or reimporting the project first.

spring:
  application:
    name: demo-service
server:
  port: 8080

How to tell whether installation succeeded

A successful installation has three separate signals: the plugin appears under Installed, it is Enabled, and completion appears in a supported configuration file. Seeing the plugin name alone is not enough because an incompatible build can sometimes install without providing its features.

Wait for IntelliJ IDEA to finish indexing, then type spring, datasource, and url one level at a time in application.yml. The editor should offer configuration keys at each level. If it only provides generic text suggestions without property descriptions, verify that the project is recognized as a Spring Boot project.

• The plugin is enabled under Installed with no compatibility warning
• Project indexing has completed
• The IDE recognizes application.yml and application.properties file types
• Configuration prefixes produce keys, descriptions, or default-value hints

Evidence to keep when installation fails

A useful issue report needs more than 'it does not work'. Record the full IntelliJ IDEA version, downloaded zip filename, Installed-page state, and behavior in a minimal project. Preserve the exact compatibility message when one appears, and note whether both YAML and Properties completion are affected.

JetBrains documents local ZIP or JAR installation and restarting the IDE when prompted. This guide uses that standard entry point; package version selection and completion checks are the additional verification steps specific to this project.

• JetBrains: Install plugin from disk

Related guides

• Common Reasons IntelliJ IDEA Plugin Installation Fails
• Checklist for Spring Boot Configuration Completion Not Working