Import Content into Confluence
Import content into Confluence, where it can then be searched for, tagged, and organized.
On this page:
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'll need to create an XML export of that content before importing it into your site. See Migrate from Confluence Server to Cloud and Import a Confluence Space for more information.
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:
- Create a page in Confluence or go to an existing page (you want to view the page, not edit it).
- From the top right of the page, choose > Import Word Document
- Choose Select file to import and locate the Word document you want to import then choose Import. This will take you onto the Import configuration step.
- 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.
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.
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.
Screenshot: Import Word options for a document that contains multiple heading levels.
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.
From the Atlassian Marketplace
- Import and export spreadsheets using Excellentable Spreadsheet for Confluence
- Embed Google Drive and Docs files with Google Drive & Docs for Confluence
- Display and search for Saleforce data from Confluence using the Salesforce & Confluence Cloud Connector
- Import data into Confluence to use it as your CRM with Atlas CRM for Confluence
- Import Visio, Gliffy, and Omnigraffle diagrams using Lucidchart Diagrams for Confluence or draw.io Diagrams for Confluence
- Import documents as Confluence pages and edit in Confluence using the Confluence Universal Importer
- Import markdown, macros, and other information using Github Macros for Confluence, Gister: GitHub Gist Macro for Confluence, or Github Links for Confluence
- Connect various cloud accounts and embed a whole range of documents into Confluence with Office Files & Documents for Confluence