Import and export

The Import page

Click Import in the Wiki page header, or choose Import from the sidebar's ⋯ menu. The page has three tabs: Slab import, Freshdesk Solutions and Markdown / zip. Every import is recorded under Import history so it can be rolled back as a whole.

Import from Slab

The Slab importer keeps your folder structure, re-hosts every image and can be undone in one step. Export your Slab workspace first; it arrives as a folder of markdown files or a zip of them.

1. On 1. Source, drop the export onto Drop your Slab export here, or use Choose folder or Choose .zip.
2. On 2. Destination, choose where the pages go:
   • Create a new knowledge base and name it (for example Slab Import), or Add to an existing knowledge base and pick one.
   • Place under folder: puts the imported folders inside a folder of your choice. Leave it empty to import at the top level.
   • Make these images publicly accessible is off by default, which keeps the images private to signed-in members. Turn it on only for content that will be served on a public help center.
3. Click Start import. Progress shows as N / N pages · N images · N issues while images are re-hosted; large exports take a few minutes.
4. 3. Done shows the Import report: pages, folders and images imported, any images that could not be fetched (a placeholder is inserted in their place) and pages skipped because a page with the same address already existed. Import another starts again; Roll back this import removes everything it created.

Import a Freshdesk knowledge base

The Freshdesk importer turns a Freshdesk Solutions export into a knowledge base: categories become folders, articles become pages, and published state, tags, search metadata and dates carry over. Images are re-hosted and YouTube or Vimeo embeds are kept.

1. Export your Solutions from Freshdesk and drop the Solutions.json file onto Drop Solutions.json here. The page reports N articles in N folders across N categories.
2. Under Destination, keep New knowledge base… (named Help Center by default) or pick an existing knowledge base. If you run more than one help center, pick the Help-center site the articles belong to.
3. Publish to the help center is ticked by default: it makes the knowledge base public and stores the images publicly so articles work for signed-out visitors. Untick it for an internal-only import. Feature the 3 most-read articles is off by default.
4. Read What this import will do. It says how many articles are new, how many already exist and are skipped, and how many land as drafts because they were unpublished in Freshdesk.
5. Click Import N articles. You can leave the page; the import continues in the background.

When it finishes, the page shows the counts and offers Open the wiki, Help center settings and Roll back.

Import markdown files or a zip

Use this tab for pages written elsewhere as markdown.

1. Pick a Default folder: for the pages, or leave it as the top level. A zip keeps its own folder structure.
2. Drop the files onto Drop files here, or use Choose .md files (markdown or plain-text files, one or many) or Choose .zip.
3. The import runs at once and reports how many pages were created, skipped and had errors.

If a file starts with a front-matter block naming its title, slug, tags or folder, those values are used. Files without one take their title from the file name. Imported pages arrive as drafts in the active knowledge base.

Import history and roll back

Under the Slab and Freshdesk tabs, Import history lists every import with its status (completed, needs attention or rolled back), its knowledge base and its counts. Each has a Roll back button. Rolling back permanently deletes the pages, folders and images that import created, after a confirmation that names the counts; nothing else is touched. Use it when an import went into the wrong place or you want to redo it with different options.

Export

• Export all in the Wiki page header downloads wiki-export.zip: every page in every knowledge base, drafts and archived pages included, as markdown files in folders that mirror the wiki. Each file starts with the page's title, address, folder, tags and status, and image links point at the hosted images.
• Export as .md in a page's ⋯ menu downloads that one page as a markdown file.

An export from Export all can be imported again with the Markdown / zip tab, which is a simple way to copy pages between workspaces.

Next: FAQ and troubleshooting.