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.

Requirements

Chrome with Manifest V3 extension support. Edge and Brave are Chromium browsers, so they can add Bookmark Scope from its Chrome Web Store page. It is not listed on Edge Add-ons yet, and I only test with Chrome. An experimental Firefox build also exists; see Firefox (experimental) . Safari is not supported.
No account and no sign-in. Bookmark Scope has no server component.

Option A: Chrome Web Store

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.

Older releases

This guide describes the current release. If Chrome's install prompt asks for access to all websites up front, you are looking at an older release that predates the optional site-access model described in Link health. Update to a current release to match this guide.

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://extensions and turn on Developer mode (top right).
Load the extension folder. Choose Load unpacked and select the folder named extension inside the repository you just downloaded. It is the folder that directly contains manifest.json and the pages folder. 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 (experimental)

There is an experimental Firefox build. It is not on Firefox Add-ons yet, so you load it by hand from the GitHub Releases page. It was tested on Firefox 157 on Windows. Other systems are not tested.

Check your Firefox. You need desktop Firefox 140 or newer. Firefox for Android is not supported.
Download the zip. Open the GitHub Releases page (opens in a new tab) and download bookmark-scope-<version>-firefox.zip from 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-firefox in 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.json inside.

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 (Library tools → Export snapshot), because the extension's own data, such as tags and saved views, may not be kept. A permanent install needs a signed add-on, which does not exist yet.

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 Chrome'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	Chrome updates it automatically in the background. To check now, 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 (experimental)	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 (Library tools → Export snapshot). A snapshot file includes your folder tree and tags. See Backup and restore.

Clearing only some data

Link-health cache: Library 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.