zen docsLive Editing Zen Theme
Learn how to live edit the appearance of Zen Browser by editing the userChrome.css file.
This Guide will help you customize the appearance of Zen Browser by live editing the userChrome.css file. Follow the steps below to start customizing your browser's theme.
Step 1: Access the Profile Folder
On the Flatpak version of Zen, the profile folder will be located at ~/.var/app/app.zen_browser.zen/.zen.
- Open Zen Browser.
- Type
about:supportin the address bar and press Enter. - Look for the Application Basics section.
- Click on Open Profile Folder. This will open the folder where Zen Browser stores your user data.
Step 2: Create the chrome Folder
- In the Profile Folder, create a new folder and name it
chrome. - Inside the
chromefolder, create a new blank file nameduserChrome.css. - Restart Zen Browser to apply the changes.
Step 3: Open Style Editor in Zen Browser
How do I enable the Browser Developer Tools?
After Zen Browser version 1.0.0-a.31 the Browser Developer Tools is disabled by default for security.
- Open the
about:configpage. This page contains advanced settings for the browser. - Search for
devtools.debugger.remote-enabledand toggle it totrue. - Search for
devtools.chrome.enabledand toggle it totrue. - Search for
toolkit.legacyUserProfileCustomizations.stylesheetsand toggle it totrue. This setting is required foruserChrome.cssto work.
- In Zen Browser, press Ctrl+⇧+Alt+I to open the Developer Tools.
- Navigate to the Style Editor tab.
- In the filter/search bar, type
userChrometo locate theuserChrome.cssfile you created earlier.
Step 4: Edit the userChrome.css File
If a style does not apply as expected, try adding the !important keyword at the end of the CSS rule. This forces the browser to apply the style regardless of any other existing styles.
Tip
If you wish to edit pop-ups or menus that automatically hide, be sure to enable the Disable Popup Auto-Hide option from the Browser Toolbox settings menu ( ⋯ button )
- The
userChrome.cssfile should now be visible in the Style Editor. - You can start editing the file directly within the Style Editor.
- Note: You can use the Inspect button to hover over and select elements on the page. This allows you to learn about the
id,class, or other attributes of elements, which you can then target in youruserChrome.cssfile.
- Note: You can use the Inspect button to hover over and select elements on the page. This allows you to learn about the
- To apply your changes, save the file by clicking Save or by pressing Ctrl+S.
Any changes you make to the userChrome.css file will be applied immediately to Zen Browser.
Use this file to customize various UI elements, such as colors, fonts, and the layout.
You can use this guide to help you create your Zen theme and publish it.
This guide is designed to help you quickly and efficiently customize your Zen Browser experience. Happy theming!