# 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





Word: .docx



PDF: .pdf



Web pages: .html and .htm



Markdown: .md and .markdown



Text: .txt



Zip: a .zip containing one HTML or Markdown document and its images

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





Open the page or space in the editor.



Select the Extensions button in the editor toolbar, then select Import Document. Typing /import in the editor opens the same option.



Select Choose a file, or drag a file onto the window.



If the page already has content, choose where the document should go.



Select Import.





Where the document goes

When the page already has content, two options are available:





Add at the cursor: the document is placed where the cursor was, keeping what's already on the page.



Replace the page's content: everything in the editor is swapped for the document.



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.





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:





Headings, paragraphs and line breaks



Bulleted and numbered lists, with checklists shown as ☐ and ☑ items



Tables



Links



Images



Bold, italic, underline, strikethrough and highlighted text



Text colours, matched to the closest colour in the site's theme



Code, quotes and dividers



Notes and callouts, which become information panels

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.





Scanned PDFs: a PDF with no selectable text, such as a scan, is imported as pictures of each page.



Charts, diagrams and embedded objects: these can't be imported. Add them to the page as images instead.



Images in EMF or WMF format: these older Word formats can't be shown on the web and are left out.



Images linked from outside the document: images that are linked rather than saved inside a Word file can't be imported.



Missing images: an HTML or Markdown file imported on its own can't include its image files. Import it as a zip instead.



Zips with more than one document: only one document is imported from each zip. Import the others one at a time.



PDF layout: PDFs don't store tables or text colours in a way that can be rebuilt, so these may need tidying after the import.



Unsupported files

These files can't be imported directly. Each one can be saved as a supported file first.





Older Word files (.doc) and Rich Text (.rtf): open the file in Word and save it as a .docx.



OpenDocument (.odt): save the file as a Word .docx.



Apple Pages (.pages): export the document as Word (.docx) or PDF.



Saved web archives (.mht, .mhtml): save the page in the browser as "Web Page, HTML only" and import that.



Password protected PDFs: remove the password, then import the PDF again.



Limits

Large files are supported, with a few limits to keep imports reliable:





A conversion can take up to two minutes. Very large files may need to be split into parts.



PDFs import up to their first 300 pages.



Up to 200 images are imported from a single document.



Each image can be up to 25MB.

If several large files are being imported at once, Docvora may ask for the import to be tried again a minute later.

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.

> **Info:** 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

- **Word:** `.docx`
- **PDF:** `.pdf`
- **Web pages:** `.html` and `.htm`
- **Markdown:** `.md` and `.markdown`
- **Text:** `.txt`
- **Zip:** a `.zip` containing one HTML or Markdown document and its images

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

> **Info:** To increase upload limits, [contact our support team](https://docvora.com/contact).

### 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](https://docs.docvora.com/pages/uploads/296925202162888704.png)

### Where the document goes

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

- **Add at the cursor:** the document is placed where the cursor was, keeping what's already on the page.
- **Replace the page's content:** everything in the editor is swapped for the document.

### 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](https://docs.docvora.com/pages/uploads/296925202167083008.png)

### 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:

- Headings, paragraphs and line breaks
- Bulleted and numbered lists, with checklists shown as ☐ and ☑ items
- Tables
- Links
- Images
- Bold, italic, underline, strikethrough and highlighted text
- Text colours, matched to the closest colour in the site's theme
- Code, quotes and dividers
- Notes and callouts, which become information panels

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.

- **Scanned PDFs:** a PDF with no selectable text, such as a scan, is imported as pictures of each page.
- **Charts, diagrams and embedded objects:** these can't be imported. Add them to the page as images instead.
- **Images in EMF or WMF format:** these older Word formats can't be shown on the web and are left out.
- **Images linked from outside the document:** images that are linked rather than saved inside a Word file can't be imported.
- **Missing images:** an HTML or Markdown file imported on its own can't include its image files. Import it as a zip instead.
- **Zips with more than one document:** only one document is imported from each zip. Import the others one at a time.
- **PDF layout:** PDFs don't store tables or text colours in a way that can be rebuilt, so these may need tidying after the import.

---

## Unsupported files

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

- **Older Word files (**`.doc`**) and Rich Text (**`.rtf`**):** open the file in Word and save it as a `.docx`.
- **OpenDocument (**`.odt`**):** save the file as a Word `.docx`.
- **Apple Pages (**`.pages`**):** export the document as Word (`.docx`) or PDF.
- **Saved web archives (**`.mht`**,** `.mhtml`**):** save the page in the browser as "Web Page, HTML only" and import that.
- **Password protected PDFs:** remove the password, then import the PDF again.

---

## Limits

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

- A conversion can take up to two minutes. Very large files may need to be split into parts.
- PDFs import up to their first 300 pages.
- Up to 200 images are imported from a single document.
- Each image can be up to 25MB.

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