Search...Search plugins and themes...
⌘K
Sign in
  • Get started
  • Download
  • Pricing
  • Enterprise
  • Account
  • Obsidian
  • Overview
  • Sync
  • Publish
  • Canvas
  • Mobile
  • Web Clipper
  • CLI
  • Learn
  • Help
  • Developers
  • Changelog
  • About
  • Roadmap
  • Blog
  • Resources
  • System status
  • License overview
  • Terms of service
  • Privacy policy
  • Security
  • Community
  • Plugins
  • Themes
  • Discord
  • Forum / 中文论坛
  • Merch store
  • Brand guidelines
Follow us
DiscordTwitterBlueskyThreadsMastodonYouTubeGitHub
© 2026 Obsidian

Custom State for Task List

okamiwongokamiwong5k downloads

Add custom states to task list items.

Add to Obsidian
  • Overview
  • Scorecard
  • Updates4

A plugin for Obsidian to help you define your own states for task list!

How to install

Please refer to Community plugins - Obsidian Help

How to use

  • Simply put the name of your custom state inbetween the square brackets of a task item.

    • For example, if you want to mark the following task as doing
      • - [ ] Some task
    • Just put doing inside the square brackets like
      • - [doing] Some task
    • In the reading view of Obsidian, this task will be rendered as
      • 🚧 Some task
  • The default states are ({stateName} ➡ {readingView})

    • committed ➡ 📌
      • You have decide to do this task some day
    • doing ➡ 🚧
      • You are currently working on this task
    • deferred ➡ 😴
      • The completion of this task is postponed
    • removed ➡ 🗑
      • The task is removed
  • You can edit the default states and add more states in the settings.

HealthGood
ReviewSatisfactory
About
Define custom task states by placing a state name inside a task's square brackets (e.g., [doing] Task) to mark progress beyond checked/unchecked. Render states as readable icons or labels in reading view and edit default states or add new ones like committed, doing, deferred, and removed.
TasksIcons
Details
Current version
1.0.3
Last updated
2 years ago
Created
3 years ago
Updates
4 releases
Downloads
5k
Compatible with
Obsidian 0.15.0+
Platforms
Desktop, Mobile
License
MIT
Report bugRequest featureReport plugin
Author
okamiwongokamiwong
github.com/OkamiWong
GitHubokamiwong
  1. Community
  2. Plugins
  3. Tasks
  4. Custom State for Task List

Related plugins

TaskNotes

Note-based task management with calendar, pomodoro and time-tracking integration.

Tasks

Track tasks across your vault. Supports due dates, recurring tasks, done dates, sub-set of checklist items, and filtering. Maintained by Clare Macrae and Ilyas Landikov, created by Martin Schenck.

Day Planner

Turn tasks from daily notes, the Tasks plugin, and calendars into time blocks on an editable timeline, with built-in time tracker.

Project Manager

Full-featured project management: stunning Gantt charts, Kanban boards, Table views, customizable fields, due date notifications.

Link Favicons

See the favicon for a linked website.

Iconic

Customize your icons and their colors directly from the UI, including tabs, files & folders, bookmarks, tags, properties, and ribbon commands.

Day Planner OG

Day planning from a simple task list in a Markdown note (bare bones, preserves the features and behavior of the original plugin).

Checklist

Consolidate checklists across all files into a single view.

Task Collector

Change task status and collect tasks within a document using hotkeys and context menus.

Base Board

Organize notes into Kanban boards using frontmatter properties. Drag and drop cards between columns powered by Bases.