Migrate from Tana in a few clear phases: model first, then files.

For general import docs, see:

• Import content to Capacities
• Bulk Import Reference

Quick migration flow

1. Map your Tana structure to Capacities object types and properties.
2. Export your Tana workspace as Markdown.
3. Prepare files and media.
4. Review mapping in Bulk Import, then import.
5. Verify results and fix any gaps.

Warnings

• Use Markdown export, not JSON
• Do not continue if mapping looks wrong

Understand the paradigm shift

Tana models content with supertags and fields. Capacities models content with object types and properties.

A clean migration usually depends more on model mapping than on export mechanics.

If you want a deeper explanation of this shift, read Understanding the paradigm shift.

Map structure before export

In Tana, structure is based on supertags and fields.
In Capacities, structure is based on object types and properties.

Create key object types first (People, Projects, Meetings, etc.), then add core properties.

Before import, group your exported Markdown files into noun-based folders where possible. Alternatively, add a YAML type field to each file.

Then create the same type names as object types in Capacities.

For supertags that are not noun-like, either:

1. Rename/restructure them into noun-based types before import, or
2. Import them as Pages (good for free-form notes, but without properties).

Export from Tana as Markdown

Use Markdown workspace export (not JSON):

• Open workspace options (ellipsis)
• Select Export workspace as Markdown

If export fails, reduce scope and migrate in smaller batches.

Prepare files and media

Before importing:

• Unzip the export
• Organize files into clear type-based folders
• Keep filenames clear and unique
• Collect media separately

Review mapping, then import

In Capacities, go to Settings > Migrate from another tool > Click the spanner icon, then upload folders.

Before importing:

• Confirm recognized object types look correct
• Optionally add an import marker
• Fix folder/type setup first if the preview is wrong

Then click Analyse, review, and click Import. Keep Capacities open until import completes.

Verify after import

Check:

• Titles and object types
• Property mapping from key Tana fields
• Internal Markdown links
• Media availability on notes that referenced images/videos