Working with Registry

Guidelines for using the IntelliJ Registry API.

Documentation

• Defining Registry Keys: Registry.md - How to declare keys in plugin.xml or registry.properties
• Cloud Registry: Cloud Registry and Notifications.md - Remote registry updates for JetBrains IDEs

Quick Reference

Defining a Registry Key

Always prefer declaring in plugin.xml (not registry.properties):

xml
1<registryKey key="my.feature.enabled"
2             defaultValue="true"
3             description="Enables my feature"
4             restartRequired="false"/>

To override in a dependent plugin:

xml
1<registryKey key="my.feature.enabled"
2             defaultValue="false"
3             description="Enables my feature"
4             restartRequired="false"
5             overrides="true"/>

Accessing the Registry

In suspending code:

kotlin
1val isEnabled = RegistryManager.getInstanceAsync().get("my.key")

In blocking code:

kotlin
1val isEnabled = RegistryManager.getInstance().get("my.key")

Access via Registry.get() or Registry.is() is effectively deprecated, since it might cause problems during early IDE startup. Always prefer the RegistryManager when possible.

Early Startup: Registry.is() with Default Value

When code may run before COMPONENTS_LOADED state (e.g., during EULA dialog, splash screen), you MUST use Registry.is(key, defaultValue) with an explicit default:

kotlin
1// Required for early startup code
2Registry.`is`("my.key", false)  // default must match registry.properties

How to find the default value:

1. Search in community/platform/util/resources/misc/registry.properties
2. Or check the <registryKey> declaration in plugin.xml

Why: Registry.is(key) without default throws an exception if called before LoadingState.COMPONENTS_LOADED. The safe overload returns the provided default when Registry is not yet initialized.

Override via Command Line

For testing or run configurations:

-Dmy.registry.key=value

Registry in Tests

Use @RegistryKey annotation instead of Registry.get().setValue():

kotlin
1@Test
2@RegistryKey(key = "my.registry.key", value = "true")
3fun testWithRegistryEnabled() { ... }

See writing-tests.md for more test patterns.