Get AI summaries of any video or article — Sign up free
A first look at Obsidian Shared Vaults (v0.14.10 insiders beta) thumbnail

A first look at Obsidian Shared Vaults (v0.14.10 insiders beta)

5 min read

Based on Zsolt's Visual Personal Knowledge Management's video on YouTube. If you like this content, support the original creators by watching, liking and subscribing to their content.

TL;DR

Shared vault collaboration in Obsidian Sync requires every participant to have an Obsidian Sync subscription, but the shared vault counts against the owner’s quota rather than everyone’s.

Briefing

Obsidian’s new multiplayer synchronization in insiders beta turns personal sync into a shared vault: an owner creates a password-protected vault, invites collaborators by email, and each participant must hold an Obsidian Sync subscription. The vault counts only against the owner’s quota, while each subscriber has a separate quota allowance (described as 5 vaults to synchronize). Beyond that billing model, the core mechanics mirror personal sync—selectable synchronization of folders, plugin settings, plugin code, and a synchronization history—so teams get a familiar workflow with the added ability to collaborate inside one shared workspace.

Setup is straightforward. The owner enables sync for a new vault, sets a password, and sends an invite link to a collaborator’s email. The collaborator accepts the invitation in their Obsidian account, then enables the shared vault under synchronization settings. In practice, both sides also need to enable the same categories of synchronization (plugins, plugin settings, and data) and turn on community plugins so the shared environment matches. In the tested scenario, the entire process took only a few minutes.

Where the experience becomes uneven is real-time parallel editing. When both collaborators edited the same Markdown document, Obsidian produced edit conflicts that were not always clear—especially around whether changes were overwritten. The tester reported seeing tag entries overwritten by the other person’s text, suggesting that simultaneous edits to the same document regions can still collide in ways that are hard to diagnose.

The synchronization history also proved difficult to use for team troubleshooting. For personal use, it’s described as helpful, but for collaborative work it lacked the granularity needed to reconstruct what happened during conflicts. Warnings were inconsistent, and even when warnings appeared, the history did not make it easy to untangle the sequence of conflicting updates.

Permissions management introduced another surprise. Removing a collaborator’s permissions was easy, but the collaborator’s vault continued synchronizing changes until the collaborator restarted Obsidian. In other words, access revocation did not immediately stop incoming updates, creating a window where “kicked out” users could still affect the shared vault.

The practical recommendation is to treat Obsidian multiplayer sync as early-stage collaboration rather than a full real-time system. The tester found it laggy compared with a true shared whiteboard experience, and conflict handling makes larger teams risky. For groups larger than a couple of people, the probability of collisions rises and the current history and conflict tooling are not robust enough to handle frequent edge cases. For bigger teams, the tester suggests using a more transparent version-control workflow such as GitHub sync, with check-in/check-out behavior and clearer attribution of changes.

Still, the workflow can work well when collaboration is structured to avoid collisions. Editing “atomic” documents—small, separate files—reduced conflicts dramatically, with a main document using transclusion to assemble the final view. With Obsidian’s rapid development pace, the tester expects improvements in synchronization and conflict resolution in the near term, but for now positions multiplayer sync as best for small groups and carefully partitioned writing rather than large, simultaneous collaboration on shared documents.

Cornell Notes

Obsidian’s multiplayer synchronization extends personal sync to shared vaults by letting an owner invite collaborators via email. Shared vaults behave like personal sync: you can choose which folders, plugin settings, plugin code, and data to synchronize, and you get synchronization history. In hands-on testing, simultaneous edits to the same Markdown document caused unclear conflicts, with tag/text overwrites and troubleshooting that was hard to reconstruct from history. Permissions revocation also wasn’t immediate—removing access still allowed continued synchronization until the collaborator restarted Obsidian. The best results came from splitting work into atomic documents and assembling them via transclusion, while larger teams may be better served by GitHub-style version control.

How does shared vault collaboration work under Obsidian Sync, and what counts against quotas?

A shared vault is created by an owner and invited via email. Every participant must have an Obsidian Sync subscription, but the vault created counts only against the owner’s quota—not each participant’s. The transcript describes each subscriber having a quota of 5 vaults to synchronize, and the owner’s quota is reduced when sharing a vault.

What does “parallel editing” look like in practice, and why does it break down?

When both people edited the same Markdown document at the same time, edit conflicts occurred. The conflict messages weren’t always clear, and the tester didn’t reliably see explicit notices that changes were overwritten. Instead, they observed cases where tags entered by one person were overwritten by the other person’s text, indicating collisions during concurrent edits.

Why is synchronization history less useful for teams than for individuals?

The transcript says synchronization history works well for personal use, but in a team setting it wasn’t strong enough to explain what happened during conflicts. Warnings were inconsistent, and even when warnings appeared, the history was difficult to unravel—making it hard to determine the sequence of conflicting updates.

What happened when permissions were removed from a collaborator?

Removing permissions was described as easy, but the collaborator’s vault continued synchronizing changes after being removed. This continued until the collaborator restarted Obsidian, implying access revocation didn’t immediately stop synchronization updates.

What collaboration structure reduced conflicts the most?

Conflicts dropped when work was split into atomic documents. The main document then used transclusion to pull in those atomic parts. Editing separate atomic files avoided collisions that occurred when both people edited a single large document directly.

When does Obsidian multiplayer sync become a poor fit compared with GitHub-style workflows?

The tester wouldn’t recommend it for teams larger than a couple of people. As team size grows (examples given include 10–15–20 or even 100), collision probability increases and the current conflict/history tooling is too weak to handle frequent edge cases. GitHub sync is suggested because it provides check and checkout features and more robust version history with clearer attribution of changes.

Review Questions

  1. What quota model applies to shared vaults, and how is it different from personal sync?
  2. What specific symptoms of conflict were observed during simultaneous Markdown editing, and how did synchronization history fail to clarify them?
  3. How does splitting work into atomic documents with transclusion change the likelihood of edit collisions?

Key Points

  1. 1

    Shared vault collaboration in Obsidian Sync requires every participant to have an Obsidian Sync subscription, but the shared vault counts against the owner’s quota rather than everyone’s.

  2. 2

    Multiplayer sync mirrors personal sync features, including configurable synchronization of folders, plugin settings, plugin code, and data, plus synchronization history.

  3. 3

    Simultaneous edits to the same Markdown document can trigger conflicts with unclear messaging and overwrites (including tag/text overwrites).

  4. 4

    Synchronization history is less effective for team troubleshooting because it doesn’t provide enough granularity to reconstruct conflict sequences.

  5. 5

    Revoking permissions may not immediately stop synchronization; a collaborator may continue syncing until restarting Obsidian.

  6. 6

    For small teams and carefully partitioned writing (atomic documents + transclusion), multiplayer sync can work well; for larger teams, GitHub-style version control is positioned as more reliable and transparent.

Highlights

Shared vaults extend personal sync by adding invitations and collaboration, while keeping the same configurable sync scope (folders, plugins, data) and synchronization history.
Parallel editing of the same Markdown document produced conflicts that were not always clearly communicated, including cases where one person’s tag entries were overwritten by the other’s text.
Permissions removal was not immediately effective; the collaborator’s changes continued to synchronize until Obsidian was restarted.
Atomic-document workflows with transclusion dramatically reduced conflicts compared with editing a single large document together.
For teams beyond a couple of people, the current conflict and history tooling makes Obsidian multiplayer sync a risky choice compared with GitHub-style version control.

Topics

Mentioned