Import content into Confluence Cloud

Import content into Confluence, where it can then be searched for, tagged, and organized. 

Import web content

If you have web content that you want to import into Confluence, you'll need to import it page by page. Any text with basic formatting can be pasted directly into the editor, and you can use the Widget Connector Macro to display videos, slide shows, tweets, and more.

Import content from another Confluence site

If you're importing content from another site, you may need to create an XML export of that content before importing it into your site. See Plan your Confluence Server to Cloud migration and Import a Confluence Space for more information.

Migrate content from Confluence Server to Confluence Cloud

If you're migrating from Confluence Server to Confluence Cloud, you can use the Confluence Cloud Migration Assistant to migrate your content and spaces. 

Import Word documents

You can import Word documents as a single page, or divide the contents up into multiple pages, based on the headings in your document. This is useful if you have a lot of content stored in existing documents, or if you are migrating from another system or platform that allows you to export to Word format. 

To import a Word document:

1. View an existing page.  The page chosen becomes the parent page of the document imported.
2. From the top right of the page, choose  •••  > Import Word Document.
3. Choose Select file to import, locate the Word document you want to import, then choose Import. The  take you onto the Import configuration step.
4. Choose the import options you want (see below for more info), and then Import. 

When the upload has finished, pages will be created with the content of the Word documents. You can then view and edit this page as normal. There's no further connection between the original Word document and this page.

Import options

Root page title

By default, your file name becomes the page title, but you can customize the page title. Choose a descriptive title to make your new page(s) easier to find. 

Where to import

Where should these new pages live?

• Import as a new page in the current space - a new page will be created as a child of the space home page.
• Replace <page name> - content will be imported into the current page. The title of this page will change to the title you specified in the Root page title field.
• Delete existing children of <pagename> - any existing children of the current page will be removed when the content of the page is replaced.

Title conflicts

How page name conflicts (a page with the same title already exists in the space) are handled.

• Rename imported pages if page name already exists - new pages get a new name (a number added to the end of the page title). Existing pages stay unchanged.
• Replace existing pages with imported pages of the same title - overwrite the content of existing pages. The change will be shown in the Page History for the page.
• Remove existing pages with the same title as imported pages - remove original pages and then create new pages. The change is not shown in the Page History for the page.

Split by heading

If the document contains Word heading styles you can choose to create multiple pages based on the heading.

• Don't split - creates a single page.
• Level Headings - creates multiple pages in a hierarchy based on the heading levels in the document.

A preview of the pages that will be created appears under Document Outline.

Other things you might find useful

• Full-featured customization is available using the Confluence APIs.

• You can upload your files and edit them inside Confluence using the Atlassian Companion App.