# Notable Changes in IntelliJ Platform and Plugins API 2026.*

> For the complete documentation index, see [llms.txt](https://plugins.jetbrains.com/docs/intellij/llms.txt).

Early Access Program (EAP) releases of upcoming versions are available [here](https://eap.jetbrains.com).

> **Warning: Gradle Plugin**
> The Gradle plugin must be chosen depending on the target [platform version](build-number-ranges.html#platformVersions).
>
>
>
>
> 2024.2+
> : Requires [IntelliJ Platform Gradle Plugin (2.x)](tools-intellij-platform-gradle-plugin.html)
>
>
> 2022.3+
> : Recommended [IntelliJ Platform Gradle Plugin (2.x)](tools-intellij-platform-gradle-plugin.html)
> :
> :
> :
> : Requires [Gradle IntelliJ Plugin (1.x)](tools-gradle-intellij-plugin.html) (Obsolete) 1.10.1+

## 2026.3

### IntelliJ Platform 2026.3

Plugin management with user consent
: The experimental [PluginPermissionService](https://github.com/JetBrains/intellij-community/tree/master/platform/core-impl/src/com/intellij/ide/plugins/PluginPermissionService.kt) lets a plugin ask the user to allow an operation on other plugins. The plugin passes a request and an action to `withPermission()`. The IDE shows the request message in a permission dialog, and runs the action only if the user allows the request. If the user denies the request, `withPermission()` returns a failure with `PluginPermissionNotGrantedException`. [PluginManagementPermissions.kt](https://github.com/JetBrains/intellij-community/tree/master/platform/platform-impl/src/com/intellij/openapi/updateSettings/PluginManagementPermissions.kt) defines these requests:
:
:
:
: * `EnablePluginRequest`, `DisablePluginRequest`, and `InstallPluginRequest` give the action a `PluginManagementAction`, and its `apply()` starts the operation.
:
: * `AccessPluginClassLoadersRequest` gives the action a `ReadPluginDescriptorsAction`, which returns the descriptors of all installed plugins and their class loaders.
:
:
:
: Each permission works for one call only, so the plugin must send a new request to repeat the operation. Call `withPermission()` directly from the plugin code, because the service identifies the requesting plugin by the calling class. Java code can use `PluginPermissionJavaShim.withPermission()`, which returns a `CompletableFuture`.
:
:
:
:
: ```KOTLIN
: val result = PluginPermissionService.getInstance().withPermission(
: DisablePluginRequest(
: pluginId,
: MyBundle.message("disable.conflicting.plugin.reason")
: )
: ) { action -> action.apply() }
: ```
:
:
:
: This API replaces the `PluginManagerCore` methods that enable and disable plugins, which are now internal. See [Plugin Management 2026.2](api-changes-list-2026.html#plugin-management-20262).

The Old Search Everywhere API is deprecated
: The old Search Everywhere API in the [com.intellij.ide.actions.searcheverywhere](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/lang-api/src/com/intellij/ide/actions/searcheverywhere) package is deprecated in favor of the new Search Everywhere API in [com.intellij.platform.searchEverywhere](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/searchEverywhere/shared/src), which is enabled by default since 2026.2.
:
:
: Migrate to the following replacements:
:
:
:
: * Old: [SearchEverywhereContributor](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/lang-api/src/com/intellij/ide/actions/searcheverywhere/SearchEverywhereContributor.java), [WeightedSearchEverywhereContributor](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/lang-api/src/com/intellij/ide/actions/searcheverywhere/WeightedSearchEverywhereContributor.kt), and [AbstractGotoSEContributor](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/lang-impl/src/com/intellij/ide/actions/searcheverywhere/AbstractGotoSEContributor.kt) New: Implement [SeItemsProvider](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/searchEverywhere/shared/src/SeItemsProvider.kt)
:
: * Old: [SearchEverywhereContributorFactory](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/lang-api/src/com/intellij/ide/actions/searcheverywhere/SearchEverywhereContributorFactory.java) registered in the [com.intellij.searchEverywhereContributor](https://jb.gg/ipe?extensions=com.intellij.searchEverywhereContributor) extension point New: Implement [SeItemsProviderFactory](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/searchEverywhere/shared/src/SeItemsProviderFactory.kt) and register it in the [com.intellij.searchEverywhere.itemsProviderFactory](https://jb.gg/ipe?extensions=com.intellij.searchEverywhere.itemsProviderFactory) extension point
:
: * Old:[FoundItemDescriptor](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/lang-api/src/com/intellij/ide/actions/searcheverywhere/FoundItemDescriptor.java), [ContributorSearchResult](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/lang-api/src/com/intellij/ide/actions/searcheverywhere/ContributorSearchResult.java), and [SearchEverywhereFoundElementInfo](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/lang-api/src/com/intellij/ide/actions/searcheverywhere/SearchEverywhereFoundElementInfo.java) New: Use [SeItem](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/searchEverywhere/shared/src/SeItem.kt)
:
: * Old:[SearchEverywhereExtendedInfoProvider](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/lang-api/src/com/intellij/ide/actions/searcheverywhere/SearchEverywhereExtendedInfoProvider.kt) and [ExtendedInfo](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/lang-api/src/com/intellij/ide/actions/searcheverywhere/ExtendedInfo.kt) New: Use [SeItemPresentation.extendedInfo](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/searchEverywhere/shared/src/presentations/SeItemPresentation.kt) and [SeExtendedInfoCalculator](https://github.com/JetBrains/intellij-community/tree/master/platform/searchEverywhere/shared/src/providers/target/SeExtendedInfoCalculator.kt)
:
: * Old:[SearchEverywherePreview](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/lang-impl/src/com/intellij/ide/actions/searcheverywhere/SearchEverywherePreview.kt) New: Implement [SeItemsPreviewProvider](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/searchEverywhere/shared/src/SeItemsPreviewProvider.kt)
:
: * Old:[SearchEverywhereCommandInfo](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/lang-api/src/com/intellij/ide/actions/searcheverywhere/SearchEverywhereCommandInfo.java) New: Use [SeCommandInfo](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/searchEverywhere/shared/src/SeCommandInfo.kt) and [SeCommandInfoFactory](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/searchEverywhere/shared/src/SeCommandInfo.kt)
:
: * Old: Custom tabs New: Implement [SeTabFactory](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/searchEverywhere/frontend/src/SeTabFactory.kt) and register it in the [com.intellij.searchEverywhere.tabFactory](https://jb.gg/ipe?extensions=com.intellij.searchEverywhere.tabFactory) extension point
:
:
:
: The [com.intellij.ide.actions.searcheverywhere.remote](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/lang-api/src/com/intellij/ide/actions/searcheverywhere/remote) classes are obsolete without replacement, because the new API supports remote development by design. The new API is marked as `@ApiStatus.Experimental`. In 2027.1, the deprecated API will be disabled by default via a registry key. In 2027.2, it will be removed.
:
:
: Report missing functionality on the [JetBrains Platform Forum](https://platform.jetbrains.com).

Declarative color settings pages
: The new [com.intellij.colorSettings](https://jb.gg/ipe?extensions=com.intellij.colorSettings) extension point  registers a [ColorSettingsPage](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/platform-api/src/com/intellij/openapi/options/colors/ColorSettingsPage.java) together with its name, ID, and order. The IDE builds the `Settings | Editor | Color Scheme` tree from the declaration without loading the page class, and creates the `ColorSettingsPage` instance only when the user opens the page. The [com.intellij.colorSettingsPage](https://jb.gg/ipe?extensions=com.intellij.colorSettingsPage) extension point  is deprecated. See [Registering a Color Settings Page](syntax-highlighting-and-error-highlighting.html#registering-a-color-settings-page) for the supported attributes and for plugins that also support earlier versions.

Settings Beta label is declared in XML
: The Settings tree no longer reads the [Configurable.Beta](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/ide-core/src/com/intellij/openapi/options/Configurable.java) marker interface, which is now deprecated and scheduled for removal. To keep the Beta label, add the `beta="true"` attribute to the `com.intellij.applicationConfigurable` or `com.intellij.projectConfigurable` declaration. A color settings page declared in `com.intellij.colorSettings` supports the same attribute. See [Table of Attributes](settings-guide.html#table-of-attributes).

## 2026.2

### IntelliJ Platform 2026.2

Asynchronous `VirtualFile` content saving
: [VirtualFile](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/core-api/src/com/intellij/openapi/vfs/VirtualFile.java) content updates via `getOutputStream()` or `setBinaryContent()` can now be postponed – the actual file on disk may be modified with some delay. See [When are VirtualFile changes persisted on disk and loaded from disk to VFS?](virtual-file.html#when-are-virtualfile-changes-persisted-on-disk-and-loaded-from-disk-to-vfs) for more details.

## 2026.1

### IntelliJ Platform 2026.1

Background-capable VFS listeners
: New APIs allow VFS listener callbacks to run off the Event Dispatch Thread (EDT), reducing UI freezes during heavy file operations. Bulk listeners can implement the [BulkFileListenerBackgroundable](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/core-api/src/com/intellij/openapi/vfs/newvfs/BulkFileListenerBackgroundable.kt) marker interface and subscribe to the [VirtualFileManager.VFS_CHANGES_BG](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/core-api/src/com/intellij/openapi/vfs/VirtualFileManager.java) message topic (instead of `VFS_CHANGES`). Async listeners can be registered via [addAsyncFileListenerBackgroundable()](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/core-api/src/com/intellij/openapi/vfs/VirtualFileManager.java) or the `com.intellij.vfs.asyncListenerBackgroundable` extension point. Migrate thread-safe listeners without UI dependencies from `VFS_CHANGES`/[addAsyncFileListener()](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/core-api/src/com/intellij/openapi/vfs/VirtualFileManager.java).

New LSP API features
: Language Server Protocol support gains Range Formatting (`textDocument/rangeFormatting`), Code Lens (`textDocument/codeLens`), and Optimize Imports (`textDocument/codeAction` with `source.organizeImports`). ``Also includes a major rewrite of LSP highlighting for improved performance. See [Language Server Protocol (LSP)](language-server-protocol.html).

`OSProcessHandler.waitFor()` on EDT or under read lock logs error
: Waiting for an external process via [OSProcessHandler.waitFor()](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/platform-util-io/src/com/intellij/execution/process/OSProcessHandler.java) on the Event Dispatch Thread or while holding a read lock is now prohibited for all users and logs a `LOG.error`. This check has been previously enabled in internal mode since 2019. Move process waiting off the EDT and outside of read actions, e.g., into a background thread or a coroutine.

Non-cancellable read action APIs deprecated
: [ReadAction.compute()](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/core-api/src/com/intellij/openapi/application/ReadAction.java), [ReadAction.run()](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/core-api/src/com/intellij/openapi/application/ReadAction.java), and [runReadAction()](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/core-api/src/com/intellij/openapi/application/actions.kt) are deprecated because long-running non-cancellable read actions on background threads can block write actions and cause UI freezes. Migrate to cancellable coroutine-based APIs: [readAction {}](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/core-api/src/com/intellij/openapi/application/coroutines.kt) or [smartReadAction {}](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/core-api/src/com/intellij/openapi/application/coroutines.kt) in Kotlin, or [ReadAction.nonBlocking().submit()](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/core-api/src/com/intellij/openapi/application/ReadAction.java) / [.executeSynchronously()](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/core-api/src/com/intellij/openapi/application/ReadAction.java) in Java. As a last resort, [ReadAction.computeBlocking()](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/core-api/src/com/intellij/openapi/application/ReadAction.java) and [runReadActionBlocking()](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/core-api/src/com/intellij/openapi/application/coroutines.kt) are available but should only be used under modal progress.

`AnActionEvent.coroutineScope` added
: [AnActionEvent](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/platform/editor-ui-api/src/com/intellij/openapi/actionSystem/AnActionEvent.java) now exposes a `coroutineScope` property providing convenient access to a `CoroutineScope` within `actionPerformed`, while maintaining synchronous EDT execution contracts.

### Terminal Plugin 2026.1

`TerminalUtil.hasRunningCommands()` must not be called on EDT
: [TerminalUtil.hasRunningCommands()](https://github.com/JetBrains/intellij-community/tree/idea/263.7307.200/plugins/terminal/src/org/jetbrains/plugins/terminal/TerminalUtil.java) now asserts it is not called on the Event Dispatch Thread via `ThreadingAssertions.assertBackgroundThread`, and logs a `LOG.error` if violated. Calling this method on the EDT can cause UI freezes because it queries external process state. Move calls to a background thread or a coroutine.