Multi Vault


Multi vault refers to managing multiple vaults within your workspace.

Use Cases

  • for sensitive notes, multi-vault enables local only vaults vs vaults that can be synced on file sharing services like Dropbox
  • for modularizing knowledge, multi-vault enables users to mix and match existing vaults depending on context
  • for federating and curating knowledge, multi-vault enables users to publish/subscribe to public vaults using protocols like git
  • for access control, multi-vault lets users configure specific vaults to be private which turns off publication and sharing of any notes inside said vault



Lookup supports multiple vaults. When using lookup to find a note, each search result is labeled with which vault it belongs to.

Vault Location when Creating a Note

When creating a note in lookup, Dendron will try to create your note in the correct vault. By default, it will place the note into the same vault as the currently opened note. But if it detects that the new note matches an existing hierarchy in a different vault, you will get prompted to pick the destination vault:

Prompt for Vault Selection Each Time


This setting is scheduled for deprecation πŸ“†

Use confirmVaultOnCreate instead.

With this set, you will be prompted to select the vault location each time you create a note when you have multiple vaults in your workspace.

To enable, add lookupConfirmVaultOnCreate: true in the Dendron configuration. Instructions to do so below.

  1. Dendron: Configure (yaml)

  2. add lookupConfirmVaultOnCreate: true so your configuration looks like the following:
version: 0
lookupConfirmVaultOnCreate: true

Moving Notes Between Vaults

This can be done with the Move Note command.

If looking to move a note within a hierarchy in a local vault, or just to rename the note, use Rename Note

  • shortcuts: none

Move a note between vaults when in a Multi Vault workspace, and update all backlinks.

You can also move a note from the explorer, and all of the backlinks to that note will be updated automatically:

  • Right Click on the note
  • Select Dendron: Move Note

NOTE: Dendron will not allow you to move a note to a note that already exists

  • Sample workspace

└── Dendron
    |── .git
    |── dendron.code-workspace
    |── dendron.yml
    |── pods
    |── docs
    β”œβ”€β”€ vault1
    β”‚   |── .git
    β”‚   β”œβ”€β”€
    β”‚   └──
    └── vault2
        |── .git

  • navigating to [[foo]] will result in a display prompting the user to select the vault to navigate to
  • navigating to [[foo.two]] will directly navigate to the note since it is unique across all vaults
  • navigating to [[vault1/foo]] will open foo from vault1
  • navigating to [[dendron://vault2/foo]] will open foo from vault2

Note References

When you make a reference, Dendron will include the note from the same note. You can create a reference to a note in a different vault by using cross vault links.


You can publish your notes from a multi-vault workspace just as you would from a single vault workspace.

We have added a new configuration, duplicateNoteBehavior, which controls how Dendron handles duplicate notes across multiple vaults.

Version Control

For multi-vault, there are several approaches to version control. If you are using Git, you can either commit everything as one repo or version control your workspace and each vault separately as distinct repos.

If you use Vault: Add with a remote vault, Dendron will automatically add the remote properties to your dendron.yml file. See example below.

        fsPath: handbook
        workspace: handbook-workspace
        name: handbook
            type: git
            url: ''

This will have the following file layout

└── workspace
    └── handbook-workspace
        └── handbook-vault

Versioned controlled vaults will be auto-initialized when someone pulls in the workspace.

If you want to convert a local vault to a remote vault, you can follow the instructions here.

File Layout for Multi-Vault Workspace

└── Dendron
    β”œβ”€β”€ .git
    β”œβ”€β”€ dendron.code-workspace
    β”œβ”€β”€ dendron.yml
    β”œβ”€β”€ ...
    β”œβ”€β”€ vault1
    β”‚   β”œβ”€β”€ .git
    β”‚   β”œβ”€β”€
    β”‚   └── ...
    └── vault2
        β”œβ”€β”€ .git
        └── ...


  • Sample Multi-Vault workspace

  1. Faq