PropCraft

A visual workbench that cleans up properties and tags across your whole Obsidian vault — merge tags, rename fields, add properties in bulk, and normalize dates. No code, no regex.

简体中文

Why PropCraft

After a few months of use, a vault fills up with near-duplicates: #reading, #read, and #book all describing the same thing; author, Author, and writer all pointing at a person; dates written five different ways. The built-in property panel only renames one field in one note at a time, and deeper cleanup usually means learning a scripting language or a linter plugin.

PropCraft turns that cleanup into sorting a spreadsheet. Open the workbench, see every property and tag in one place, and fix them with a drag.

Features

• Everything in one view. Every property key and tag in the vault, with how many notes use it, its value type, and sample values.
• Spot the mess. Orphan properties used only once, and suspected-duplicate tags or keys (case, singular/plural, separators, typos) are grouped and highlighted.
• Drag to merge. Drag #reading onto #read and let go. A preview lists every note that will change; confirm once and PropCraft rewrites them in the background.
• Rename or merge fields. Collapse author / Author / writer into one property, choosing how conflicting values are combined.
• Bulk add properties. Give every note in a folder a field such as status: unread, all from a guided wizard.
• Normalize dates. Turn 2024/1/5, Jan 5, 2024, and 2024年1月5日 into a consistent 2024-01-05.
• Undo anytime. Every batch keeps a local record, so the last change can be rolled back with one click.
• Speaks your language. Chinese when Obsidian is in Chinese, English otherwise.

How to use

1. Open the PropCraft view from the ribbon or the command palette.
2. Browse the Properties and Tags views. Open the Suggested cleanups to see orphans and likely duplicates.
3. Drag one tag onto another, or use the row menu to rename or merge a property.
4. Review the preview — every affected note, before and after — then choose Apply.
5. If something looks wrong, use Undo in the result panel or the History view.

Compatibility and limitations

Requires desktop Obsidian 1.8.7 or later. Mobile devices are not supported.

PropCraft only changes the metadata and tags you select. It does not rewrite note body text other than inline #tags, and it skips notes whose properties cannot be parsed instead of overwriting them. It never touches reserved fields such as tags, aliases, or cssclasses, and it ignores notes excluded by your settings.

Installation

1. Open Settings → Community plugins in Obsidian.
2. Select Browse and search for PropCraft.
3. Select Install, then Enable.

Privacy

PropCraft works entirely offline. There are no accounts, no network requests, no telemetry, and no access to files outside your vault. Undo history is stored locally in the plugin's own folder.

Support development

PropCraft is free. If it saves you time, voluntary donations are welcome — thank you.

WeChat Pay	Alipay

License

MIT © 2026 gua.