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

Category Workbench

circlemooncirclemoon23 downloads

Manage category indexes, templates, note prefixes and tags from a dockable workbench with previewed, backed-up renames.

Add to Obsidian
  • Overview
  • Scorecard
  • Updates3

A dockable workbench for categories, templates, note prefixes and tags in Obsidian. See how the names relate, then change the one you actually mean.

简体中文 · Architecture · Validation

Four independent names

Name Example Controls
Template filename RUA-Template.md The name shown in template pickers
Category property categories: ["[[RUA]]"] Which category index includes a note
Tag property tags: [research] Searchable #research labels
Template prefix const prefix = "RUA"; Future filenames such as RUA-My note.md

Renaming RUATemplate.md to RUA-Template.md keeps category properties and note prefixes. Only references to the renamed template file may be updated. Existing note filenames stay as they are. Editing the prefix only changes the selected template, so existing notes remain unchanged.

Open the workbench

  • Click the folder with a cog ribbon icon, labeled Category Workbench.
  • Run Category Workbench: Open category and template workbench from the command palette.
  • Open Settings → Category Workbench → Open panel.

The view opens in the left sidebar by default. It is a native workspace view: it can be moved, docked and restored with the workspace. Repeated opening reveals the existing view. Choose the right sidebar or a main tab in settings. No default hotkey is assigned; set one in Obsidian's hotkey settings.

Work with templates

The Templates tab displays each template's file path, actual categories, tags and recognized naming prefix. Missing category indexes are flagged explicitly.

  • Rename file only previews a template file rename and its Markdown link updates.
  • Change future prefix edits one statically declared const prefix string. Custom or dynamic naming scripts must be edited in source; the workbench does not evaluate them to guess a prefix.
  • Edit category and tags updates only the selected template. It does not reclassify existing notes.
  • Edit source opens the complete template for editing.
  • New note runs the selected template through Templater.

The Categories tab creates a category page, matching Base and template together, with independently chosen names and prefix. It can also create a missing index without replacing an existing template. Renaming a category updates category references and Base link(...) filters; it keeps template filenames and prefixes independent.

The Tags tab adds a tag to the last opened note or previews a vault-wide rename, including nested tags. Code blocks are excluded using Obsidian's parsed inline-tag positions. Standard Base tags.contains(...) and file.hasTag(...) filters are updated. Custom scripts, search queries and other plugins' saved template-path settings are not rewritten; reselect a renamed template in those plugins when necessary.

Install

Install from the community directory using Add to Obsidian, or search for Category Workbench in Obsidian Community plugins.

For a manual installation, use the latest GitHub release:

  1. Download main.js, manifest.json and styles.css.
  2. Put the three files in <vault>/.obsidian/plugins/category-workbench/. For a custom configuration folder, use that folder instead of .obsidian.
  3. Reload Obsidian and enable Category Workbench in Community plugins.

Requires Obsidian 1.15.1 or newer. This initial release is marked desktop-only. The sidebar and rename workflow were tested on Linux; Windows, macOS and mobile have not been runtime-tested.

Templater is optional for browsing, category/tag management and template renames. Executing templates containing <% ... %> requires Templater to be installed and enabled. The plugin never installs it automatically. The current new-note integration uses Templater's create_new_note_from_template method and checks for its presence before running it.

Apply changes

Every bulk rename has a preview showing full before/after contents and file moves. The workbench rechecks source contents and target collisions before applying. It uses Vault.process for content updates and rolls back completed steps if a later step fails, provided no subsequent edits would be overwritten.

Operations keep their working state in memory and do not create backup files. If a step fails, completed changes are rolled back where no later edits would be overwritten.

Privacy

The plugin works offline. It makes no network requests, sends no telemetry, reads no files outside the active vault, and does not install or update itself or dependencies. Settings are stored with Obsidian's plugin data API. Only local vault files selected by a confirmed operation are changed.

Build and test

Use Node.js 22 or newer:

npm ci
npm run check

The build produces a single readable main.js; all local runtime modules are bundled. Obsidian is the only runtime import. Tests cover independent template/category/prefix naming, nested tags, escaped Base filters, path validation, stale previews, collisions and conditional rollback. Release assets are attached to a tag matching manifest.json.

License

MIT, copyright 2026 skyswordx.

HealthExcellent
ReviewPassed
About
Manage category indexes, templates and tags in a native dockable workbench. See each template's filename, categories, tags and future-note prefix together, then change them independently. Renaming a template file keeps its naming prefix; changing a prefix affects future notes only. Preview file changes, back up originals inside the vault, and detect stale edits and collisions before applying. Supports configurable folders and nested-tag renames. Templater is optional for management and required to execute selected templates. Works offline with no telemetry. Desktop only; requires Obsidian 1.15.1 or newer.
PropertiesTags
Details
Current version
1.0.2
Last updated
3 days ago
Created
3 days ago
Updates
3 releases
Downloads
23
Compatible with
Obsidian 1.15.1+
Platforms
Desktop only
License
MIT
Report bugRequest featureReport plugin
Author
circlemooncirclemoonskyswordx
GitHubskyswordx
  1. Community
  2. Plugins
  3. Properties
  4. Category Workbench

Related plugins

Badges

Add inline badges/callouts to notes.

Tags Overview

An extended tags panel where tagged files can be easily viewed, filtered, and accessed.

Bases CMS

Manage your notes in bases like a content management system.

Colored Bases Properties

Color property lists and formula properties in Bases.

Advanced Canvas

Supercharge your canvas experience. Create presentations, flowcharts and more.

Meta Bind

Make your notes interactive with inline input fields, metadata displays, and buttons.

Tag Wrangler

Rename, merge, toggle, and search tags from the tag pane.

Supercharged Links

Add attributes to internal links with the values of target note's frontmatter attributes.

Force note view mode

Force the view mode for a note by using frontmatter: YAML block with 'obsidian_ui_mode' as key.

Checklist

Consolidate checklists across all files into a single view.