Skip to content
Lithium Docs

Import & Export

Lithium supports exporting your data as JSON and importing from other note-taking tools. But let’s be honest about the gaps.

Exporting your data

Open Settings (gear icon in the sidebar) and go to Data Sync. Click Export to download all your blocks as a JSON file.

The export includes:

  • All pages and blocks
  • Block metadata (type, order, nesting, timestamps)
  • Todo states, priorities, dates
  • Event details
  • Voice note transcriptions

What’s NOT included:

  • Audio files themselves (only transcriptions)
  • Images and attachments
  • Encryption keys (by design)

The export is unencrypted JSON. It’s meant for backups and data portability, not for secure storage. Keep it safe.

Importing data

From Lithium backup

If you’ve exported data from Lithium, you can import it back. Open Settings > Data Sync, click Import, and choose From Lithium backup (.json).

The import will:

  • Skip blocks that already exist (by ID)
  • Add new blocks to your database
  • Preserve block relationships (parent/child, page structure)

It won’t overwrite existing data. If you want a clean slate, use the “Clear local data” option first (see below).

From other tools

Lithium can import from:

  • Roam Research (.json export)
  • Obsidian (.zip export)
  • Logseq (.json export)

These importers do their best to map nested outlines, todos, and dates into Lithium’s block structure. But they’re not perfect. Some formatting or metadata may be lost in translation.

To import from another tool, click Import and choose the appropriate source from the dropdown.

Data portability commitment

We’re building Lithium to be yours, not a prison. You should be able to leave at any time with your data intact.

Right now the export is partial. Audio files and images aren’t included. That’s a real limitation and we’re working to fix it. The goal is full export/import parity — everything you put in, you can take out.

If you run into issues with import/export, let us know. This is a priority.

Clear local data

If your local state gets weird, you can wipe your local cache and re-sync from the server. Go to Settings > Data Sync > Clear local data.

This won’t delete anything on the server. It just clears the local database and forces a fresh sync.

For actual account deletion, go to Settings > Account > Delete Account. That’s permanent and removes everything from the server.