- Overview
- Scorecard
- Updates3
Keep your folded headings, lists and properties the same on every device.
Why
Obsidian saves fold states in each device's localStorage, so they never leave the device they were made on. Fold a long note on your laptop, open it on your phone, and it's fully expanded again.
Sync Folds stores every fold in the plugin's data.json inside your vault, so your folds travel with your notes.
How it works
| When | Sync Folds… |
|---|---|
| The plugin loads | Applies the saved folds, or saves this device's folds if none exist yet |
| You fold or unfold something | Saves the change to data.json (debounced to 150 ms) |
data.json changes from another device |
Applies the new folds to this device |
There's nothing to configure. Install it on every device that shares the vault.
Works with your sync service
Fold states live in .obsidian/plugins/sync-folds/data.json, so anything that syncs your vault folder syncs them too:
- Obsidian Sync: turn on Installed community plugins under Settings → Sync → Vault configuration sync.
- iCloud, Dropbox, OneDrive or Google Drive
- Git
- Self-hosted options such as Syncthing, Nextcloud or CouchDB
Commands
| Command | What it does |
|---|---|
| Export folds from local storage | Saves all of this device's current fold states to data.json |
| Import folds into local storage | Applies the fold states in data.json to this device |
You shouldn't normally need these. They're there if a device ever gets out of step.
Installation
From Community Plugins
- Open Settings → Community plugins.
- Turn off Restricted mode if prompted.
- Click Browse and search for "Sync Folds".
- Click Install, then Enable.
Manual installation
- Download
main.jsandmanifest.jsonfrom the latest release. - Copy them into
<your vault>/.obsidian/plugins/sync-folds/. - Reload Obsidian and enable Sync Folds under Settings → Community plugins.
Compatibility
Works on desktop and mobile. Requires Obsidian 0.15.0 or later.
Related plugins
- Fold Properties folds the properties of a note, a folder or your whole vault in one click. Sync Folds carries those folds to your other devices.
- Quick Select lets you pick any item in any Obsidian list with Mod + number.
Support
If your folds now follow you around, consider sponsoring its development.