diff --git a/topics/_shared/snippets.md b/topics/_shared/snippets.md
index c5c364eef..69924dc48 100644
--- a/topics/_shared/snippets.md
+++ b/topics/_shared/snippets.md
@@ -69,12 +69,12 @@ _Early Access Program_ (EAP) releases of upcoming versions are available [here](
 
 <snippet id="apiChangesJavaVersion">
 
+> Java 21 is required when targeting 2024.2 and later only.
+>
 > Java 17 is required ([blog post](https://blog.jetbrains.com/platform/2022/08/intellij-project-migrates-to-java-17/)) when targeting 2022.2 and later only.
 >
 > Java 11 is required ([blog post](https://blog.jetbrains.com/platform/2020/09/intellij-project-migrates-to-java-11/)) when targeting 2020.3 and later only.
 >
-> Please make sure to always upgrade `gradle-intellij-plugin` to the latest version [%gradle-intellij-plugin-version%](https://github.com/jetbrains/gradle-intellij-plugin/releases)
->
 {title="IDE and Java Versions" style="note"}
 
 </snippet>
diff --git a/topics/basics/getting_started/build_number_ranges.md b/topics/basics/getting_started/build_number_ranges.md
index 013cd8c40..6558c56b7 100644
--- a/topics/basics/getting_started/build_number_ranges.md
+++ b/topics/basics/getting_started/build_number_ranges.md
@@ -87,10 +87,13 @@ In some cases, keeping a dedicated branch and corresponding plugin release for e
 Note that there is no `YY0`.
 In the `YYYY.R` versioning scheme, the `R` part starts at 1.
 
+<include from="snippets.md" element-id="apiChangesJavaVersion"/>
+
 <include from="snippets.md" element-id="gradlePluginVersion"/>
 
 | Branch number                                                   | IntelliJ Platform version                                                                                                                |
 |-----------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------|
+| 242                                                             | 2024.2 **NOTE** Java 21 is now required                                                                                                  |
 | [241](https://github.com/JetBrains/intellij-community/tree/241) | 2024.1                                                                                                                                   |
 | [233](https://github.com/JetBrains/intellij-community/tree/233) | 2023.3                                                                                                                                   |
 | [232](https://github.com/JetBrains/intellij-community/tree/232) | 2023.2                                                                                                                                   |