Importing Documents

Import Document brings the content of an existing file straight into the editor. Headings, lists, tables, links, images and text styling are carried across where the file has them, so documentation written in Word, Google Docs or another tool doesn't need to be retyped.

Nothing is saved until the page is saved, so an import can be checked and tidied first.

Import Document is an editor extension, available on Pro and Enterprise plans. It can be used by staff who can create or edit pages or spaces.


Supported files

Files must be within the site's upload limit, which is 100MB by default.

To increase upload limits, contact our support team.

Files with images

Word documents and PDFs carry their images inside the file, so they can be imported on their own.

HTML and Markdown files keep their images as separate files. To bring the images across, place the document and its images in a .zip and import the zip. Exports from Google Docs (File > Download > Web Page) and most Markdown tools are already in this format.

Images that point to a public web address are copied into Docvora during the import.


Importing a document

  1. Open the page or space in the editor.

  2. Select the Extensions button in the editor toolbar, then select Import Document. Typing /import in the editor opens the same option.

  3. Select Choose a file, or drag a file onto the window.

  4. If the page already has content, choose where the document should go.

  5. Select Import.

The Import a document window with a Word file selected

Where the document goes

When the page already has content, two options are available:

Page title

When Use the document's title as the page title is ticked, the document's title fills the page title, and the matching heading is taken out of the content so it doesn't appear twice. The option is ticked automatically for pages without a title.


After importing

Once the import finishes, the content appears in the editor and can be edited like any other content. Review it, make any changes, then save or publish the page as usual.

If anything couldn't be brought across exactly, the window stays open and lists what to check, such as images that were left out. Select Done to close it.

The import summary listing items to check

Undoing an import

An import can be undone straight away with Ctrl + Z (⌘ + Z on a Mac), the same as any other change in the editor.


What comes across

Docvora carries across the following where the file has them:

Markdown callouts such as > [!NOTE] and > [!WARNING] also become information panels.


Things to check

Some content can't be converted exactly. Docvora lists anything affected in the summary after the import.


Unsupported files

These files can't be imported directly. Each one can be saved as a supported file first.


Limits

Large files are supported, with a few limits to keep imports reliable:

If several large files are being imported at once, Docvora may ask for the import to be tried again a minute later.