Skip to content

ankit-kapur/obsidian-kanban-status-updater-plugin

Repository files navigation

Kanban Status Updater

This is a plugin for making Kanban boards more useful in Obsidian. When you move a card from one column to another, a property on the card's linked note is updated automatically to the column name.

demo

Do I need it?

With this plugin you can make other kinds of views that are not confined to your board, for eg. if you wanted to see open tasks across multiple boards you could write a dataview query for all notes with status != 'Done'

Alternative I found to this (MetaEdit plugin) was slow and buggy, I decided to use a different approach to make a lightweight plugin that is snappy and just works.

Features

  • Auto-updates a frontmatter property (default: "status") when a card is moved on a Kanban board
  • Performance optimized: only monitors the currently active Kanban board
  • Customizable property name
  • Visual feedback when properties are updated
  • Debug mode for troubleshooting

Installation

From Obsidian Community Plugins

  1. Open Obsidian Settings
  2. Go to Community Plugins and disable Safe Mode (if enabled)
  3. Click "Browse" and search for "Kanban Status Updater"
  4. Click Install, then Enable

Manual Installation

  1. Download the latest release from the GitHub repository
  2. Extract the zip file into your Obsidian vault's .obsidian/plugins/ folder
  3. Restart Obsidian and enable the plugin in Settings > Community Plugins

Requirements

  • Obsidian Kanban plugin must be installed and enabled
  • Kanban cards must contain internal links to notes (e.g., [[Note Title]])

Usage

  1. Create a Kanban board using the Obsidian Kanban plugin
  2. Add cards with links to notes (e.g., [[My Note]])
  3. When you move a card to a different column, the linked note's status property will automatically update to match the column name

No additional configuration is required for basic functionality.

Configuration

The plugin can be configured in the Settings tab:

  • Status property name: The name of the property to update in the note's frontmatter (default: "status")
  • Show notifications: Toggle notifications when a status is updated
  • Debug mode: Enable detailed logging to console (reduces performance, only use for troubleshooting)

There's also a "Test plugin" button that will scan for Kanban items on the active board to verify the plugin is working.

Performance Considerations

This plugin is designed to minimize performance impact by:

  • Only monitoring the currently active Kanban board
  • Disconnecting observers when switching to other views
  • Processing a limited number of mutations
  • Only updating notes when the status actually changes

If you experience any performance issues, try disabling Debug Mode in the settings.

Troubleshooting

If the plugin isn't working as expected:

  1. Make sure your Kanban cards contain internal links to notes ([[Note Title]])
  2. Check that the Kanban plugin is installed and enabled
  3. Verify you're viewing a Kanban board (plugin only works with the active board)
  4. Enable Debug Mode temporarily and check the console (Ctrl+Shift+I) for logs

Compatibility

  • Requires Obsidian v1.1.0 or higher
  • Requires Obsidian Kanban plugin v1.3.0 or higher

If you find this plugin helpful,

About

Obsidian plugin that automatically updates the note property when card is moved to a column.

Resources

License

Stars

Watchers

Forks

Packages