> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bkmark.it/llms.txt
> Use this file to discover all available pages before exploring further.

# Using the Bkmark Extension: Shortcuts and Features

> Save pages with a shortcut or a click, right-click any link, highlight text to capture snippets, and customize how the extension fits your workflow.

Once the Bkmark extension is installed and you are signed in, you have several ways to save content — a keyboard shortcut, a toolbar click, or a right-click menu. Each method opens the same save form so you can always add a title, description, tags, and groups before confirming.

## Save the current page with the keyboard shortcut

The fastest way to save any page is the built-in keyboard shortcut. Press it from anywhere in your browser and the Bkmark popup opens, pre-filled with the current page's URL and title.

| Platform            | Shortcut               |
| ------------------- | ---------------------- |
| **Windows / Linux** | `Ctrl` + `Shift` + `B` |
| **Mac**             | `Cmd` + `Shift` + `B`  |

<Steps>
  <Step title="Press the shortcut on any page">
    Hit `Ctrl+Shift+B` (or `Cmd+Shift+B` on Mac). The Bkmark popup opens with the URL and page title already filled in.
  </Step>

  <Step title="Review and edit the details">
    The popup lets you adjust the **Title**, add an optional **Description**, assign **Tags**, and choose one or more **Groups**. You can also type a new tag or group name directly — Bkmark creates it on the fly when you save.
  </Step>

  <Step title="Click 'Save Bookmark'">
    Click the **Save Bookmark** button. A "Bookmark saved!" confirmation appears and the popup closes after a moment. The extension icon badge shows a ✓ to confirm the current page is in your library.
  </Step>
</Steps>

<Tip>
  If the page is already in your Bkmark library, the popup shows an **Already saved** badge near the top. You can still save it again to a different group or with different tags.
</Tip>

## Open the popup by clicking the toolbar icon

You can also click the Bkmark icon in your browser toolbar to open the popup at any time.

<Steps>
  <Step title="Click the Bkmark icon">
    Find the Bkmark icon in your toolbar (pin it first if you have not — see the [install guide](/extension/install)). Click it to open the popup.
  </Step>

  <Step title="Choose a bookmark type">
    At the top of the form, three type buttons let you switch between **Link** (a web page), **Note** (freeform text), and **Code** (a code snippet). The default is **Link**, which pre-fills the active page's URL.
  </Step>

  <Step title="Fill in the details and save">
    Edit the title and description as needed, add tags and groups, then click **Save Bookmark**.
  </Step>
</Steps>

<Note>
  The popup also has a footer link — **Open Dashboard →** — that takes you directly to your Bkmark dashboard in a new tab.
</Note>

## Right-click to save a page or any link

The extension adds two items to your browser's context menu so you can save content without opening the popup at all.

<Steps>
  <Step title="Right-click anywhere on a page or on a link">
    * To save the **current page**, right-click an empty area of the page and choose **Save to bkmark.it**.
    * To save a **specific link**, right-click the link text or URL and choose **Save to bkmark.it**.
  </Step>

  <Step title="The bookmark is saved immediately">
    The extension saves the target URL in the background using the page title as the bookmark title. No popup appears — the extension icon badge updates to ✓ once the save completes.
  </Step>
</Steps>

<Tip>
  Right-clicking on **selected text** shows a third option: **Save highlight to bkmark.it**. This saves the current page URL with your selection as the description. If the selected text looks like code (for example, on GitHub or Stack Overflow), Bkmark automatically sets the type to **Code**.
</Tip>

## Customize the keyboard shortcut

If `Ctrl+Shift+B` conflicts with another shortcut on your system, you can change it in your browser settings.

<Tabs>
  <Tab title="Chrome">
    <Steps>
      <Step title="Open the extensions shortcuts page">
        In the Chrome address bar, type `chrome://extensions/shortcuts` and press Enter.
      </Step>

      <Step title="Find Bkmark">
        Scroll to the **bkmark.it** section. You will see the **Save current page to bkmark.it** command.
      </Step>

      <Step title="Set a new shortcut">
        Click the pencil icon next to the current shortcut, then press your preferred key combination. Chrome saves it immediately.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Firefox">
    <Steps>
      <Step title="Open the Add-ons Manager">
        Click the Firefox menu (☰) and choose **Add-ons and themes**, or press `Ctrl+Shift+A`.
      </Step>

      <Step title="Navigate to keyboard shortcuts">
        Click the gear icon (⚙) near the top of the Add-ons Manager page and select **Manage Extension Shortcuts**.
      </Step>

      <Step title="Update the Bkmark shortcut">
        Find **bkmark.it** in the list, click into the shortcut field for **Save current page to bkmark.it**, and press your preferred key combination.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## How the content script works

The extension loads a lightweight content script on every page you visit. It has two responsibilities:

* **Selection detection** — When you use the right-click **Save highlight** menu, the content script reads the text you have selected and passes it to the extension, which then calls the Bkmark API to save it.
* **Type detection** — The extension analyses your selected text to decide whether it is a plain **Note** or a **Code** snippet. It checks the hostname of the page (GitHub, GitLab, Stack Overflow, CodePen, and others are treated as code hosts) and scans the text for common code syntax patterns. You can always override the detected type manually inside the popup.

<Tip>
  The content script only reads text when you actively trigger a save action. It does not monitor your keystrokes, form inputs, or any other page activity.
</Tip>

## Import your existing browser bookmarks

The popup includes a full bookmark importer so you can migrate your existing browser bookmarks to Bkmark in one go.

<Steps>
  <Step title="Open the popup and click 'Import Bookmarks'">
    Click the Bkmark toolbar icon to open the popup, then click the **Import Bookmarks** link in the footer.
  </Step>

  <Step title="Select the folders to import">
    The importer reads your browser's bookmark folders and displays them in a tree view with bookmark counts. Check the folders you want to import, or use **Select All** to include everything.
  </Step>

  <Step title="Click 'Import Selected'">
    Click **Import Selected**. The extension uploads the bookmarks to your Bkmark library. A progress screen shows the status, and a completion screen confirms how many bookmarks were imported and how many were skipped as duplicates.
  </Step>
</Steps>

<Note>
  The importer requires the **Bookmarks** permission that was granted during installation. Your existing browser bookmarks are never modified or deleted — Bkmark only reads them.
</Note>