Track the lifecycle of every file in your vault using statuses you fully control. Note Status brings visual clarity and structured workflows to Obsidian—whether you're managing research notes, writing projects, tasks, or long-term archives.

It works on both Markdown and non-Markdown files, integrates into multiple UI surfaces, and provides configurable dashboards, commands, and fast actions to keep information flowing.

• Feature Guide: what the plugin can do across commands, UI surfaces, and workflows.
• Settings Reference: every option, grouped like the in-app settings.

1. Open Settings → Note Status.
2. Expand Templates & Statuses and keep a built-in template or add your own/custom-only set.
3. Pick where to see/change status: Status Bar or Editor Toolbar.
4. Set a status from the badge or run Change current note status.
5. Watch file explorer icons update; hover for the overview popup or click to change again.
6. If enabled, open the Status Dashboard or Grouped Status View from the ribbon/commands.

• Status picker everywhere: status bar badge, editor toolbar, explorer context menus, commands.
• Multi-status or single-status workflows; quick-status commands for hotkeys.
• File explorer icons with configurable placement, frames, and visual treatments (row tint, underline, dot, border).
• Status bar badges with accent/filled/dot styles and icon/text options; template names can auto-show on conflicts.
• Dashboards and grouped views (gated by experimental toggles and vault size limit) for vault-wide visibility and quick actions.
• Built-in templates (Colorful, Minimal, Academic, Project) plus full custom templates and standalone custom statuses.
• Works with YAML frontmatter and non-Markdown via a synced JSON store; frontmatter mappings let you write to multiple keys.

• Markdown: statuses live under the tag prefix (default obsidian-note-status). Map templates/statuses to extra YAML keys and optionally also write to the default.
• Non-Markdown: stored in .obsidian/plugins/obsidian-note-status/non-markdown-statuses.json, kept in sync on rename/delete.
• Single vs multi: multiple statuses by default; single-status mode can store as list (status: [draft]) or string (status: draft) for compatibility.

• Nav bar with current status

  • 
  • 

• Status assignment:

  • 

• File explorer with status icons and hover overview:

  • 

• Multiple settings:

  • 

• Custom templates editor:

  • 
  • 

• Frontmatter tags mapping

  • 

• Grouped status view:

  • 

• Status dashboard:

  • 
  • 
  • 

You can contribute your own status templates to the plugin!

1. Create a custom template in the plugin settings.
2. Click the Share (📤) icon on your custom template.
3. Follow the instructions in the modal to copy the JSON and submit a Pull Request to the official repository.
4. Maintainers will review your submission and accept it if it passes the revision!

1. Fork the repository. ...
2. Create a new JSON file in the templates/ folder (e.g., templates/my-awesome-workflow.json).
3. Follow this format:

   {
     "id": "my-awesome-workflow",
     "name": "My Awesome Workflow",
     "description": "A workflow for doing awesome things",
     "authorGithub": "your-username",
     "statuses": [
       { "name": "todo", "icon": "📝", "color": "#ff0000", "templateId": "my-awesome-workflow" },
       { "name": "done", "icon": "✅", "color": "#00ff00", "templateId": "my-awesome-workflow" }
     ]
   }

4. Submit a Pull Request with your JSON file!

Once accepted and merged, your template will be automatically included in the next build and available in the marketplace for all users.

1. Obsidian → Settings → Community plugins.
2. Disable Safe mode → Browse → search “Note Status”.
3. Install and enable.

1. Download the latest release from GitHub Releases.
2. Extract main.js, manifest.json, and styles.css to .obsidian/plugins/note-status/.
3. Enable in Community plugins settings.

Personal knowledge

💡 idea → 📝 draft → ✏️ editing → ✅ completed → 📦 archived

Project delivery

📋 backlog → 🚦 ready → 👨‍💻 inDevelopment → 🧪 testing → 🚀 live

Academic

🔍 research → 📑 outline → ✏️ draft → 🔬 review → 📚 final

Statuses in YAML(as string or array, it depends of your settings):

---
obsidian-note-status:
    - active
    - inProgress
---

Works with Dataview, Templater, QuickAdd, and search. Non-Markdown uses the JSON store noted above.

License: MIT · Author: Aleix Soler