Migrating Knowledge into Guru

This article outlines how to migrate your existing knowledge into Guru so your team can start using the platform right away. It includes instructions for importing content directly in the web app, options for manual migration, and automation tools such as Zapier, the Guru API, and Knowledge Sync. It also covers how to use external sources with Guru’s Answers feature—no migration required.

👥

Access Required

You must have Admin + Author access or Collection Owner access for the target Collection to migrate content into Guru.

✍️

Note

Zip files from outside Guru must follow this format to import correctly.


Migrating content into Guru

  1. In the Guru web app, navigate to the Manage tab.
  2. Click Collections.
  3. Click the ellipses ("⋮") in the top-right corner of the Collection you want to import content into.
  4. Select Import Content.
  5. Choose your content source and follow the on-screen instructions to upload your files.

📘

Best practices

  • Keep Cards bite-sized: Use headers to split long docs into multiple Cards.
  • Verify formatting: Post-import, check your Cards for formatting inconsistencies.
  • Plan ahead: Break large exports into smaller files if needed.
  • Use correct formats: Only supported file types and structures will import correctly.

Importing spreadsheet content

Preparing your spreadsheet

Create a spreadsheet (.xlsx or .ods) with the following columns in this exact order on the first sheet:

  • Title (required)
  • Content (required)
  • Boards – comma-separated
  • Tags – comma-separated

✍️

Note

  • Do not add extra columns.
  • Each Card must be on one row.
  • Do not merge cells or include "#" in the Tags column.
  • See example spreadsheet.

Importing the spreadsheet

  1. Go to Manage in Guru.
  2. Click the Collections tab.
  3. Open Collection settings ().
  4. Choose Import Content > Spreadsheet.
  5. Upload your file and click Start Import.

Importing Word documents and Google Docs

Preparing your Word file

  • Save your document as a .docx file.
  • To import Google Docs, go to File > Download > Microsoft Word (.docx).
  • You can also download multiple files as a zipped folder.

💡

Tip

Break long documents into multiple Cards using H1 or H2 headers to make knowledge easier to find.

Importing the Word document

  1. Go to Manage in Guru.
  2. Click the Collections tab.
  3. Open Collection settings ().
  4. Choose Import Content > Word Docs or Google Docs.
  5. Upload your file(s).
  6. If headers are detected, choose to split the document into multiple Cards or import it as one Card.
  7. Click Start Import.

✍️

Note

The content will import as either WYSIWYG-editable Cards or Markdown blocks depending on formatting.


Importing PDFs

Converting PDF contents

Guru does not extract text from PDFs. Convert your PDF to a Word document first, then follow the Word Docs import steps.

Use Adobe’s free converter tools if needed.

Uploading a linked PDF

  1. Go to Manage in Guru.
  2. Click the Collections tab.
  3. Open Collection settings ().
  4. Choose Import Content > PDFs.
  5. Upload your file(s) and click Start Import.

✍️

Note

Each PDF will become a separate Card with a link to the uploaded file.


Importing content from Confluence

Exporting from Confluence

  1. In Confluence, go to the desired space.
  2. Click Space Settings > Export Space.
  3. Choose HTML, then Custom Export.
  4. Deselect "Include comments."
  5. Select pages and click Export.
  6. Download the resulting zip file.

✍️

Note

Files larger than 2GB should be split into smaller zip files.
Macros may not render properly due to format limitations.

Importing the Confluence zip file into Guru

  1. Go to Manage in Guru.
  2. Click the Collections tab.
  3. Open Collection settings ().
  4. Choose Import Content > Confluence.
  5. Upload your file and click Start Import.

Importing content from GitHub

Exporting from GitHub

  1. Copy your GitHub Wiki URL.
  2. Clone the Wiki.
  3. Zip the cloned content.

Importing the GitHub zip file into Guru

  1. Go to Manage in Guru.
  2. Click the Collections tab.
  3. Open Collection settings ().
  4. Choose Import Content > GitHub.
  5. Upload your zip file and click Start Import.

Importing a Guru export file

Preparing your export from Guru

Export a Collection from Guru as a .zip file using the Content Export feature.

Importing the Guru zip file back into Guru

  1. Go to Manage.
  2. Click the Collections tab.
  3. Open Collection settings ().
  4. Choose Import Content > Guru.
  5. Upload your export and click Start Import.

Importing from Zendesk Guide

👥

Access Required

Zendesk and Guru Admin credentials are required.

  1. Set up a Zendesk Knowledge Sync.
  2. Once the sync completes, contact Guru Support to convert it into a standalone Collection.

Importing from Slab

Exporting from Slab

  • Entire Space:
    Go to Team Settings > Import & Export > Export – Published Post.

  • Individual Page:
    Click ... > Export As and choose Markdown, .docx, or PDF. Use the correct import option in Guru based on your export file type.

Importing into Guru

  1. Go to Manage in Guru.
  2. Click the Collections tab.
  3. Open Collection settings ().
  4. Choose Import Content > Slab (or another matching type).
  5. Upload your file and click Start Import.

Importing from Notion

Exporting from Notion

  1. Go to Settings & Members > Settings > Export all workspace content (HTML).
  2. Or, export individual pages/databases in HTML format.
  3. Download the .zip file from the email sent by Notion.

Importing into Guru

  1. Go to Manage in Guru.
  2. Click the Collections tab.
  3. Open Collection settings ().
  4. Choose Import Content > Notion.
  5. Upload the .zip file and click Start Import.

Importing from Google Sites

Exporting from Google Sites

  1. Move the Site to a top-level Drive folder.
  2. Go to Google Takeout.
  3. Select only the Site folder to export as .zip.
  4. Download the export file.

✍️

Note

Classic Sites must be converted to new format before export.

Importing into Guru

  1. Go to Manage in Guru.
  2. Click the Collections tab.
  3. Open Collection settings ().
  4. Choose Import Content > Google Sites.
  5. Upload your zip file and click Start Import.

Migrating content manually

If you're importing content from platforms such as Bloomfire, Jive, Intercom, Tettra, ClickUp, WordPress, or Document360 and don’t see your source listed in Guru’s import tool:

  • Markdown exports can be imported using the Slab option.
  • HTML exports can be imported using the Confluence option.

Automating content imports with Zapier

If your team uses Zapier, you can build automations (Zaps) to create Guru Cards based on actions in other apps.

Example:
Trigger a new Guru Card when a new Google Doc is created.

📘

Best Practices

Check out these Zap templates for inspiration: Zapier + Guru


Importing content via API

Guru offers a JSON-based RESTful API for teams who want to programmatically import content.

To get started, first generate your API credentials, then use the guides below:


Syncing external content with Guru

Use Guru Knowledge Sync to automatically bring in content from:

  • Salesforce
  • Zendesk
  • Confluence

Using external Sources with Guru Answers

If your workspace has Guru Answers enabled, you can link external tools as searchable sources—no need to migrate content.

Guru can surface answers from linked sources in:

  • Guru web app
  • Slack
  • Browser extension

👀

Want a closer look at some key Guru features and best practices?

Check out our events page for demos, workshops, new release roundups, Getting Started bootcamp, guest panelists and more! For upcoming live events and a library of past recordings: Click here to register