Skip to content

Instantly share code, notes, and snippets.

@tsukii-hoshino
Last active December 8, 2025 05:26
Show Gist options
  • Select an option

  • Save tsukii-hoshino/af9ada8511592fcdf0a8d3e18470e594 to your computer and use it in GitHub Desktop.

Select an option

Save tsukii-hoshino/af9ada8511592fcdf0a8d3e18470e594 to your computer and use it in GitHub Desktop.
Backup Essentials and Pinned Tabs of a Profile for Zen Browser

i took some information from the official docs of Zen Browser: here

You wanna change computer, or installing another OS, but Zen Browser doesn't save all the Pinned Tabs and Essentials that will surely be really tedious to setup all over again??

Worries not, I've got you covered!

1. locate your profile folder

go to about:profiles (type it into your address bar)
find your profile and look for the Root Directory

about:profiles

it's /home/lunaris/.zen/[...] for me
it will be different depending on your operating system!

Warning

close zen browser to avoid corruptions

anyway, now open that directory, it will look something like this:

folder

(sorry for flashbang)

2. very important things to know

now you need to know what to copy

  • storage folder: addons customizations (this might not work 100% of the time)
  • chrome folder: interface customizations
  • places sqlite: bookmarks and history, and related to Essentials and Pins
  • cookies sqlite: login sessions
  • cert9.db + key4.db + logins.json: saved passwords
  • extension-preferences.json + extensions.json + extension-settings.json + extensions folder: installed addons, not their settings
  • search.json.moziz4: search engine preferences
  • sessionCheckpoints.json + sessionstore.jsonlz4: currently opening tabs, and their icons (important for essentials and pins)
  • prefs.js: about:config (advanced configurations) settings
  • storage sqlite: essentials aren't saved without this
  • containers.json: containers (the thing that allows you to use multiple accounts at once)
  • zen-keyboard-shortcuts.json: custom keyboard shortcuts in Settings

the result will look something like this:

result

(sorry for flashbang again)

3. after that... testing!

Note

you can definitely skip this step, but i suggest to still follow it, in case there are any data loss.

get back to about:profiles and click Create a new Profile,
there will be a Create profile wizard window popping up, it looks like this:

20250818_12h34m25s_grim

after that just press Next, set the profile name if you want, and then press Finish!
then there will be a new profile:

20250818_12h36m57s_grim

go to the Root Directory of it again,
delete everything in it (if there are any),
Copy paste the files and folders that you got from step 2!

open Zen Browser again on that newly created profile and check if there's anything missing,
if not, let's move on to step 4

4. on a newly installed zen...

when you open zen for the first time on a computer, it should greet you with the setup of a new profile
you can complete this, but personally i would close the browser at the first screen as it has already created the essential profile folder for us at this step

anyways, go to the profile folder again,
delete everything in it and paste the backup files from step 2

after that open zen on the new profile, you can see it will generate the other necessary files automatically for us


if you have any questions or suggestions, please comment down below..
and give me a star if you found it useful, thank you! <3

good luck migrating!! :D

@Stupid-Noob-Scripter
Copy link

because of this I finally switched back to windows, goodbye linux

@luftaquila
Copy link

Thank you for the great guide. I can confirm it works at the latest Zen 1.16b.

Also, zen-keyboard-shortcuts.json is for the keyboard shortcuts in case you need.

@tsukii-hoshino
Copy link
Author

Thank you for the great guide. I can confirm it works at the latest Zen 1.16b.

Also, zen-keyboard-shortcuts.json is for the keyboard shortcuts in case you need.

I'm glad you found it helpful!

Thank you for the confirmation, and I'll add the keyboard shortcuts file in right away!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment