Skip to content
Eason Wong edited this page Nov 13, 2026 · 3 revisions

Customisation and Configuration Guide

Guides and snippets for customising Firefox CSS themes and browser configuration when using Adaptive Tab Bar Colour.

How to Apply Custom CSS

To apply custom CSS rules (userChrome.css) to Firefox:

  1. Open about:config in the address bar and press Enter.
  2. Search for toolkit.legacyUserProfileCustomizations.stylesheets and set it to true.
  3. Open about:support in the address bar.
  4. Locate Profile Directory (or Profile Folder) and click the Open Directory (or Open Folder) button.
  5. Create a new folder named chrome in your profile directory if it does not already exist.
  6. Inside the chrome folder, create a text file named userChrome.css.
  7. Paste your custom CSS rules into userChrome.css and save the file.
  8. Restart Firefox.

Customising Colour Transitions

Firefox applies a default transition effect to tab bar colour changes.

Instant Colour Updates

To disable transitions and allow colours to update instantaneously, add the following to userChrome.css:

:root {
	--ext-theme-background-transition: none !important;
	--inactive-window-transition: none !important;
}

Smooth Colour Transitions

To enable smooth colour transitions across the browser toolbox, tabs, and URL bar, add the following to userChrome.css (thanks to @Moarram):

body, findbar, #navigator-toolbox, #TabsToolbar, #nav-bar, #PersonalToolbar, #sidebar-box, .tab-background, .urlbar-background {
	transition:
		background-color 0.5s cubic-bezier(0, 0, 0, 1) !important,
		border-color 0.5s cubic-bezier(0, 0, 0, 1) !important,
		outline 0.5s cubic-bezier(0, 0, 0, 1) !important;
}

Smooth Transitions in Sidebery

To enable smooth colour transitions in the Sidebery sidebar add-on, add the following to the Sidebery Style Editor (thanks to @MaxHasBeenUsed):

.Sidebar, .bottom-space {
	transition: background-color 0.5s cubic-bezier(0, 0, 0, 1) !important;
}

Adaptive Context Menus

To apply the adaptive theme to context menus and pop-up panels, add the following to userChrome.css:

:is(menupopup, panel):where(:not([type="arrow"])) {
	--panel-background-color: unset !important;
	--panel-border-color: unset !important;
}

On Linux, disable native context menus by opening about:config and setting widget.gtk.native-context-menus to false.

Compatibility with Third-Party CSS Themes

A third-party CSS theme works with Adaptive Tab Bar Colour as long as it uses Firefox’s standard colour variables (such as --lwt-accent-color for the tab bar background).

For an example of an ATBC-compatible CSS theme, see Firefox-Simple-One-Line.

Title Bar Buttons on Linux with GTK Theme

On Linux systems using a GTK theme, Firefox’s title bar buttons may revert to the Windows style.

To prevent this, access about:config and set widget.gtk.non-native-titlebar-buttons.enabled to false. (Thanks to @anselstetter)