Learn how to configure the plugin

The Material Theme plugin comes with a bunch of features tailored for an optimal experience. However, it’s also highly configurable to allow every one to customize it to their hearts’ content.

Themes and color schemes

Theme switcher

The plugin comes prebundled with a set of themes interchangeables through the Theme Switcher Theme Switcher.

Theme Switcher
Theme Switcher

There are many ways to invoke the Theme Switcher:

  • From the IDE menu Tools → Material Theme → Material Theme Chooser
  • From the Main Toolbar
  • From the Search Everything dialog, type Material Theme
  • From the Quick Switch panel (Ctrl + \`) (Windows: Ctrl + ~)`
  • From the Status Bar Widget (since version 7.4.0)
Quick Switch
Quick Switch

Or, since version 2.4.0, from the Settings at Settings → Appearance → Material Theme.

Switcher in Settings
Switcher in Settings

The plugin comes prebundled with 23 themes:

Material themes

These themes are based on the original themes, made by Mattia Astorino (@equinusocio)

  • Oceanic

    An oceanic blue flat theme

  • Darker

    A pitch-black flat theme

  • Lighter

    A bright light flat theme

  • Palenight

    A purplish flat theme

  • Deep ocean

    A deep sea black flat theme

  • Forest

    A forests and trees based flat theme

  • Sky blue

    A clear and light blue flat theme

  • Sandy beach

    A sandy based flat theme

  • Volcano

    A rock and fiery based theme

  • Space

    An dark blue and purple spacey theme

Other themes

Besides the Material Themes, there are other prebundled themes made by the community:

  • Monokai pro

    Theme based on the Monokai Pro Theme

  • Dracula

    Theme based on the Dracula Theme

  • Github

    Theme based on the GitHub UI

  • Github dark

    Theme based on the GitHub Dark UI

  • Arc dark

    Theme based on the Arc Dark GTK Theme

  • One dark

    Theme based on the Atom One Dark theme

  • One light

    Theme based on the Atom One Light theme

  • Solarized dark

    Solarized Dark Theme

  • Solarized light

    Solarized Light Theme

  • Night owl

    Theme based on Night Owl by Sarah Drasner

  • Light owl

    Theme based on Light Owl by Sarah Drasner

  • Moonlight

    Theme based on the Moonlight Theme by Atomiks

  • Synthwave '84

    Theme based on the SynthWave' 84 theme by Robb Owen

Custom theme

This feature is only available for premium users.

Finally, there are the Custom Themes, which are the placeholder for the Custom Theme Settings, allowing you to set your own theme colors.

There are two options available, Custom Theme for dark themes and Light Custom Theme for light themes.

See Custom Themes for more information.

Native Themes (since 5.0)

From version 5.0 the plugin now supports Native Themes as well, that is, themes using JetBrains theme API. When loading a native theme, the plugin would try to convert it into a Material Theme, thus allowing you to use the theme colors while using the Material Theme features such as the components, accent mode, etc.

You don’t need to do anything to make it work, simply download a native theme and select it. It will be automatically converted to a theme format supported by the plugin.


IntelliJ Light
IntelliJ Light
Gradianto Theme
Gradianto Theme

External Themes (deprecated)

This feature is deprecated since version 6.10.0 in favor of the native themes.

The plugin also exposes an endpoint allowing plugin developers to create and bundle their own custom themes, just like Color Schemes, Keymaps, Coding Styles, etc. To learn more about External Themes or how to create your own plugin, head to the External Themes section.

Once the external theme has been downloaded and installed, it should appear at the bottom of the Switcher.

External Themes
External Themes
External Themes List
External Themes List

Material theme settings

Settings Page

Some settings are only available for premium users.

You can configure many parts of the plugin features from the plugin settings. They’re available within the Settings → Appearance → Material Theme → Settings.

Material Theme Settings v1
Material Theme Settings v1

Since version 2.4.0, the settings page has been remade to prevent overwhelming the user from the abundance of customization options.

Now settings are differentiated between basic and advanced settings, they’re grouped within tabs, and a Reset Settings button has been added for easy factory resetting.

Material Theme Settings V2
Material Theme Settings V2


Quick explanation of all settings:

Main Settings:

  • Selected Theme: Select a Theme from the prebundled themes.
  • Contrast Mode: Add contrast to specific panels and components.
  • High Contrastpremium: Set a more pronounced contrast, by making the texts more prominent.
  • Custom Accent Color: Set a custom accent color.
  • Override Accent Color: Change the accent color accordingly to the selected theme.
  • Configure Custom Theme Colors: Open the settings page for the Custom Theme Colors.

Tab Settings:

  • Tabs Height: Customize the tabs’ height (between 25 and 60 pixels).
  • Active Tab Highlight Colorpremium: Customize the active tab’s indicator color.
  • Thicknesspremium: Set the active tab’s indicator thickness.
  • Uppercase Tabspremium: Set the Editor Tabs in Uppercase.
  • Bold Active Tabpremium: Make the Active Tab Bold.
  • Tab Highlight Positionpremium: Customize the position of the tab highlighter.
  • Custom Tab Fontpremium: Control the font and size of the Editor Tabs.
  • Tabs Animations: Animate the tab indicator upon switching tabs
  • Tab Separators: Add thin borders between tabs

Compact Settings:

  • Compact Status Bar: Reduce the height of the status bar.
  • Compact Table Cells: Reduce the height of table headers and table cells.
  • Compact Dropdowns: Reduce the size of dropdowns.
  • Compact Menus: Reduce the size of the menus.
  • Custom List Items Height: Control the size of items in lists and dropdowns (min: 18, max: 48).
  • Compact Fields: Reduce the size of fields, such as input, numeric and passwords.

Project View Settings:

  • Custom Tree Items Heightpremium: Set custom line height in trees (min: 18, max: 44).
  • Custom Tree Indentpremium: Fine tune indent of tree items.
    • You can configure both the Left and Right indents.
  • Selected Indicator Stylepremium: Change the style of the indicator for selected item in trees.
    • Border: Add a small rounded border to the left
    • Dot: Add a dot on the selected item
    • Sharp: Add a small sharp border to the left
    • None: Remove the indicator
  • Thicknesspremium: Control the thickness of the indicator.
  • Custom Directories Stylepremium: Assign a specific style to directories. Can be configured from the Custom File Colors settings page.
  • Custom Tree Fontpremium: Fine tune the font and size of the project trees.

Component Settings:

  • Old Material Design Style: Reverts to the old Material Design style of 2016–2021.
  • Uppercase buttons: Set the buttons’ texts to uppercase.
  • Outlined buttonspremium: Use outline buttons instead of full buttons.
  • Transparent Scrollbars: Enable/Disable transparency in scrollbars (requires restart).
  • Accent Scrollbars: Set the color of the scrollbars to the accent color (requires restart).
  • Tabs Shadowpremium: Add a subtle shadow under the tabs.
  • Shadowspremium: Add a subtle shadow around notifications and some popups.
  • Inverted Completion Selection Color: Switch the Autocomplete’s selected item color between the selection color and contrast color.
  • Animated Tool Windows: Animate opening and closing on tool windows when they are undocked.

Features Settings:

  • Custom UI Font: Set your own custom UI Font. Supplements the IDE’s Custom Font.
  • Use Editor Default Fontpremium: Automatically update color schemes to use the default font of your choice.
  • Material File Status Colors: Enable/Disable the Material File Status Colors.
  • Material Wallpaperspremium: Add a custom wallpaper per theme for the empty frame window.
  • Show Overlays: Displays an overlay when modals are open.
  • Accent Modepremium: Make components stand out by setting them in the accent color (buttons, tabs, selections…).
    • Second Accent Color: When Accent Mode is on, sets a second accent color to contrast with the primary accent color.

Project Frame Settings:

  • Project Frame Colorspremium: Add a colored stripe on the top of each project window for easier differentiation.
  • Colorize Title Barpremium: Colorizes the title bar as well (only for the New UI!).
  • Show Project Namepremium: Displays the project name on the stripe.
  • Show Project Iconpremium: Display the project’s custom icon on the stripe.
  • Customize Textpremium: Customize the displayed text.
    • You can use the keywords {project}, {module}, {fullPath}, {path} and {file} to refer respectively to the current project, module, full path, local path and/or current file.

Other Tweaks:

  • Language Additionspremium: Enable/Disable the Language Additions
  • Focus Modepremium: Increases focus on the current editing scope by making other parts dimmer.
    • Override Focus Color from Theme: Sets the color of the “unfocused” parts from the current theme.
    • Custom Focus Color: Set your own unfocused color
  • Colored Open Directoriespremium: Colorize open directories with the accent color.
  • Show What’s New on each update: Whether to display the What’s New page on each update.
  • Automatically reset Color Scheme: Automatically reset the color scheme on theme activation (only for bundled color schemes).
  • Show Wizard on Welcome Screen: Add or remove the Wizard option in the Welcome Screen.

Project-specific settings

This feature is only available for premium users.

These settings allow you to assign specific settings on a per-project basis:

Tab Settings:

  • Active Tab Highlight Colorpremium: Customize the active tab’s indicator color.
  • Thicknesspremium: Set the active tab’s indicator thickness.
  • Uppercase Tabspremium: Set the Editor Tabs in Uppercase.
  • Bold Active Tabpremium: Make the Active Tab Bold.
  • Tab Highlight Positionpremium: Customize the position of the tab highlighter.

Project Frame Settings:

  • Project Frame Colorspremium: Override the stripe color per project.
  • Show Project Namepremium: Display the project’s name on the stripe.
  • Show Project Iconpremium: Display the project’s custom icon on the stripe.
  • Customize Textpremium: Customize the text displayed.
    • You can use the keywords {project}, {module} and {file} to refer to the current project, module and/or file.

Settings shortcuts

You can also quickly toggle some settings by using the Search Everywhere or the Command Panel capability of the IDE. Simply press Shift-Shift and type Material Theme to get the list of available toggles.

Same goes for the Command Panel (Ctrl-Shift-A/Cmd-Shift-A).

Command Panel
Command Panel

You can also use the Keymap Editor to assign your own custom shortcuts to these toggles.

Settings File

Your current configuration is stored inside the IDE settings’ directory under the filenames:

  • Main Settings: material_theme.xml.
  • Custom Theme: material_custom_theme.xml.
  • Per Project Settings: material_theme_project.xml.

If, for some reason, there are issues with the plugin, or you don’t manage to reset to a stable state, just delete these files and restart the IDE.

Read IDE Settings and Directories used by the IDE to find out where are stored such configuration files.

The files in question should be located in the following directories:

  • within <config directory>/jba_config if using Settings Sync
  • within <config directory>/config otherwise
  • within each project’s .idea directory for the Per-Project Settings.

Custom theme

This feature is only available for premium users.

Aside from the bundled themes, you also have the ability to set up your own Material Theme. You can do so by selecting Custom Theme in the theme list, then customize the theme colors in the settings page at Settings → Appearance → Material Custom Theme Settings.

Material Custom Theme Settings
Material Custom Theme Settings

Once you set these colors, simply select the Custom Theme in the Material Theme Chooser and see your colors take effect.

See Custom Theme for more details.

Advanced configuration

Here’s a list of the keys used in the configuration file (material_theme.xml) with their default values. If a key isn’t in your file, it means that it uses the default value.

    <!-- Automatically reset the color scheme -->
    <option name="autoResetColorScheme" value="false"/>
    <!-- Accent color -->
    <option name="accentColor" value="E91E63"/>
    <!-- Accent scrollbars -->
    <option name="accentScrollbars" value="true"/>
    <!-- Accent Mode -->
    <option name="accentMode" value="true"/>
    <!-- Whether to send data analytics -->
    <option name="allowDataCollection" value="false"/>
    <!-- Outlined Buttons -->
    <option name="borderedButtons" value="false"/>
    <!-- Language Additions -->
    <option name="codeAdditionsEnabled" value="true"/>
    <!-- Compact dropdowns enabled -->
    <option name="compactDropdowns" value="false"/>
    <!-- Custom tree line height enabled -->
    <option name="compactSidebar" value="false"/>
    <!-- Custom lists' item height -->
    <option name="customListItemsSizeEnabled" value="false"/>
    <!-- Custom lists' line height if enabled -->
    <option name="customListItemsSize" value="28"/>
    <!-- Custom tree line height if enabled -->
    <option name="customSidebarHeight" value="18"/>
    <!-- Custom project frame text if enabled -->
    <option name="customTitle" value="{project}"/>
    <!-- Themed Title Bar (deprecated since 2021.2) -->
    <!-- <option name="darkTitleBar" value="false" /> -->
    <!-- Enforced Language Additions -->
    <option name="enforcedLanguageAdditions" value="false"/>
    <!-- Experimental UI (deprecated since 2022.1) -->
    <!-- <option name="expUIEnabled" value="false"/>-->
    <!-- File Status Colors enabled-->
    <option name="fileStatusColorsEnabled" value="false"/>
    <!-- Custom focus color when in Focus Mode -->
    <option name="focusColor" value="424242"/>
    <!-- Tab highlight color -->
    <option name="highlightColor" value="E91E63"/>
    <!-- Tab highlight thickness -->
    <option name="highlightThickness" value="2"/>
    <!-- Indicator Style (Border/Dot/Sharp/None) -->
    <option name="indicatorStyle" value="Border"/>
    <!-- Indicator Thickness -->
    <option name="indicatorThickness" value="2"/>
    <!-- Animated Tabs -->
    <option name="isAnimatedTabs" value="true"/>
    <!-- Bold Active Tab-->
    <option name="isActiveBoldTab" value="false"/>
    <!-- Tab highlight color enabled -->
    <option name="isHighlightColorEnabled" value="false"/>
    <!-- Compact menus -->
    <option name="isCompactMenus" value="false"/>
    <!-- Compact status bar enabled -->
    <option name="isCompactStatusBar" value="false"/>
    <!-- Compact table cells enabled -->
    <option name="isCompactTables" value="false"/>
    <!-- Compact fields enabled -->
    <option name="isCompactFields" value="false"/>
    <!-- Contrast mode enabled -->
    <option name="isContrastMode" value="false"/>
    <!-- Custom tree indent enabled -->
    <option name="isCustomTreeIndentEnabled" value="false"/>
    <!-- Focus Mode Enabled -->
    <option name="isFocusModeEnabled" value="false"/>
    <!-- High Contrast -->
    <option name="isHighContrast" value="false"/>
    <!-- Inverted Selection Color -->
    <option name="isInvertedSelectionColor" value="false"/>
    <!-- Old Material Design Style enabled -->
    <option name="isMaterialDesign2" value="false"/>
    <!-- Custom Wallpapers -->
    <option name="isMaterialWallpapers" value="true"/>
    <!-- Styled folders enabled -->
    <option name="isStyledDirectories" value="false"/>
    <!-- Animated tool windows enabled -->
    <option name="isAnimatedToolWindows" value="true"/>
    <!-- Tabs Shadow -->
    <option name="isTabsShadow" value="true"/>
    <!-- Notifications shadows -->
    <option name="useShadows" value="false"/>
    <!-- Tab Separators -->
    <option name="isTabSeparatorsEnabled" value="true"/>
    <!-- Whether to show the wizard at start -->
    <option name="isWizardShown" value="true"/>
    <!-- Show or hide the wizard option on welcome screen -->
    <option name="isShowWizardOnWelcome" value="true"/>
    <!-- Left tree indent  -->
    <option name="leftTreeIndent" value="6"/>
    <!-- Override accent color enabled -->
    <option name="overrideAccentColor" value="true"/>
    <!-- Override focus color enabled -->
    <option name="overrideFocusColor" value="true"/>
    <!-- Right tree indent  -->
    <option name="rightTreeIndent" value="6"/>
    <!-- Second Accent Color when in Accent Mode -->
    <option name="secondAccentColor" value="80CBC4"/>
    <!-- Selected Theme -->
    <option name="selectedTheme" value="OCEANIC"/>
    <!-- Last selected tab in the settings -->
    <option name="settingsSelectedTab" value="0"/>
    <!-- Show Overlays -->
    <option name="showOverlays" value="true"/>
    <!-- Large Tool Windows -->
    <option name="stripedToolWindowsEnabled" value="true"/>
    <!-- Show What's New Window on updates -->
    <option name="showWhatsNew" value="true"/>
    <!-- Status bar indicator (moved to a status bar context menu) -->
    <!-- <option name="statusBarTheme" value="true" /> -->
    <!-- Tab Highlight Position -->
    <option name="tabHighlightPosition" value="Default"/>
    <!-- Tab Opacity (deprecated) -->
    <!-- <option name="tabOpacity" value="50" /> -->
    <!-- Transparent scrollbars -->
    <option name="themedScrollbars" value="true"/>
    <!-- Custom Tab Font if enabled -->
    <option name="tabFont" value="Roboto"/>
    <!-- Tab Font Size -->
    <option name="tabFontSize" value="12"/>
    <!-- Tab Font Size Enabled -->
    <option name="tabFontSizeEnabled" value="false"/>
    <!-- Tab height -->
    <option name="tabsHeight" value="32"/>
    <!-- Custom Tree Font if enabled -->
    <option name="treeFont" value="Roboto"/>
    <!-- Project View Font Size -->
    <option name="treeFontSize" value="12"/>
    <!-- Project View Font Size Enabled -->
    <option name="treeFontSizeEnabled" value="false"/>
    <!-- Uppercase buttons -->
    <option name="uppercaseButtons" value="true"/>
    <!-- Bold and uppercase tabs enabled -->
    <option name="upperCaseTabs" value="false"/>
    <!-- Custom UI Font if enabled -->
    <option name="uiFont" value="Roboto"/>
    <!-- Colored Open Directories -->
    <option name="useColoredDirectories" value="false"/>
    <!-- Project Frame Custom Title -->
    <option name="useCustomTitle" value="false"/>
    <!-- Use Editor Default fonts enabled -->
    <option name="useGlobalFont" value="false"/>
    <!-- Custom UI Font enabled -->
    <option name="useMaterialFont2" value="false"/>
    <!-- Material wallpapers enabled -->
    <option name="useMaterialWallpapers" value="false"/>
    <!-- Project Frame -->
    <option name="useProjectFrame" value="false"/>
    <!-- Show Project Title in Project Frame -->
    <option name="useProjectTitle" value="true"/>
    <!-- Show Project Icon in Project Frame -->
    <option name="useProjectIcon" value="true"/>

Frequently Asked Questions

Q: I’ve updated the IDE/plugin to a new version, and now I get an error about the plugin failing to initialize?

A: It could come from multiple issues, but it could simply be a problem with the settings not being compatible to the new version. In that case, simply make a copy of the settings file, then delete the original file, and restart the IDE.

If the issue is gone, simply go back to the settings and go back to your previous configuration manually. If the issue persists, please report it in the Issues Section.

Q: I’ve removed the plugin, and still the background image persists!

A: This is an issue hard to resolve, because the Custom Wallpaper function is using the Set Background image function from the IDE behind the curtains. Therefore, removing the plugin might not remove the set image completely. If that occurs, you can remove the image by opening the Command Panel (Cmd-Shift-A/Ctrl-Shift-A) and type Set Background image and then manually remove the image, or go into Settings → Appearance → Background Image.

Q: What is that analytics option? What data are collected?

A: This is an option to allow sending data to Material Theme servers about users’ configuration, usage and trends. These metrics allow us to find out which features are most used or least used, in order to prioritize development of features, or maybe notify users about specific features, to provide better satisfaction.

These data are completely anonymous, and aren’t shared/sold to any third parties. If you want to stop sending data, simply turn off the option in the material_theme.xml.

Q: My settings are lost/jumbled up!

A: As the plugin evolves, sometimes settings are modified or removed, and as a result it can jumble your configuration files. We’re trying our best to limit such issues, but they can happen nonetheless.

If you find yourself being unable to use the plugin or even run the IDE, try to delete your configuration files, or at least try to delete specific properties until the IDE launches again.

Q: The wizard idea was great! But I’ve made a mistake, and the wizard won’t show up anymore!

A: The wizard shows only once and only when you don’t have the isWizardShown option set to true in the config file. But you can reopen it by simply clicking on the action from the Material Theme Toolbar, on the Features menu.

Q: Where have all the icons gone?

A: Since 5.0.0, the icons related settings have been moved to the Atom Material Icons plugin, another plugin developed by the Material Theme team. This is in order to encourage developers to develop Icon Themes, as the plugin is now free of icons.

Q: I’ve downloaded a theme from the Plugins Page, and now I’m seeing texts that aren’t themed, or checkboxes that are wrongly colored, etc…

A: This is because these are native themes, and such themes use the Theme API provided by JetBrains rather than the API used by the Material Themes. Even though the plugin tries to convert it to its own format, it won’t be as good as the originals. Still, it should be as similar as possible, so there shouldn’t be any critical issues. In that case, please report to the repository’s issues.

Q: I’ve bought a license, but I am still identified as a Free User!

A: That means that you haven’t activated your license yet. At the moment, the only way to do it, is to run the action to open the Registration Modal.

Activate License
Activate License

Important note: Android Studio users, in order to activate the plugin (or any paid plugin), you need to install a plugin first: