# Label and Filter Tasks with Hashtags

> Label tasks with #hashtags inside a project, then click any hashtag to instantly filter the list down to the related tasks you want to work on next.

- Source: https://www.taskade.com/learn/projects/hashtags
- Section: Projects
- Updated: 2026-09-02
- Index of all pages: https://www.taskade.com/learn/llms.txt

## Overview

Hashtags live **inside** a project. Type `#` in front of a word on any task and that word becomes a clickable label. Click it later and the project filters down to every task carrying the same hashtag.

Hashtags are not the same thing as [Workspace / Team Tags](https://www.taskade.com/learn/projects/tags). Tags are color-coded labels you attach to whole **projects** so you can filter a workspace or folder. Hashtags label **tasks** so you can filter inside a single project. Most people end up using both.

> **TL;DR:** Type `#` and a word on any task to create a hashtag. Pick from autocomplete to reuse an existing one. Click the hashtag to filter the project to matching tasks. Hashtags label tasks inside a project. [Workspace / Team Tags](https://www.taskade.com/learn/projects/tags) label whole projects across a workspace.

## Hashtags vs Workspace Tags

| | Project hashtags | [Workspace / Team Tags](https://www.taskade.com/learn/projects/tags) |
|---|---|---|
| What they label | Individual tasks and subtasks | Whole projects |
| Where you create them | Typed into a task with `#` | The ➕ Tag button in a workspace or folder |
| What filtering does | Narrows the current project | Narrows the project list in a workspace or folder |
| Colors | No, they are plain text labels | Yes, each tag gets a color |

## Add a Hashtag to a Task

1. Open a project and click the task you want to label.
2. Type `#` followed by the name of your hashtag, for example `#today`.
3. Press ⌨️ **Enter** to confirm.

The word turns into a clickable hashtag on that task. You can add more than one hashtag to the same task. A hashtag can go anywhere in the line: at the start, in the middle, or at the end.

Short, lowercase, single-word hashtags work best. `#today` and `#blocked` are easy to retype and easy to scan. Long phrases get lost in a busy list.

## Reuse Hashtags with Autocomplete

Type `#` anywhere in a project and Taskade shows you the hashtags already used in that project. Pick one from the list instead of typing it out again.

Autocomplete is what keeps a project tidy. It stops `#today`, `#Today`, and `#todays` from drifting apart into three separate labels that each filter to a different handful of tasks.

## Filter Tasks by Hashtag

Click any hashtag in your project. The view narrows to only the tasks that carry it, so `#blocked` becomes an instant list of everything waiting on someone else.

Click the hashtag again, or clear the filter, to return to the full project. Filtering is a view, not a change to your data, so nothing is deleted or moved while a filter is on. Teammates viewing the same project see their own filter, not yours.

Hashtag filtering works alongside the rest of your project setup, including [custom fields](https://www.taskade.com/learn/projects/custom-fields), [due dates](https://www.taskade.com/learn/projects/due-dates), and the different [project views](https://www.taskade.com/learn/projects/project-views).

## Remove or Rename a Hashtag

A hashtag is text inside the task, so you edit it the same way you edit any other text.

- **Remove one hashtag:** click into the task, delete the `#` and the word after it.
- **Remove the label but keep the word:** delete only the `#` character.
- **Rename a hashtag:** edit the word on each task that uses it. Use [Search](https://www.taskade.com/learn/projects/search) to find every task carrying the old hashtag first.
- **Refine from a chip:** run a search, then click one of the hashtag chips under the tabs. Each chip shows how many matches carry that tag, and one click adds it to your query.

Deleting a hashtag from a task never deletes the task itself. To remove tasks, see [Manage Tasks](https://www.taskade.com/learn/projects/manage-tasks).

## Tips

- Pick a small vocabulary and stick to it. Five hashtags everyone recognizes beat forty nobody remembers.
- Use hashtags for states that change often, like `#today`, `#waiting`, or `#blocked`. Use [custom fields](https://www.taskade.com/learn/projects/custom-fields) for structured values like owner, priority, or status.
- Prefix related hashtags so autocomplete groups them, for example `#dev-api` and `#dev-ui`.
- Combine hashtags with [Workspace / Team Tags](https://www.taskade.com/learn/projects/tags) for two levels of organization: tags to find the right project, hashtags to find the right tasks inside it.
- Add hashtags as you write. Labeling a task the moment you create it takes a second. Retrofitting labels across a long project takes an afternoon.

## Related guides

- [Workspace / Team Tags](https://www.taskade.com/learn/projects/tags)
- [Link Projects Together with @Mentions](https://www.taskade.com/learn/projects/backlinks)
- [Custom Fields](https://www.taskade.com/learn/projects/custom-fields)
- [Search](https://www.taskade.com/learn/projects/search)
- [Manage Tasks](https://www.taskade.com/learn/projects/manage-tasks)
