Learn how to use our Confluence importer to easily bring your information from Confluence spaces into Coda.
Ready to bring your Confluence space into Coda? We’ve built a convenient importer just for this purpose. This article will walk you through the steps.
Within this article, you’ll find...
Before you get started
Before you start importing from Confluence into Coda, there are a few things to think about to ensure a seamless transition.
Preserving people references: To preserve people references (i.e. @Jane Doe), start with a blank Coda doc and share it with those referenced in your Confluence space before you start your import. Usernames must match across Confluence and Coda in order for people references to be preserved.
Importing multiple Confluence spaces: A Confluence space will feel similar in structure to a Coda doc. We enabled importing multiple spaces at once into a single Coda doc so that users could easily bulk import their Confluence data. If you want to import multiple spaces at once but also keep each space in a separate doc, you can use the Copy to Doc feature after the import in order to move a page (representing your Confluence space) to another doc.
Initiate your Confluence import
Start by creating or opening the doc you want to import your Confluence space into. Then you can launch the Confluence importer by following these steps:
-
On any blank line in the canvas, type /Confluence. Then select Confluence (within the Import options).
Alternatively, you can initiate the import by clicking on Insert in the upper-right corner of your doc, then searching for "Confluence," and selecting Confluence (within the Import section).
-
You'll then be prompted to select which type of Confluence site you're importing from: Cloud or On-premises. Check out the "How do I decide?" button for more info.
Note that the Confluence On-premises importer is only available to customers on our Enterprise tier. To learn more about using the on-premises importer, check out this resource. But if you are connecting to Confluence Cloud, you can continue with the steps below.
-
Next, you can either choose an existing Confluence account (if any have already been connected), or select + Add New Account to connect a new account.
Adding a new account will redirect you to Atlassian to sign in to your Confluence account. Follow the steps there to log into your Confluence account and authenticate.
Then select the pages you want to import. You can either copy and paste the Confluence page link, or you can select Browse Confluence spaces then choose from the list. You can even use this tool to select multiple spaces.
-
Once selected, click the Import button to initiate.
Be patient as your space is uploading. Large files may take up to a few hours to fully import into Coda. Try minimizing your browser window and let the importer run in the background while Coda does all of the work for you. Whatever you do, don’t close your browser window! Closing the window will cancel the import of your Confluence space(s) into Coda.
Once your space(s) have been imported, click Show me to find your Confluence space(s) in Coda. And that’s it. Your import is complete, and you can start using Coda!
After importing
Once your import is complete, there may be a few finishing touches that are needed to ensure a smooth migration to Coda. You should see a new page in your doc, titled Read me: Import next steps. This page is automatically added to help you with any next steps or fixes to your import.
To learn more, select the Import fixes subpage, since this is where we note some limitations of what can be imported from Confluence. In the table, you will find a complete list of all the issues in your recent import, along with a suggested solution and a link to the location of the issue. We've even included columns to help you assign issues to someone and track the resolution of these issues.
Once all issues have been successfully resolved, or you're satisfied with what you've resolved so far, you can simply delete the Read me: Import next steps page and its subpages. Alternatively, you can hide the pages to save for future reference.
FAQs
Do you have an importer for Confluence Data Center?
The importer described in this article is only for Confluence Cloud. But for customers on our Enterprise tier, we do also offer a Confluence Data Center / on-premises importer. You can read about the importer for on-premises here, or reach out to your Coda account team or to Coda Support to learn more.
Can I import a folder that lives within a Confluence space?
Yes - we've enabled the ability to select and import a folder that lives inside a space. When you do so, the page hierarchy in Coda should automatically match the folder hierarchy from Confluence.
Do you have importers for any other tools?
Yes! We currently have importers for Notion, Airtable, Google Docs, and Trello. We also have other means of importing data into Coda, which you can read all about here.
How can I learn more about choosing Coda versus Confluence?
Great question! We recommend checking out this Ultimate Confluence vs. Coda Evaluation Guide in our Gallery. Here you'll find an in-depth comparison of features, use cases, and more.