All guides
No guide matches your search.
Installation, updates and removal
Two ways to install, how updates behave, what survives an update, and exactly what happens to your data when you uninstall.
On this page
Requirements
- Chrome or Edge version 114 or newer. Brave can add Bookmark Scope from its Chrome Web Store page. Firefox is supported too; see Firefox. Safari is not supported.
- No account and no sign-in. Bookmark Scope has no server component.
Option A: Chrome Web Store, Edge Add-ons or Firefox Add-ons
- Find it. Open the Bookmark Scope – Domain & Page Manager listing (opens in a new tab) in the Chrome Web Store. The project's GitHub repository (opens in a new tab) is the other place to confirm you have the right extension.
- Add it. Choose Add to Chrome and read Chrome's permission prompt before you confirm. The permissions Bookmark Scope declares are listed in Privacy, permissions and data.
- Pin it. Open the Extensions menu (puzzle piece) and pin Bookmark Scope.
In Edge, open the Edge Add-ons listing (opens in a new tab), choose Get, and confirm. The rest is the same.
Older releases
If Chrome's install prompt asks for access to all websites up front, you have an older release. Update it to get the optional site access described in Link health.
Option B: Load unpacked (from source)
Use this to try a build from the public repository, or to review exactly what runs.
- Get the files. Download the repository as a ZIP from GitHub and extract it, or clone it with Git:
git clone https://github.com/ehsanenaloo/Bookmark-Scope.git - Open the extensions page. Go to
chrome://extensionsand turn on Developer mode (top right). - Load the extension folder. Choose Load unpacked and select the folder named
extensioninside the repository you just downloaded. It is the folder that directly containsmanifest.jsonand thepagesfolder. Do not select the top folder of the repository.
You should see
a card named Bookmark Scope – Domain & Page Manager with the version number and no error badge. If Chrome shows Manifest file is missing or unreadable, you most likely selected the top folder of the repository (or a folder inside extension) instead of the extension folder itself.
Note
An unpacked copy gets its own extension ID, so it can be installed next to the Web Store version. The two do not share data: tags, saved views and settings are separate. An unpacked extension also depends on the folder staying where it is. If you move or delete the folder, Chrome disables the extension. Your bookmarks are never affected, but see Uninstalling and your data for what happens to Bookmark Scope's own data.
Firefox
Install it from the Firefox Add-ons listing (opens in a new tab) and choose Add to Firefox. You need desktop Firefox 140 or newer. Firefox for Android is not supported. It was tested on Firefox 157 on Windows. Other systems are not tested.
To try a build that is newer than the listing, load it by hand:
- Download the zip. Open the GitHub Releases page (opens in a new tab) and download
bookmark-scope-<version>-firefox.zipfrom the newest release. Do not use the zip without "firefox" in its name. That one is for Chrome. - Open the debugging page. Type
about:debugging#/runtime/this-firefoxin the address bar and press Enter. - Load the add-on. Click Load Temporary Add-on and choose the zip file. You can also unzip it and choose the
manifest.jsoninside.
Temporary add-ons
Firefox removes a temporary add-on when it closes, so you need to load it again each time you start Firefox. Your bookmarks are never affected. To be safe, export a snapshot first (Tools → Export snapshot), because the extension's own data, such as tags and saved views, may not be kept. The listing on Firefox Add-ons is a permanent install.
The Firefox build uses the same code as the Chrome build, with a few differences: there are no site icons in the lists, and the buttons that open the browser's bookmark manager are hidden. See Does it work in Firefox, Edge or Brave? for the full list.
Pinning and quick access
Pin the extension from the Extensions menu. Chrome also lets you assign a keyboard shortcut to an extension's toolbar button at chrome://extensions/shortcuts. That is a Chrome feature rather than something Bookmark Scope adds, and Bookmark Scope does not ship a default shortcut.
Updating
| How you installed | How it updates |
|---|---|
| Chrome Web Store, Edge Add-ons or Firefox Add-ons | The browser updates it automatically in the background. To check now in Chrome, open chrome://extensions, turn on Developer mode and use Update. |
| Load unpacked | Replace the folder contents (or run git pull), then press the reload icon on the extension's card. |
| Firefox, loaded by hand | There is no automatic update. Download the newer zip from the GitHub Releases page and load it again on about:debugging. |
Your data survives updates. On startup Bookmark Scope checks its stored data format (currently schema version 7), fills in defaults for anything new and keeps your tags, saved views, history and preferences. One deliberate exception: cached link-health results from before a format change may be discarded and are rebuilt the next time you run a scan. They are only a cache.
Uninstalling and your data
To remove the extension, open chrome://extensions and choose Remove.
| What | After you uninstall |
|---|---|
| Your bookmarks, folders and their order | Unchanged. They belong to the browser, not to the extension. |
| Bookmark Scope tags, saved views, link-health results, history, settings, recovery journals | Removed. Chrome deletes an extension's stored data when it is uninstalled. Tags are stored by the extension, not in the bookmark itself, so they do not survive. |
| Optional site access you granted for link checks | Removed together with the extension. |
Before you uninstall
If you want to keep your tags, export a snapshot first (Tools → Export snapshot). A snapshot file includes your folder tree and tags. See Backup and restore.
Clearing only some data
- Link-health cache: Tools → Clear cached health data . Bookmarks are untouched.
- Preferences: Settings → Reset defaults restores nine preferences (see Settings reference ). It does not remove tags, saved views, history or scan settings.
- Site access: revoke it any time from the extension's Details page at
chrome://extensions. The exact wording of Chrome's site-access controls is up to Chrome.
Was this page helpful?