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

# Organize Your Library Using Tags and Groups in Bkmark

> Use color-coded tags for flexible labeling and hierarchical groups as folders. Combine both to build an organization system that fits the way you think.

Bkmark gives you two complementary ways to organize your library: **tags** for flexible, cross-cutting labels and **groups** for hierarchical folder-like structure. You can use one, the other, or both — and a single bookmark can belong to as many tags and groups as you need.

***

## Tags

Tags are color-coded labels you attach to bookmarks. Because a bookmark can have multiple tags, they work well for anything that doesn't fit neatly into a single folder — topics, projects, reading status, priority, or whatever makes sense for your workflow.

### Available tag colors

You can assign any of the following colors when you create or edit a tag:

* `red`
* `orange`
* `amber`
* `yellow`
* `lime`
* `green`
* `teal`
* `cyan`
* `blue`
* `indigo`
* `violet`
* `pink`

Leave the color blank to use the default neutral style.

### Creating a tag

<Steps>
  <Step title="Open Tag Manager">
    Click **Tags** in the left sidebar, then click **+ New Tag**.
  </Step>

  <Step title="Name your tag">
    Type a short, descriptive name. Tag names are lowercase and use hyphens instead of spaces — for example, `machine-learning` or `to-read`.
  </Step>

  <Step title="Pick a color">
    Select a color from the palette to make the tag visually distinct in your library.
  </Step>

  <Step title="Save">
    Click **Create Tag**. The tag is now available to assign to any bookmark.
  </Step>
</Steps>

You can also create tags on the fly while saving a bookmark — just type a new tag name in the tags field and Bkmark creates it automatically.

### Renaming a tag

<Steps>
  <Step title="Open Tag Manager">
    Click **Tags** in the sidebar to see all your tags.
  </Step>

  <Step title="Edit the tag">
    Hover over the tag and click the **pencil** icon, or open its context menu and choose **Rename**.
  </Step>

  <Step title="Save the new name">
    Type the new name and press **Enter**. Every bookmark that had this tag is updated instantly.
  </Step>
</Steps>

### Deleting a tag

<Steps>
  <Step title="Open Tag Manager">
    Click **Tags** in the sidebar.
  </Step>

  <Step title="Delete the tag">
    Hover over the tag and click the **trash** icon, or choose **Delete** from its context menu.
  </Step>

  <Step title="Confirm">
    Confirm the deletion. The tag is removed from every bookmark it was attached to and then permanently deleted.
  </Step>
</Steps>

<Warning>
  Deleting a tag removes it from **all** bookmarks that use it. There is no way to undo this, so rename the tag first if you're just doing a cleanup.
</Warning>

### Filtering by tag

Click any tag in the sidebar (or on a bookmark card) to instantly filter your library to only bookmarks with that tag. You can also combine a tag filter with a search query or a group filter.

***

## Groups

Groups are hierarchical containers — like folders — that let you organize bookmarks by project, topic, team, or any other structure. A group can contain bookmarks as well as **child groups**, so you can build multi-level hierarchies.

### Creating a group

<Steps>
  <Step title="Open Group Manager">
    Click **Groups** in the sidebar, then click **+ New Group**.
  </Step>

  <Step title="Name your group">
    Give the group a clear, descriptive name, for example `Work / Design Resources` or `Learning / Rust`.
  </Step>

  <Step title="Set optional details">
    * **Description** — a short note about what belongs here.
    * **Color** — a hex color used to tint the group's icon in the sidebar.
    * **Icon** — an emoji or icon name to make the group visually recognizable.
    * **Parent group** — if this should be a sub-group of an existing group, pick a parent.
  </Step>

  <Step title="Save">
    Click **Create Group**. The new group appears in the sidebar, nested under its parent if you set one.
  </Step>
</Steps>

**Example hierarchy:**

```text theme={null}
📁 Work
  └── 📁 Design Resources
  └── 📁 Engineering References
📁 Learning
  └── 📁 Rust
  └── 📁 Machine Learning
📁 Reading List
```

### Adding a bookmark to a group

A bookmark can belong to **multiple groups** at the same time. You have two ways to assign groups:

1. **At save time** — when creating a bookmark, type or select group names in the **Groups** field.
2. **After saving** — open the bookmark's action menu (`···`), choose **Edit**, and update the groups field.

You can also bulk-assign bookmarks to a group by selecting them and choosing **Move** from the bulk-action toolbar.

### Renaming or editing a group

Hover over the group in the sidebar and click the **settings** icon, or right-click and choose **Edit Group**. You can change the name, description, color, icon, or parent group at any time.

### Deleting a group

Open the group's settings and choose **Delete Group**. You'll be prompted to either:

* **Move bookmarks** to another group before deleting, or
* **Leave bookmarks unassigned** (they remain in your library without that group).

<Note>
  Deleting a group only removes the group container — your bookmarks are **never deleted** when you delete a group.
</Note>

***

## Smart organization tips

<Accordion title="Use tags for topics, groups for projects">
  Tags work best for cross-cutting concerns that apply across many different projects — things like `tutorial`, `reference`, `to-read`, or `important`. Groups work best when you have a distinct project or context that deserves its own "folder," like a client engagement or a learning track.
</Accordion>

<Accordion title="Assign bookmarks to multiple groups">
  Don't feel like a bookmark must live in exactly one place. A great article about Rust async programming can legitimately live in both your `Learning / Rust` group **and** your `Engineering References` group. Assign it to both so you find it wherever you look.
</Accordion>

<Accordion title="Color-code by urgency or domain">
  Use a consistent color convention across tags to make scanning your library faster. For example: `red` for urgent or high-priority, `green` for reference material you trust, `amber` for things you're not sure about yet. You don't need to document the system — it becomes intuitive quickly.
</Accordion>

<Accordion title="Name tags consistently">
  Decide upfront whether you'll use singular or plural tag names (`tutorial` vs `tutorials`) and whether you'll use hyphens for multi-word tags (`machine-learning` vs `machinelearning`). Consistent naming means less time hunting for the right tag when you're saving something new.
</Accordion>

<Accordion title="Nest groups to reduce clutter">
  If your sidebar is getting long, reorganize flat groups into a hierarchy. Move related groups under a common parent so the sidebar shows only the top-level containers by default. Expand them only when you need something specific.
</Accordion>