Help Center› Your Files & Sync› canvas-data.json & board.json

Your Files & Sync

What’s inside your folder: canvas-data.json & board.json

The folder includes both your readable files and information used to reconcile and recover changes.

More in Your Files & Sync
  1. How storage works
  2. canvas-data.json & board.json
  3. Where are my notes?
  4. Sync across devices
  5. The “Keep Downloaded” fix
  6. Version history
  7. Backups (export & import)
  8. Conflicts & merging
  9. The New Items pool
  10. iPhone photos (HEIC)
  11. Editing files outside the app
  12. Disconnect or move the folder

Keep the whole workspace together

File or folderPurpose
canvas-data.jsonThe complete workspace: every board, element, position and text. All devices read and write this file to stay in sync. Do not edit or delete it by hand.
.vos-sync/Only present if the folder was used with a preview build. The current version does not use it. Leave it in place.
board.jsonA readable description of one board; not a supported canvas-editing interface.
Markdown, images, audio, video and other filesOrdinary files alongside their board data. Some preview files live in hidden subfolders.
.versions/ and other canvas-data.….json filesRecoverable workspace states: automatic snapshots in .versions/ (the newest 30 are kept), versions preserved from sync conflicts, and copies kept before a restore, an import, an overwrite and similar replacements. Copies outside .versions/ stay until you delete them. Settings → Versions lists all of them. They refer to separate media files and are not self-contained backups.
.originals/Originals retained after supported import conversions.

Copying and backing up

Copy the entire downloaded folder, including hidden files. A visible project subfolder is useful for reading or sharing, but the complete workspace lives in canvas-data.json at the top of the folder. Use a complete backup export for a portable app backup.

Version snapshots take additional storage. Do not delete them to troubleshoot a space warning; arrange independent backups and free unrelated space first.

Using ordinary tools

You can read documents and media with other apps, and edit images, PDFs and other files in place. What happens then, and what belongs in the app, is described in Editing files outside visualOS.

Didn’t find what you need?

Tell us what’s missing — feature ideas and bug reports land directly on our roadmap. Or just open the canvas and poke around; you can’t break anything.