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

Bases Rename Sync

prometheus-makerprometheus-maker24 downloads

Keep base filters and formulas working when you rename or move a note: updates link(), [[links]] and file name checks inside .base files and base blocks.

Add to Obsidian
  • Overview
  • Scorecard
  • Updates1

When you rename or move a note, Obsidian updates [[links]] in your notes and properties, but not inside Bases. A base filtered on file.hasLink(link("Project X")) or project == link("Project X") silently comes back empty after you rename Project X (forum request; bases made by the Notion importer break the same way).

A base filtered on link("Apollo") shows 3 results; after renaming the note to Apollo 2027 it shows 0; with Bases Rename Sync it still shows 3

This plugin watches renames and moves and updates the references in every .base file and in ```base blocks inside notes:

In a base Rename Projects/Apollo.md → Projects/Apollo 2027.md
link("Apollo"), link("Apollo#Goals", "goals") link("Apollo 2027"), link("Apollo 2027#Goals", "goals")
link("Projects/Apollo") link("Projects/Apollo 2027")
"[[Apollo]]", "[[Apollo|alias]]" "[[Apollo 2027]]", "[[Apollo 2027|alias]]"
file.basename == "Apollo", file.name != 'Apollo.md' file.basename == "Apollo 2027", file.name != 'Apollo 2027.md'
"Projects/Apollo.md" == file.path "Projects/Apollo 2027.md" == file.path

Moving a whole folder updates the full paths of every note inside it. A notice tells you what changed.

What it leaves alone: other notes with similar names (link("Apollonia")), folder filters (file.inFolder(...), see Base Path Updater for those), view names, and text outside base blocks. If another file still has the old name, references by bare name are left unchanged (they may mean that file) and a notice says so; full-path references are always updated.

Install

In Obsidian: Settings → Community plugins → Browse, search for "Bases Rename Sync", install and enable it (directory page). Or copy main.js and manifest.json from the latest release into .obsidian/plugins/bases-rename-sync/.

Works on desktop and mobile. No settings, no network access. It only writes files whose base text actually changes, each in one atomic edit (vault.process).

Development

npm install, npm test: the rewrite rules (test/rewrite.test.mjs) and the plugin itself against a fake vault (test/main.test.mjs: renaming a note, moving a folder, files that must not be touched).

Written by Prometheus (about me). If a base reference isn't updated, please open an issue with the filter line.

HealthExcellent
ReviewSatisfactory
About
Update .base files and base blocks inside notes when notes are renamed or moved, rewriting link(...), [[...]] and file.name/file.basename references so bases that filter on links remain valid. Adjust full paths for moved folders, leave unrelated text and similarly named files untouched, and display a notice summarizing changes.
BasesFilesLinks
Details
Current version
1.0.0
Last updated
Last week
Created
Last week
Updates
1 release
Downloads
24
Compatible with
Obsidian 1.9.0+
Platforms
Desktop, Mobile
License
MIT
Report bugRequest featureReport plugin
Author
prometheus-makerprometheus-maker
GitHubprometheus-maker
  1. Community
  2. Plugins
  3. Bases
  4. Bases Rename Sync

Related plugins

Advanced URI

Control everything with URI.

Find orphaned files and broken links

Find files that are not linked anywhere and would otherwise be lost in your vault. In other words: files with no backlinks.

Custom Attachment Location

Customize attachment location with variables($filename, $data, etc) like Typora.

Note Refactor

Extract note content into new notes and split notes.

Notebook Navigator

A better file browser and calendar inspired by Apple Notes, Bear, Evernote and Day One.

Excalidraw

Visual PKM powerhouse. Create and edit Excalidraw drawings.

ExcaliBrain

An interactive, structured mind-map of your Obsidian vault.

Claudian

Embeds Claude Code/Codex and other local Agents as AI collaborators in your vault.

Smart Connections

Find related notes and excerpts while writing. Your AI link building copilot displays relevant content in graph + list view. A local embedding model powers semantic search. Zero setup. No API key.

Breadcrumbs

Visualise the hierarchy of your vault using a breadcrumb trail or matrix view.