Partner – Moderne – NPI EA (cat=Spring Boot)
announcement - icon

Refactor Java code safely — and automatically — with OpenRewrite.

Refactoring big codebases by hand is slow, risky, and easy to put off. That’s where OpenRewrite comes in. The open-source framework for large-scale, automated code transformations helps teams modernize safely and consistently.

Each month, the creators and maintainers of OpenRewrite at Moderne run live, hands-on training sessions — one for newcomers and one for experienced users. You’ll see how recipes work, how to apply them across projects, and how to modernize code with confidence.

Join the next session, bring your questions, and learn how to automate the kind of work that usually eats your sprint time.

Course – Black Friday 2026 – NPI EA – main – before_post_content
announcement - icon

Yes, we're now running our Black Friday Sale. All Courses are 33% off until 1st December, 2026 at 17:00 Romania time:

>> EXPLORE ACCESS NOW

Course – Black Friday 2026 – NPI – main – before_post_content
announcement - icon

Yes, we're now running our Black Friday Sale. All Courses are 33% off until 1st December, 2026 at 17:00 Romania time:

>> EXPLORE ACCESS NOW

1. Overview

In this tutorial, we’ll learn how to change the JDK version in IntelliJ projects. This will work on both Community and Ultimate Editions of IntelliJ. Developers might change the JDK version to use new features or meet specific project requirements.

2. Project Structure Settings

IntelliJ stores the JDK version used by the project within its Project Structure. There are two ways to locate this:

  • Via menu navigation:
    • Navigating to File -> Project Structure
  • Via keyboard shortcut:
    • For macOS, we press ⌘ + ;
    • For Windows, we press Ctrl + Shift + Alt + S

These are the default settings, but we need to make sure that these shortcuts match our operating system settings if needed.

If everything works well, we’ll see a popup dialog appear that looks similar to this:

Popup dialog

 

Under the Project SDK section, we’ll be able to select a new JDK to use for the project via the combo box, and all installed SDKs will be shown as Detected SDKs:

Select a new JDK

After updating to a new version of Java, the project will begin reindexing its source files and libraries to ensure that autocompletion and other IDE features are synchronized. Please note that reindexing might temporarily slow down the IDE as it updates the project files.

Another option is to download the JDK directly via IntelliJ:

Download the JDK directly via IntelliJ

This will allow us to install and index the JDK version properly, not only for this project but also for future ones. Please remember that if we want the change to be permanent, we can set a global default JDK for all projects in IntelliJ through the IDE settings.

To do that, we should click “New Projects Setup” on the Welcome screen and then select “Structure for New Projects“. If a project is already open, we choose File → New Projects Setup → Structure that will lead us to:

Make the change permanent

3. Setting the Language Level

We should note that Language level is an important configuration setting in IntelliJ. When we don’t manually configure the target bytecode version for the compiler, which is typically done at Settings → Build, Execution, Deployment → Compiler → Java Compiler, the target bytecode version will be the same as the project Language level setting. Further, the Language level defines coding assistance features that we can use in the editor.

We should set the Language level to be the same or lower than the project SDK. If we don’t do this, we may get an error or warning message similar to: Java: Invalid Source Release: 17.

To demonstrate, let’s set the Java SDK version as 17 along with the Language level as 21:

IncorrectLanguageLevel

When we build or compile the project, we’ll get an error or warning message similar to:

ErrorMessage

To fix this message, we should set the SDK to be the same or higher than the Language level. Alternatively, we can change the Language level to be the same or lower than the SDK. For the example in the discussion, let’s increase the SDK to 21:

CorrectLanguageLevel

Now, when we rebuild or recompile the project, we won’t get that error or warning message regarding the source release. If needed, we can configure the language level for each module individually.

4. Common Gotchas

When changing the JDK, this only affects the JDK used by IntelliJ. Therefore, when running the Java project via the command line, it will still use the JDK specified in the JAVA_HOME environment variable.

Additionally, changing the Project SDK doesn’t change the JVM version of the build tools. So when using Maven or Gradle within IntelliJ, changing the Project SDK won’t change the JVM used for these build tools.

5. Conclusion

In this article, we illustrated two ways to change the Java version used within IntelliJ projects. We also highlighted the caveats we must be aware of when changing the Java version.

To learn more about IntelliJ’s Project Structure, visit the official documentation.

Partner – Moderne – NPI EA (tag=Refactoring)
announcement - icon

Modern Java teams move fast — but codebases don’t always keep up. Frameworks change, dependencies drift, and tech debt builds until it starts to drag on delivery. OpenRewrite was built to fix that: an open-source refactoring engine that automates repetitive code changes while keeping developer intent intact.

The monthly training series, led by the creators and maintainers of OpenRewrite at Moderne, walks through real-world migrations and modernization patterns. Whether you’re new to recipes or ready to write your own, you’ll learn practical ways to refactor safely and at scale.

If you’ve ever wished refactoring felt as natural — and as fast — as writing code, this is a good place to start.

Course – Black Friday 2026 – NPI EA – main – after_post_content

announcement - icon

Yes, we're now running our Black Friday Sale. All Courses are 33% off until 1st December, 2026 at 17:00 Romania time:

>> EXPLORE ACCESS NOW

Course – Black Friday 2026 – NPI – main – after_post_content

announcement - icon

Yes, we're now running our Black Friday Sale. All Courses are 33% off until 1st December, 2026 at 17:00 Romania time:

>> EXPLORE ACCESS NOW