Export and import

Everything TabOasis holds can be taken out as a file, with no account and no licence. There are three exports, and they are for different jobs.

	Format	Covers	Can be imported back
Export JSON	data.json	the active profile	Yes — Import
Export to Markdown	bookmark-manager-export-YYYY-MM-DD.md	the active profile	No
Profile export	name-profile.json	one profile	Yes — Import Profile

The first two are under the gear → Data Management. The third is the down arrow on a row in the profile switcher.

Export JSON — the backup

The one to keep. It is the active profile written out in full:

• every column, with its sort preference
• every bookmark, task, note and tab group, including archived ones
• folders and their order
• your tag definitions
• Focus mode data — sticky notes, session history, backgrounds, playlist — and your Pomodoro settings

It does not contain your other profiles, your account, your licence, your settings, or your API key.

Import — and what it replaces

Import opens a file picker for a .json and then rebuilds the current profile from it. This is a replacement, not a merge: the columns and cards in the file become the columns and cards you have.

Import overwrites the profile you are in

There is no confirmation step and no undo. Switch to — or create — the profile you want the data to land in before you press Import. If you want the file to arrive as a new board without touching this one, use Import Profile in the profile switcher instead.

A file that is not a TabOasis export, or one whose structure is wrong, is rejected with Invalid data file and nothing changes.

Older exports still work. One quirk worth knowing: a backup made before tags existed carries none, and importing it leaves your current tag definitions in place rather than wiping them. The same is true of folders — an import with no folders in it does not clear the folders you have.

Export to Markdown — the readable one

A single .md file, for pasting into a document or reading anywhere. Structure:

• # TabOasis Export and the date
• ## Column name for each column that has anything in it
• inside a column, items grouped under Bookmarks, Tasks and Notes
• then ### 📁 Folder name for each folder, with the same grouping inside

Bookmarks come out as Markdown links with their description after a dash; a tab group is a bold title with its URLs beneath it; tasks come out as - [ ] / - [x] with any due date; notes are rendered from rich text into plain Markdown. Tags appear in parentheses after the title.

Two things it leaves out: archived items, and any column with nothing in it.

It is one-way. There is no Markdown import, so this is a format for reading, not a backup.

Profile export and import

The down arrow on a profile row writes that profile out on its own, named after it — work-profile.json. It carries the profile’s name, avatar, columns, cards, folders and tags, and nothing else. No focus data, no settings.

Import Profile, in the same menu, always creates a new profile from such a file; it never overwrites the one you are in. That makes it the safe way to move a board between machines by hand, and the right way to hand a board to someone else. If you are already at your plan’s profile limit it does not open a file picker at all — it opens the upgrade dialog instead.

Related

• Importing Chrome bookmarks — brings in a browser export, and adds rather than replaces.
• Cloud sync — the same data moved between your own devices through your account instead of through a file. Still something you press, not something that happens.