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

# Organize Your Notes Using Tags and Filters in Bloc

> Use tags to categorize your notes in Bloc. Each note can have one tag. Filter by tag in the sidebar or search to quickly find related notes.

As your note library grows, finding the right note quickly matters. Tags give you a lightweight way to group related notes without folders or complex hierarchies. Attach a single tag to any note — like `work`, `ideas`, or `recipes` — and then filter your whole library by that tag in seconds. This page explains how tags work and how to get the most out of them.

## What tags are

A tag is a short text label you attach to a note to identify its category or topic. Tags in Bloc follow a few simple rules:

* **One tag per note.** Each note can hold exactly one tag at a time.
* **Up to 50 characters.** Tag names are plain text and cannot exceed 50 characters.
* **Optional.** Notes without a tag work perfectly fine — tagging is never required.

Tags appear as small chips directly below the note title in the editor, and as labeled badges on note cards in the sidebar and search results.

## Add a tag to a note

<Steps>
  <Step title="Open the note">
    Open the note you want to tag by clicking it in the sidebar.
  </Step>

  <Step title="Click Add tag…">
    Below the title, click the **Add tag…** input field.
  </Step>

  <Step title="Type your tag name">
    Type the tag name — up to 50 characters. Tag names are case-sensitive, so `Work` and `work` are treated as different tags.
  </Step>

  <Step title="Press Enter to confirm">
    Press **Enter** (or **Done** on mobile) to attach the tag. The tag appears as a chip next to the input field.
  </Step>
</Steps>

<Tip>
  Keep tag names short and consistent. Single words like `work`, `personal`, `reading`, or `archive` are easier to filter by than longer phrases. Decide on a convention early — for example, always lowercase — and stick to it so tags stay predictable across all your notes.
</Tip>

## Edit or remove a tag

To **change** a tag, remove the current one first and then type a new one:

1. Click the **×** on the tag chip beside the title (or focus the chip with the keyboard and press **Backspace** or **Delete**). The tag is removed immediately.
2. Click **Add tag…** and type the new tag name, then press **Enter** to confirm.

To simply **remove** a tag without replacing it, click the **×** on the chip or press **Backspace**/**Delete** when the tag input is empty.

## How tags appear in the sidebar

Every tagged note shows its tag as a small badge on the note card in the sidebar. Untagged notes show no badge. When you filter by a tag (see below), only notes matching that tag are displayed.

## Filter by tag

You can narrow your sidebar or search results to a specific tag in two places:

* **Sidebar filter bar** — click the filter icon to reveal tag chips for every tag in your library. Click a tag chip to show only notes with that tag. Click **All tags** to clear the filter.
* **Search palette** — open search with **Cmd+K** / **Ctrl+K**, click the filter icon (sliders), and choose a tag from the **Tag** section. Combine it with a date filter for even more precise results.

For a full walkthrough of filters, see [Search and Filter Your Notes](/notes/search-and-filter).

<Info>
  Tags sync across all your devices along with your note content. When you add or change a tag on one device, the update appears on your other devices after the next sync.
</Info>