intellij-sdk-code-samples/topics/intro/content_updates.md

Content Updates

Notable updates and additions to this documentation.

This page lists notable additions and updates to the SDK documentation and .

See GitHub Changelog (RSS) for a detailed changelog.

2025

February

{february-25}

Support Channel Update : Updated support channels to the new JetBrains Platform community forum. See the The JetBrains Platform Gets a New Community Space blog post for more context.

Revamped Threading and Execution Context topics : Reorganized threading and coroutines topics structure. Updated with the information about contexts available since 2024.2.

January

{january-25}

Coroutines on EDT and Locks

Added a page describing the current implicit locking behavior on EDT launched from coroutines and planned changes with migration hints.

2024

December

{december-24}

Live Templates Configuration File

Added a page describing the structure and elements of live templates configuration files.

August

{august-24}

Workspace Model

represents the project's structure and all its elements and replaces the existing .

Minor Changes and Additions :

• Updated list of supported features for Language Server Protocol (LSP).

July

{july-24}

Threading Model : Revamp the Threading Model page (formerly General Threading Rules) and add a new page describing background processes, including cancellation and progress tracking.

Coroutines Read Actions : Added FAQ section and explanation of why suspending inside the block is not allowed.

June

{june-24}

Code Formatter

Rework page, extending explanations and updating content.

May

{may-24}

Minor Changes and Additions :

• How to support grammar checks provided by Grazie plugin in custom languages.
• How to provide code vision provider name and description in the settings.
• How to manage Web Symbols context detection.

April

{april-24}

Plugin Internationalization

Add and pages describing IDE and plugin translation possibilities and best practices.

Minor Changes and Additions :

• How to mark functionality available during indexing via .
• Move Extension Point and Listener Lists to the Resources section and split the main Extension Point and Listener List into: IntelliJ Platform, IntelliJ Community Plugins, and Android Plugin.

March

{#march-24}

Kotlin Coroutines

Add describing how to write asynchronous code in an imperative style.

Minor Changes and Additions :

• Add documentation on how to handle errors and deprecations in extensions.
• Note changes in how highlighting is now performed more efficiently in 2024.1.

February

{#february-24}

IntelliJ Platform Gradle Plugin 2.x (Early Access Preview)

Add documentation for the next generation of Gradle tooling for plugin development.

2023

December

{#december-23}

JCEF

Revamp JCEF (Java Chromium Embedded Framework) page.

User Interface FAQ

Added .

Language Server Protocol (LSP)

Added .

November

{#november-23}

Minor Changes and Additions :

• Add information about executing actions programmatically.
• Please see on how to set up 2023.2/3 IDEs for Gradle plugin projects.

October

{#october-23}

Kotlin Persisting State Component

Add an example of a persistent state component implemented in Kotlin.

Minor Changes and Additions :

• Add section .

September

{#september-23}

Run Configuration Macros

Add section describing how to support dynamic expandable values in run configuration settings.

Inlay Hints

Update page with the information about new APIs.

Threading Model

Update to reflect changes in 2023.3 platform.

Minor Changes and Additions :

• Add information about ordering quick fixes and intentions actions.
• Clarify the information about declarative inlay hints customization possibilities.

July

{#july-23}

Run Configurations

Describe techniques for simplifying run configuration settings editors.

June

{#june-23}

Execution

Rework , , and pages.

Minor Changes and Additions :

• Clarify the syntax highlighting test file format and test implementation initial approach.
• Clarify referencing icons by paths and icon holder class constants in .
• Add information about requirements for persistent state components to be included in the Settings Sync plugin synchronization mechanism.

April

{#april-23}

Documentation

Rework page and adapt it to the new DocumentationTargetProvider framework.

March

{#march-23}

Web Symbols

Add documentation, which is a framework that simplifies web technology development by utilizing the API and supporting custom syntaxes.

Open Source Plugins Extension Points

Added for plugins bundled with and other IDEs.

February

{#february-23}

Inspection Options

Add a section on , which allows extending inspection behavior based on the input provided by user at runtime.

Minor Changes and Additions :

• Add section on .
• Document EP for spellchecking.

January

{#january-23}

Minor Changes and Additions :

• Update IDE Support section in .
• UI Inspector: update and add section .

2022

December

{#december-22}

Intention Preview

Add information about how to prepare intentions to show .

Minor Changes and Additions :

• Add information for new methods in Kotlin UI DSL Version 2.

November

{#november-22}

Plugin User Experience

Add a new section about how to improve plugin UX and overall plugin quality.

Minor Changes and Additions :

• Add information about threading in Actions in .

October

{#october-22}

Minor Changes and Additions :

• Add information about sharing settings between different IDEs installations.

September

{#september-22}

Extract "Themes" part : All the content related to themes customization and creating a project using the DevKit approach has been moved to a new Themes part. Content has been refreshed to match the current state of the project and SDK wizards.

Spell Checking

Add section with an accompanying tutorial showing how to implement a spell checking for a custom language.

Minor Changes and Additions :

• Add descriptions for the following EPs to : , , , .
• Add section about .
• Highlight references automatically via
• Language injections: controlling

August

{#august-22}

Plugin Configuration Page

Update the page to describe all the elements in detail.

Source links migrated from Upsource to GitHub

All source links now point to GitHub instead of Upsource (which is going to be sunset).

July

{#july-22}

Status Bar Widgets

Add section describing how to implement your own status bar widgets.

Minor Changes and Additions :

• Add overview of .

June

{#june-22}

PHP Type Providers

Add section about type providers describing type inference in PhpStorm and how to implement your own type provider.

Postfix Completion

Add section explaining how to implement generating or wrapping the existing code into additional constructs without navigating the caret back.

Gradle IntelliJ Plugin

Add documentation to Tooling.

Bundling Plugin API Sources

Add the section explaining how to expose plugin API sources to dependent plugin developers.

Minor Changes and Additions :

• Add a small section to describing PhpFilePathUtils utility class.
• Add mention of the way to programmatically open an autocomplete popup to .
• Add a small section to describing animated icons.
• Moved documentation to Tooling.

May

{#may-22}

Navigation Bar

Add section with an accompanying tutorial showing how to implement a navigation bar for a custom language.

Inlay Hints

Add section describing special markers that appear in the editor and provide additional information, like the names of the parameters that a called method expects.

Minor Changes and Additions :

• Add a small section to describing convenient EditorTextField subclasses.
• Add descriptions for the following EPs to : , , , , , , , .
• Add small section to describing how to modify the representation of nodes in the project view.
• Add paragraphs mentioning RenameInputValidator(Ex).

April

{#april-22}

Internal API Migration

As API annotated with @ApiStatus.Internal must not be used in plugins, refer to for a list corresponding API replacements and additional information.

March

{#march-22}

Code Samples Build Scripts Migrated to Kotlin

All now use Kotlin DSL in their Gradle build scripts.

Android Studio Releases List

Add section containing a complete list of the Android Studio releases with the relevant IntelliJ IDEA release version specified.

Alternatives to Implementing a Plugin

Add section describing alternative approaches to extending IDE functionality without actual plugin development.

February

{#february-22}

Parameter Info

Add section explaining how information about function parameters can be shown in the editor.

File and Code Templates

Add section explaining how to implement functionality that allows generating files and code fragments containing repetitive text and patterns.

January

{#january-22}

Highlighting

Add and sections explaining syntax highlighting basics and filtering highlighting information.

IDE Infrastructure

Add sections and .

2021

December

{#december-21}

Trusted Project

Potentially unsafe features must be guarded using Trusted Project API.

November

{#november-21}

Language Injection

Add section that shows how the IntelliJ Platform handles different languages within the same source file.

September

{#september-21}

IDE Infrastructure

handles Logging, Error Reporting, Runtime Information, and how to provide Context Help.

Extension Point Lists: Listeners, Deprecation status

now contains sections listing all provided Listener Topics. See also corresponding Extension Point Lists under Product Specific. Also, all deprecated API now has a dedicated tag.

July

{#july-21}

Plugin Signing

describes the plugin signing process, explains how to generate a certificate, configure the Gradle signPlugin task, and introduces a standalone CLI tool.

June

{#june-21}

Testing FAQ

page lists common issues, useful classes, and techniques for writing and maintaining tests.

Documentation Provider

Add section with an accompanying tutorial that show how to implement a DocumentationProvider for custom languages.

May

{#may-21}

IDE specific Extension Point Lists

See Product Specific.

New Guide - Explore the IntelliJ Platform API

Add a new section that describes how plugin authors work with the IntelliJ Platform API and what tools they use.

March

{#march-21}

Element Patterns

Add a new section about Element Patterns that are used when implementing Completion Contributors or PSI Reference Contributors.

Editor - Text Selection

Add a new section about Text Selection EPs and describe ExtendWordSelectionHandler.

SDK Setup Assistance

Added a code sample to the SDK tutorial that expands on assisting in the setup of an SDK.

Unified AST

Unified Abstract Syntax Tree (UAST) allows providing features that will work across all supported JVM languages (Java, Kotlin, Scala, Groovy).

2020

December

{#december-20}

IntelliJ Platform Explorer

Explore usages of Extension Points in open-source plugins using IntelliJ Platform Explorer.

November

{#november-20}

Extension Point List

All EPs available in IJ Platform and Android can now be browsed conveniently.

August

{#august-20}

README added to Code Samples

All code samples used in this guide now come with README, making it easier to browse them. They can be conveniently accessed via a separate GitHub repository.

June

{#june-20}

Dynamic Plugins update

Added new sections Code and Troubleshooting to Dynamic Plugins.

GitHub IntelliJ Platform Plugin Template

Create new plugins with a preconfigured project scaffold and CI in one click.

Disposer & Disposable

Added reference discussing resource cleanup/management.

May

{#may-20}

Settings (Preferences)

Added guide and tutorial on integrating with IDE Settings dialog.

UI Inspector

Inspect Swing components and associated data (like AnAction for menu item) using UI Inspector.

March

{#march-20}

JCEF Support

Allows embedding Chromium-based browser in the IDE.

February

{#february-20}

All Code Samples converted to Gradle

All samples now use the recommended solution of setting up plugin projects.

January

{#january-20}

Custom Language Support Tutorial converted to Gradle

The corresponding tutorial and Testing a Custom Language Plugin have been updated and enhanced as well.

Targeting specific IDEs

Product Specific has been expanded massively, now also covering each IDE with its dedicated page.

2019

December

{#december-19}

Dynamic Plugins support

Added starting point Dynamic Plugins for migrating plugins (IntelliJ Platform 2020.1 and later).

Plugin Components migration

Components being a legacy feature, the updated page describes migrating them to modern replacement API.

October

{#october-19}

Plugin Repository moved

All contents have been moved to JetBrains Marketplace Documentation.

July

{#july-19}

New page: Optimizing Performance

Optimizing performance when working with PSI, during indexing, and .

May

{#may-19}

New Page: Kotlin UI DSL

Describes preferred way of building UI/dialogs for IntelliJ Platform 2019.2 and later.