Migrating Knowledge into Guru

Importing 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.

Reviewing the import summary

For every import type except Spreadsheet and Guru, Guru shows an import summary before anything is created. Review it, then click Continue import to create your Cards, or Cancel to stop.

The summary shows:

• Failed: pages that couldn't be imported at all. They're listed by title.
• Imported with problems: Cards that were created, but where something couldn't be reproduced exactly, for example a link that points to a page that isn't in your export.
• Skipped: pages that intentionally don't become Cards, such as empty pages, tables of contents, or a Confluence space's index page.
• Missing images: images a page refers to that weren't in your export.
• Where your pages land: how many Cards are at the top of the Collection, in folders that match your source, and in merged folders. Guru supports 3 levels of folders, so deeper levels are combined into the third level and named after the levels they contain, for example Escalations / Tier 2.
• Notes, when they apply, for example images that are still hosted by the source app, or Word changes and comments that weren't imported.

---

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

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).
• To import several documents, zip them together. To import a Google Drive folder, right-click it in Drive and select Download; Drive zips it with every Google Doc converted to .docx.

Folders: the folders inside your zip become folders in Guru, up to 3 levels. If everything in the zip is inside one top folder (as in a downloaded Drive folder), that top folder becomes the Collection itself. Documents at the top level of the zip become Cards at the top of the Collection. To give each document its own folder, put each one in its own folder before you zip them.

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.

What to expect

• Cards use Guru's editor: headings, lists, tables, images, links, code blocks, dividers, underline, colors, and alignment are kept.

• When you split a document into Cards:

  • A heading with nothing under it is skipped, and listed on the import summary.
  • A table of contents is skipped instead of becoming a Card.
  • Links to headings in the same document become links between Cards.
  • Footnotes stay with the Card that refers to them.

• Word only:

  • Tracked changes are imported as if they were accepted.
  • Comments, headers and footers aren't imported.
  • Equations are kept as text.

  The import summary tells you when any of these apply.

---

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.

---

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.

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.

Your page tree is kept: the space's home page and its top-level pages become Cards at the top of the Collection, and pages below them go into matching folders. The space's index page and Confluence folders aren't Cards, so the import summary lists them as skipped. Panels become callouts, and expand sections become collapsible sections.

---

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.

Your wiki's sidebar decides where pages land: a page nested under another page in the sidebar goes into a folder named after it. Wiki links between pages become links between Cards, and files committed to the wiki (such as images and PDFs) are imported with the pages that use them.

---

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 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. Import a Markdown file with the Slab option, a .docx file with Word Docs, and a PDF with PDFs.\
  

Importing into Guru

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

Your topics become folders, and a post that's in several topics appears in each of those folders.

If you choose Slab for Markdown that didn't come from Slab, the import summary suggests the Markdown option instead. Click Cancel and import it again with Markdown to keep its folders, page titles, and front matter.

---

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.

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.

---

Importing Markdown files

Use the Markdown option for any Markdown content: documentation kept in a code repository, an Obsidian vault, or a wiki exported as Markdown (for example, from Azure DevOps or GitLab).

Preparing your Markdown files

• Zip the folder that holds your .md files, together with any images and files they use. You can also upload a single .md file.
• The folders inside your zip become folders in Guru, up to 3 levels. If everything is inside one top folder, that folder becomes the Collection itself. An index.md or README.md file is an ordinary Card in its folder.

Importing into Guru

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

What to expect

• Card titles come from the title in a page's front matter, then from its first # heading, then from the file name.
• Front matter:
  • tags or keywords become Guru tags. A tag with a colon, such as status:draft, becomes a categorized tag.
  • url, source, or permalink becomes the Card's source link.
  • Any other keys, including dates, appear in a table at the top of the Card.
• Markdown features:
  • Tables, code blocks, images, and links are kept.
  • Task lists keep their checked state.
  • Footnotes appear at the end of the Card.
  • Callouts (> [!NOTE]) and admonitions (:::tip) become Guru callouts.
  • <details> sections become collapsible sections.
  • A YouTube link on its own line becomes a video.
• Links between pages, including wiki-style links like [[Page]] or [[Page|Text]], become links between Cards.
• Images and files in your zip are imported with the pages that use them. Images linked from elsewhere on the web stay as links.

---

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 Markdown 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.

---

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:

• Import a .zip directory
• Validate a manual import

---

Using external Sources with Guru Answers

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

Guru can surface answers from linked sources in:

• Guru web app
• Slack
• Browser extension

---