Tips

This preset has a few changes you can make to your user.js that will make your Firefox-based experience on Linux much more polished.

Master Quick Append

Copy the whole thing, or pick out the lines you want. Each line has a short comment explaining what it does; the value after // is the default.

user.js

// Mouse Scrolling
user_pref("mousewheel.default.delta_multiplier_x", 200); // 100 — mousewheel speed (higher = faster)
user_pref("mousewheel.default.delta_multiplier_y", 200); // 100
user_pref("mousewheel.default.delta_multiplier_z", 200); // 100
user_pref("general.autoScroll", true); // false — middle-click autoscroll (off on Linux by default)

// Touchpad Scrolling 
user_pref("apz.fling_friction", "0.004");         // "0.002" — trackpad scroll drag (higher = stops sooner)
user_pref("apz.gtk.pangesture.delta_mode", 2);    // Default 0. 2 respects display scaling
// Touchpad speed — prefer a system-wide fix instead
// user_pref("apz.gtk.pangesture.pixel_delta_mode_multiplier", "7"); // Default "40.0". Trackpad-only speed

// Other Settings
user_pref("browser.tabs.hoverPreview.enabled", true);           // false — show tab preview on hover
user_pref("browser.tabs.hoverPreview.showThumbnails", true);    // false — include a thumbnail in that preview

// Zen Browser–specific settings
user_pref("zen.workspaces.separate-essentials", false);    // true — share essentials across all workspaces
// user_pref("zen.view.show-newtab-button-top", false);    // true — move new-tab button to top of tab list
user_pref("browser.tabs.fadeOutUnloadedTabs", true);       // false — dim inactive/unloaded tabs

Prefer a system-wide touchpad fix

Adjusting touchpad scroll speed at the system level applies everywhere, not just in Firefox (usually the better option). See the touchpad scrolling sensitivity fix on our External Resources page. The commented apz.gtk.pangesture.* lines are only for tweaking trackpad behaviour inside Firefox specifically.

Flatpak Zen

If you installed Zen via Flatpak, its profile folder isn't reachable from about:support. Find it (and place your user.js) under ~/.var/app/app.zen_browser.zen/.zen/XXXXX/, where XXXXX is your profile ID.

How to append changes

Method 1: user.js config file (faster)

• Create a user.js by typing "about:support" into your browser and clicking "Open Directory" in the Profile Directory row.

  

• Inside your profile folder, you can create a file named user.js if it does not exist already. You can append changes from this guide into user.js.

Method 2: "about:config"

• Type in "about:config" into your browser and you'll be taken to the Firefox advanced preference page. Press "Accept risk and continue".

  

• You can then type in the search bar the preference mentioned in the guide, edit the values of the preference, and create the reference if it doesn't exist.

Contributors

aier9500Lunear01

Changelog

7/24/26, 2:07 PM

View All Changelog

• 852ba-user.js simplification and readded missing show thumbnail key in the master quick append.on 7/24/26
• af775-update Firefox user.js settings and remove Kando integration staron 7/15/26
• 19622-batch grammar fix (en_gb)on 7/12/26
• 59254-Add Flatpak Zen profile-path warning to user.js guide.on 6/19/26
• 600be-New tabs in Zen to the bottom.on 6/10/26
• 90fcc-Updating suggestions for Firefox and Zen Browser to be more up to date with newer releases and the added Gnome touchpad scrolling resource on the wiki.on 6/10/26
• 31202-Added tagon 5/13/26
• 00c9a-#39 Reformat project so each markdown file has their own asset subfolder in the public asset folder.on 4/30/26
• 2348f-Grammatical adjustmentson 4/12/26
• b7cae-Grammatical correctionson 12/21/25
• 54c8f-Restructuring for better asset management.on 12/10/25
• 5810a-Cleaner way of displaying contributors in articles.on 12/9/25
• 26c5a-Restructuring tags.on 11/10/25
• d4310-Workspace independent essentials for Zen Browser users.on 10/5/25
• eebdc-Updating settings.on 8/29/25
• 0ab32-Consistent heading stylingon 7/16/25
• 0228f-Refactor documentation for improved clarity and consistency in formattingon 7/15/25
• 6f292-Enhance markdown formatting for consistency across documentationon 7/12/25
• 46131-Implement code changes to enhance functionality and improve performanceon 7/12/25
• b8933-Using fewer tags for better tag sorting.on 7/5/25
• 8b341-Remove co-author card from Firefox user.js guideon 6/24/25
• e2f6b-Refactor guide authorship sections: update titles from "Maintainer" to "Author(s)" and "Contributors" to "Co-author(s)" across multiple guideson 6/13/25
• daeb8-Enhance documentation by adding missing line breaks, updating demo wrappers to include images, and refining contribution guidelines for clarity and consistency.on 6/12/25
• 686d1-Enhance formatting and clarity in Firefox user.js and Terminal customization guideson 6/11/25
• 357ef-Consistency fixon 6/10/25
• 0e14f-Added contributors to blogson 6/10/25
• 573fd-Tagging/untagging.on 6/9/25
• 62c4b-Automating steps.on 6/8/25
• 731c5-Microtweakson 6/7/25
• 0ed49-Mass renamingon 6/7/25
• 41f78-deleting legacy metadataon 5/31/25
• 25920-Restructuringon 5/30/25
• 64610-Notes and sidebar work nowon 5/30/25
• d95ee-Notes & sidebard don't work for some reason...on 5/30/25
• a154c-testing sidebar generationon 5/30/25
• 78ee4-typoon 5/29/25
• 63f60-Draft ongoingon 5/29/25
• fb788-under-construction addedon 5/29/25
• ac353-v1on 5/28/25
• 85907-Better lookson 5/28/25
• 718fb-Aesthetic changeson 5/28/25