Last updated: 08/01/2023
26% of users voted this helpful
Firefox supports a wide range of customization options that are well-suited to all skill levels. The toolbar layout can be customized, numerous settings can be configured, and the Mozilla Add-ons directory contains a massive library of extensions and themes to add additional functionality and make Firefox reflect your own needs and personality.
Two other forms of advanced configuration allow even further customization: about:config preference modifications and userChrome.css or userContent.css custom style rules. However, Mozilla highly recommends that only the developers consider these customizations, as they could cause unexpected behavior or even break Firefox.
Firefox is a work in progress and, to allow for continuous innovation, Mozilla cannot guarantee that future updates won’t impact these customizations. For this reason, Mozilla does not officially support adding custom style rules with a userChrome.css or userContent.css file, or using the about:config configuration editor to modify preference settings.
If Firefox suddenly appears broken after an update, you may need to use the Refresh feature to restore Firefox to a default state while keeping important data. Alternatively, you can selectively reverse your advanced customization and configuration changes, as follows:
- To reverse changes you made to Firefox with a userChrome.css or userContent.css file, use about:config to reset the preference toolkit.legacyUserProfileCustomizations.stylesheets to false and then remove (or rename) the userChrome.css or userContent.css file located inside the chrome folder in your Firefox profile folder. This also applies to Thunderbird. Please refer to Thunderbird's article: userChrome.css and .js and userContent are unsupported
- To reset all preference modifications, either use about:config to reset all modified preferences or else delete the preference file(s) in your profile folder, as explained here, to restore all preferences to default settings.
