Skip to content

Config Options

Jump to bottom
zedd edited this page Feb 15, 2026 · 20 revisions

An interactive configurator is available at https://zapsnh.github.io/zcpt-configurator/. To apply the settings, place the exported user.js file in your profile folder/directory (Profiles > XXXXXXXX.profile), launch Firefox, and then delete it afterwards.

For the WebExtension version, the configurator is can be found in the extension's option page. The settings apply after you click Apply.

Note

Make sure you're creating these configs as a Boolean and not as a String

Context menus

In about:config, if you want native (Windows) context menus, you can create:

Config Name Result Image
uc.contextmenu.win-10 Windows 10 styled menu image
uc.contextmenu.win-11 Windows 11 styled menu, Also kinda looks the GNOME context menu image
uc.contextmenu.dark Makes the context menu dark image image
uc.contextmenu.light Makes the context menu light image image

If you don't set uc.contextmenu.light or uc.contextmenu.dark, then the context menu will take the colors from the theme:

Windows 11 style context menu with the dark Alpenglow theme

Megabar

In about:config, if you want to reduce the megabar or disable it, create:

Config Name Result Image
none Default Photon Megabar normal
uc.reduced-megabar Slightly smaller Proton-sized Megabar reducedmegabar
uc.no-megabar No megabar nomegabar

Themes

For themes where the tab color and navbar color are different (and for people who want them to be the same), go to about:config and create:

Config Name Result Image
none Default behavior

Top: Theme in Proton
Bottom: Theme with config		 Normal
uc.theme.tab-color-same-as-navbar Tab color takes the navbar color

Top: Theme in Proton
Bottom: Theme with config		 Navbar Color
uc.theme.navbar-color-same-as-tab Navbar color takes the tab color

Top: Theme in Proton
Bottom: Theme with config		 Tab Color

Sidebery

There is basic support for Sidebery. You can turn it on with:

Config Name Result Image
uc.sidebery Vertical Tabs image

Notes

  • You will need to insert this into Sidebery's style editor.
  • To be able to switch between vertical tabs mode and normal mode, turn on Add preface to the browser window's title if Sidebery sidebar is active and set the preface value to [VT] (incl. space at the end).
  • Using uc.reduced-megabar or uc.no-megabar is recommended.
  • Set the font-size to XXS under the Appearance section. (where?)
  • Set the theme to plain under the Appearance section. (where?)
  • Set the density to relaxed under the Appearance section. (where?)

Bottom Tabs

In about:config, you can turn on bottom tabs with:

Config Name Result Image
uc.bottom-tabs Bottom Tabs bottombook
uc.bottom-tabs.bookmark-on-top Bottom Tabs with bookmarks on top topbook

Notes

  • Using uc.reduced-megabar or uc.no-megabar is recommended.

New Tab Background

In about:config, you can turn on a new tab background with:

Config Name Result Image
uc.newtab.background New tab background image

Notes

  • For Firefox 127 (nightly) and above, you can also enable this pref without an image in the chrome/resources folder alongside a new tab wallpaper.
  • Add background.png in the resources folder with your own PNG image.

Full Width Tabs

In about:config, you can turn on full width tabs with:

Config Name Result Image
uc.full-width-tabs Full width tabs
Can be coupled with uc.bottom-tabs if you want the 🤮Safari🤮 look.		 image

Styled HTML Forms

In about:config, you can enable HTML Form styling with:

Config Name Result Image
uc.style-forms HTML Form styling uc style-forms

Notes

  • May break HTML Form styling on websites.

Revert the All Tabs Button Behavior

In about:config, you can revert the all tabs button behavior with:

Config Name Result Image
uc.revert-all-tabs-behavior Only shows the all tabs button when the tab bar is overflowing just like pre-Photon/early-Proton uc revert-all-tabs-behavior

Always show tab close button

In about:config, you can always show the tab close button with:

Config Name Result Image
uc.always-show-close-button Always shows the tab close button even when the tabs are small. image

Firefox quantum logos

In about:config, you can swap the current Firefox logos with the older ones with:

Config Name Result Image
uc.logo.quantum Pre-Firefox 70 quantum logos everywhere. image
uc.logo.quantum.beta Uses the beta quantum logos. (requires uc.logo.quantum) image
uc.logo.quantum.dev Uses the developer edition quantum logos. (requires uc.logo.quantum) image
uc.logo.quantum.nightly Uses the nightly quantum logos. (requires uc.logo.quantum) image

Toolbar Transparency

In about:config, you can enable toolbar transparency effects with:

Config Name Result Image
uc.toolbar.transparency Makes the toolbar transparent to allow transparency effects such as Mica or Acrylic.
(effects can be configured using programs such as MicaForEveryone).		 image

Menu Transparency

In about:config, you can enable menu transparency effects with:

Config Name Result Image
uc.popups.transparent Transparent menus for Windows 11 and macOS (untested). image

Notes

  • Set widget.windows.mica.popups to 2 if you're using Windows 11.

Popup Fading

In about:config, you can disable menu fading effects with:

Config Name Result Image
uc.popups.disable-transition No popup fading n/a

Force disable accent color on titlebar with system themes

In about:config, you can disable disable accent color on titlebar with system themes with:

Config Name Result Image
uc.toolbar.force-disable-accent-color Force disables toolbar accent coloring on system themes. n/a

zcpt

Clone this wiki locally