> ## 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.

# Save, Organize, and Manage Your Bookmarks in Bkmark

> Save links, notes, code snippets, and images in one place. Organize with tags and groups, track reading status, and recover anything from the trash.

Bookmarks are the heart of Bkmark. Every item you save — whether it's a web page, a quick note, a block of code, or an image — lives in your bookmark library where you can search, filter, and organize it however you like.

## Bookmark types

Bkmark supports four distinct bookmark types, each designed for a different kind of content.

<Tabs>
  <Tab title="Link">
    A **link** bookmark saves any web URL. When you create one, Bkmark automatically fetches the page title, description, and a preview image so you don't have to fill anything in manually.

    **Create a link bookmark**

    <Steps>
      <Step title="Click 'New Bookmark'">
        Press the **+** button in the toolbar, or use the keyboard shortcut `N`.
      </Step>

      <Step title="Paste the URL">
        Type or paste the full URL into the URL field. Bkmark fetches the page metadata in the background.
      </Step>

      <Step title="Add optional details">
        Override the auto-fetched title or description if you want, then assign tags and groups.
      </Step>

      <Step title="Save">
        Click **Save** — your link appears in your library immediately.
      </Step>
    </Steps>

    <Tip>
      If you already saved the same URL, Bkmark warns you about the duplicate before saving. You can choose to save it anyway if you want multiple copies.
    </Tip>
  </Tab>

  <Tab title="Note">
    A **note** bookmark lets you capture rich text — ideas, meeting notes, research summaries — directly inside Bkmark without needing a separate tool.

    **Create a note bookmark**

    <Steps>
      <Step title="Choose the Note type">
        Click **+ New Bookmark**, then select **Note** from the type selector.
      </Step>

      <Step title="Write your content">
        Give it a title and write your note in the rich-text body. Formatting like bold, italics, and bullet lists is supported.
      </Step>

      <Step title="Organize and save">
        Assign tags and groups, then click **Save**.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Code Snippet">
    A **code snippet** bookmark preserves blocks of code with syntax highlighting so you can find and reuse them later.

    **Create a code snippet bookmark**

    <Steps>
      <Step title="Choose the Code type">
        Click **+ New Bookmark**, then select **Code** from the type selector.
      </Step>

      <Step title="Paste your code">
        Add a descriptive title, paste your code into the editor, and select the programming language for accurate syntax highlighting.
      </Step>

      <Step title="Save">
        Tag it (e.g., `python`, `react`, `sql`) and click **Save** for easy retrieval later.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Image">
    An **image** bookmark saves a direct link to any image URL, giving you a visual reference library.

    **Create an image bookmark**

    <Steps>
      <Step title="Choose the Image type">
        Click **+ New Bookmark**, then select **Image** from the type selector.
      </Step>

      <Step title="Paste the image URL">
        Provide the direct URL to the image file. Bkmark fetches a preview automatically.
      </Step>

      <Step title="Save">
        Add a title, tags, and groups if needed, then click **Save**.
      </Step>
    </Steps>
  </Tab>
</Tabs>

***

## Bulk operations

When you need to organize, move, or clean up many bookmarks at once, bulk operations let you act on up to **500 bookmarks** in a single action.

<Steps>
  <Step title="Select bookmarks">
    Check the checkbox on any bookmark card to enter selection mode. Continue checking items, or use **Select All** to grab everything on the current page.
  </Step>

  <Step title="Choose an action">
    With items selected, the bulk-action toolbar appears at the bottom of the screen. Pick the action you want.
  </Step>

  <Step title="Confirm">
    Some actions (like permanent delete) ask for confirmation. Review and confirm to apply the change.
  </Step>
</Steps>

The available bulk actions are:

| Action               | What it does                                          |
| -------------------- | ----------------------------------------------------- |
| **Tag**              | Adds one or more tags to all selected bookmarks       |
| **Move**             | Assigns selected bookmarks to one or more groups      |
| **Archive**          | Archives all selected bookmarks                       |
| **Favorite**         | Marks all selected bookmarks as favorites             |
| **Delete**           | Moves all selected bookmarks to trash (soft delete)   |
| **Permanent delete** | Deletes all selected bookmarks forever — no recovery  |
| **Export**           | Exports all selected bookmarks to a downloadable file |

<Warning>
  Permanent delete cannot be undone. If you're unsure, use the regular **Delete** action to move items to trash first so you can restore them later.
</Warning>

***

## Favorites

Marking a bookmark as a favorite pins it to your **Favorites** view so you can reach it instantly without searching.

To favorite a single bookmark, hover over its card and click the **star** icon. Click again to unfavorite.

You can also favorite in bulk — select multiple bookmarks and choose **Favorite** from the bulk-action toolbar.

***

## Reading list & unread status

Any bookmark can be added to your reading list by marking it as **unread**. This is useful when you save something you want to come back to but don't have time to read right now.

* **Mark as unread:** Open the bookmark's action menu (the `···` icon) and select **Mark as unread**.
* **Mark as read:** Open the same menu and select **Mark as read**, or open the bookmark — Bkmark can optionally auto-mark it as read when you visit the URL.
* **Filter your reading list:** Use the **Unread** filter in the sidebar to see only bookmarks you haven't read yet.

***

## Trash & restore

Deleting a bookmark moves it to the **Trash** rather than removing it immediately. This gives you a safety net if you delete something by mistake.

**Moving to trash**

<Steps>
  <Step title="Delete a bookmark">
    Open the action menu on a bookmark card and click **Delete**, or select bookmarks in bulk and choose **Delete**. The bookmark disappears from your library but lands in trash.
  </Step>
</Steps>

**Restoring from trash**

<Steps>
  <Step title="Open Trash">
    Click **Trash** in the left sidebar.
  </Step>

  <Step title="Find the bookmark">
    Browse or search your deleted bookmarks.
  </Step>

  <Step title="Restore">
    Open the action menu on the item and click **Restore**. The bookmark returns to your library with all its tags and groups intact.
  </Step>
</Steps>

**Permanently deleting from trash**

If you're sure you no longer need a bookmark, open Trash, find the item, and choose **Delete permanently** from its action menu. This removes it for good — there is no way to recover it after this step.

<Tip>
  You can also empty the entire trash at once using the **Empty Trash** button at the top of the Trash view.
</Tip>

***

## Archiving bookmarks

Archiving lets you keep a bookmark in your library without it cluttering your main view. Think of it as a long-term storage shelf.

* **Archive a bookmark:** Open its action menu and click **Archive**.
* **View archived bookmarks:** Toggle the **Archived** filter in the sidebar.
* **Unarchive:** Open the action menu on any archived bookmark and click **Unarchive** to bring it back to your active library.

***

## Link health checks (Pro & Team)

Over time, web pages move or disappear — a problem called link rot. On the **Pro** plan, Bkmark periodically checks your link bookmarks and flags any that return errors (404, 403, server timeouts, etc.).

When a broken link is detected, the bookmark is highlighted in your library with a warning badge. You can then update the URL, replace it with an archived version, or delete the bookmark altogether.

<Note>
  Link health checks are available on the **Pro** and **Team** plans. Upgrade from your account settings if you want automatic broken-link detection across your entire library.
</Note>