Skip to main content

​
Sync Folds

Never lose your fold states again. Sync them automatically across all your devices.

​
What is Sync Folds?

Sync Folds is an Obsidian plugin that solves a common frustration: fold states don’t sync between devices. Obsidian stores fold states in localStorage, which stays local to each device. This plugin changes that by storing your fold states in the plugin’s data.json file, which syncs with your vault.

Get Started

Install the plugin and start syncing in minutes

How It Works

Learn about the technology behind fold synchronization

Commands

Explore manual import and export commands

API Reference

Dive into the technical details and API

​
Key Features

Automatic Sync

Fold states sync automatically as you work

Cross-Device

Works on desktop and mobile devices

Universal Compatibility

Compatible with all sync solutions

Performance

Debounced updates for optimal performance

Manual Control

Commands for manual import and export

Zero Configuration

Works out of the box with sensible defaults

​
How Does It Work?

1

Install the plugin

Install Sync Folds from the Obsidian Community Plugins directory or manually
2

Enable on all devices

Make sure the plugin is installed and enabled on all your devices
3

Fold away

Your fold states automatically sync through your vault’s plugin data file
Sync Folds works with any file syncing solution: Obsidian Sync, iCloud, Dropbox, Git, Syncthing, and more.

​
Compatible Sync Solutions

Sync Folds stores fold states in .obsidian/plugins/sync-folds/data.json, which syncs automatically with:
  • Obsidian Sync — Official Obsidian sync service
  • iCloud — Apple’s cloud storage
  • Dropbox — Popular file sync service
  • Git — Version control syncing
  • Syncthing — Open-source peer-to-peer sync
  • Self-hosted solutions — CouchDB, rsync, and more

​
Quick Start

# Download the latest release
# Copy main.js and manifest.json to:
VaultFolder/.obsidian/plugins/sync-folds/

# Reload Obsidian
# Enable the plugin in Settings → Community Plugins

​
What’s Next?

Installation Guide

Detailed installation instructions for all methods

Quickstart Tutorial

Get up and running in under 5 minutes

Troubleshooting

Common issues and how to solve them

Contributing

Help improve Sync Folds

Build docs developers (and LLMs) love

Get started for freeTalk to us