Get AI summaries of any video or article — Sign up free
Obsidian Tasks Community Plugin Series, Part 1 - Global Task Filter thumbnail

Obsidian Tasks Community Plugin Series, Part 1 - Global Task Filter

5 min read

Based on Knowledge Work Nexus's video on YouTube. If you like this content, support the original creators by watching, liking and subscribing to their content.

TL;DR

The Global Task Filter (hashtag + emoji) determines which checkbox items are indexed as Tasks and therefore appear in Tasks queries.

Briefing

Obsidian’s Tasks plugin can automatically turn specific checkbox items into “real” tasks—if a single setting called the Global Task Filter is configured correctly. That global hashtag (and its related emoji) determines which checkboxes get indexed by task queries, which then controls what appears in task lists and dashboards. Getting this right early prevents the common frustration of seeing some items show up in queries while other checkboxes—seemingly similar—stay invisible.

The walkthrough begins by installing and enabling the Tasks community plugin in a fresh Obsidian vault. The key step is setting the Global Task Filter: any checkbox item that includes the chosen hashtag (the example uses “#task”) is treated as a task across the vault. The creator keeps other options at defaults for now—such as leaving preset/status/date behavior unchanged—so the demonstration can focus on how the global filter works. A second important toggle is “remove global filter from description.” When this is off, the hashtag remains visible in task text; when it’s on, the hashtag is stripped from the rendered task description after indexing.

To show the difference, the transcript creates two kinds of items: plain checklist entries (typed as normal checkboxes without the hashtag) and tasks (checkboxes that include the hashtag). Only the hashtagged items appear when a basic Tasks query is created using a fenced code block labeled “tasks.” The simplest query returns the three tasks created with the global hashtag, while the plain checklist items do not appear—because they lack the global filter marker.

Next, the “remove global filter from description” option is turned on, requiring an Obsidian restart. After restarting, the same tasks query no longer displays the hashtag in the results, even though the tasks still exist and are still indexed. This gives a cleaner visual presentation without changing which items qualify as tasks.

The demonstration then addresses what happens when the global hashtag itself changes. After switching the global filter away from “#task,” the existing tasks disappear from the query because they still contain the old hashtag. Adding a new checkbox using the updated hashtag makes it appear again. The practical takeaway: the global filter is effectively a gatekeeper for task discovery, so changing it can hide previously created tasks unless they’re updated or recreated.

Finally, the transcript shows two ways to create tasks: manually typing the global hashtag into a checkbox, and using the Tasks modal from the command palette (“create or edit task”), which inserts the hashtag automatically and supports richer fields like due dates, priorities, recurrence, statuses, and dependency-style “before/after” relationships. The overall message is that the global task filter should be chosen deliberately, because it shapes how tasks are recognized, displayed, and managed—whether the plan is to keep the same vault or evolve the system without migrating everything.

Cornell Notes

Obsidian Tasks uses a Global Task Filter—typically a hashtag plus an emoji—to decide which checkbox items become “tasks” that show up in Tasks queries. Items without the global hashtag behave like regular checklist items and won’t appear in task lists. Turning on “remove global filter from description” cleans up how tasks render by stripping the hashtag from the visible text after an Obsidian restart. Changing the global hashtag later can make existing tasks disappear from queries until they’re updated or recreated with the new hashtag. The plugin also supports task creation via a command-palette modal, which can auto-add the hashtag and fill fields like due dates, status, and dependencies.

What exactly does the Global Task Filter do in the Tasks plugin?

It acts as the recognition rule for task indexing. Any checkbox item that includes the configured global hashtag (example: “#task”) is treated as a task and becomes eligible to appear in Tasks queries. Plain checklist items without that hashtag are not indexed as tasks, so a simple “tasks” query returns only the hashtagged items.

Why do some checklist items not show up in a Tasks query even when they look similar?

Because they lack the global filter marker. In the demo, packing-list checkboxes created without the “#task” hashtag never appear in the fenced code block query labeled “tasks,” while checkboxes that include “#task” do. The plugin distinguishes “tasks” from ordinary checklists based on the global hashtag.

What changes when “remove global filter from description” is enabled?

The hashtag is removed from the visible task description in query results, making tasks look cleaner. The setting requires an Obsidian restart to take effect. After restarting, the same tasks still appear in the query, but the “#task” text no longer shows in the results.

What happens if the global hashtag in the Global Task Filter is changed?

Existing tasks tied to the old hashtag stop appearing in queries. When the global filter is switched away from “#task,” the earlier tasks vanish from the “tasks” query because they still contain the old marker. Adding a new checkbox using the updated hashtag makes it appear again, demonstrating that the global filter is the gate for task discovery.

How do you create tasks: manually with the hashtag or via the Tasks modal?

Manually: type a checkbox and include the global hashtag; when the hashtag is recognized, the plugin offers auto-suggest fields like due date. Via modal: open the command palette and choose “tasks create or edit task.” This modal inserts the hashtag automatically and provides structured options for due dates, priority, recurrence, status, and other properties, plus dependency-style “after/before” relationships.

How do dependency-style “before/after” settings work in task creation?

When creating a task in the modal, the “after” and “before” options can link tasks so one should wait for another. The transcript gives an example: set a reading task to be “after” the introduction task, or set later chapters to be “before” another prerequisite. This enables lightweight sequencing without changing vaults.

Review Questions

  1. If a checkbox item does not include the Global Task Filter hashtag, what will happen to it in a fenced “tasks” query?
  2. How does enabling “remove global filter from description” affect what appears in query results, and why is a restart required?
  3. What practical issues arise when changing the global hashtag after tasks already exist in the vault?

Key Points

  1. 1

    The Global Task Filter (hashtag + emoji) determines which checkbox items are indexed as Tasks and therefore appear in Tasks queries.

  2. 2

    Checklist items without the global hashtag behave like ordinary checkboxes and won’t show up in a “tasks” query.

  3. 3

    Enabling “remove global filter from description” cleans up task text by hiding the hashtag in query results, but requires an Obsidian restart.

  4. 4

    Changing the global hashtag later can make previously created tasks disappear from queries unless they’re updated or recreated with the new hashtag.

  5. 5

    Tasks can be created either by manually typing the global hashtag into a checkbox or by using the Tasks modal, which auto-adds the hashtag and supports richer fields.

  6. 6

    The Tasks modal supports due dates, priorities, recurrence, statuses, and dependency-style “before/after” relationships, enabling more structured task management.

Highlights

Only checkboxes containing the Global Task Filter hashtag are treated as tasks and returned by a Tasks query; plain checklist items stay invisible.
Turning on “remove global filter from description” makes query results cleaner by stripping the hashtag from task text after a restart.
Switching the global hashtag effectively changes the “membership rule” for tasks—old tasks vanish from queries until recreated or updated.
The command-palette Tasks modal can auto-insert the global hashtag and lets users set due dates, statuses, recurrence, and dependencies in one place.

Topics