Aha! Roadmaps | Import documents from Confluence

From user research and process flows to engineering documentation and release notes, you have a lot of product information to keep track of. But with documentation scattered across several different platforms, it can be difficult to find the information you are looking for. Centralize your product information you have stored in Confluence (Cloud, Server, or Data Center) and import it into Aha! Roadmaps — so you can have a central hub for product information.

Click any of the following links to skip ahead:

• Overview

• Import records from Confluence

• Find your imported notes

Overview

It is important to understand a few key details about the Confluence importer in Aha! Roadmaps before importing notes:

• You can import notes from Confluence Cloud, an on premises Confluence server, or from Confluence Data Center.

  • If you are unsure where your Confluence instance is hosted, check your Confluence URL. If it contains atlassian.net, then you are using Confluence Cloud.

  • To connect to Confluence Data Center or Server, you may need to complete additional configurations steps:

    • Allow list Aha! Roadmaps in your firewall so it can make connections to your server to create notes.

    • Obtain a publicly resolvable, valid Confluence Server URL to link to during the import.

• Anyone with contributor permissions can import notes from Confluence into any Aha! Roadmaps workspace they have access to.

• The import is not an integration — importing notes from Confluence is a one-time, one-way import from your chosen Confluence space into an Aha! Roadmaps workspace. This means that updating a note in Confluence will not update it Aha! Roadmaps.

• Aha! Roadmaps will attempt to match the original note content and formatting as much as possible. This includes text, font styles, color, formatting callout boxes, labels, tables, and links.

• Images and attachments will be imported along with any note they are attached to and will appear in the same location with the note.

  Supported audio file types include MP3, WAV, and OGG. Supported video files include MP4, WEBM, and OGV and should be under 300MB.

• Some aspects of your Confluence space cannot be imported. In this case, the import will include a link back to the original Confluence note. Unsupported aspects include: user mentions, comments, note history, extensions, and plugins.

Top

Import records from Confluence

Ready to import? Great! Let's get started. Navigate to Settings ⚙️ Workspace Imports Import from Confluence. Then select how your Confluence site is hosted. You can choose between Cloud or Data Center/Server.

If you are not sure where your Confluence instance is hosted, check your Confluence URL. If it contains atlassian.net, then select Cloud.

• Confluence Cloud

  • Enter your Confluence URL, Email address, and API token. Your Confluence URL should include atlassian.net and end with /wiki.

    You can generate a Confluence API token by logging in to your Confluence account and clicking Create API token. Then enter a Label and click Create to generate a token.

• Confluence Data Center or Server

  • Enter your Confluence URL and Personal Access Token (PAT).

• Click Test connection to ensure you can establish a connection between your Aha! account and Confluence.

• Next, select a Confluence space from the dropdown to select the documents you want to import.

• Click Import.

Top

Find your imported notes

After you have imported notes from Confluence, you will find them in your workspace notes in one folder, named after the Confluence space from which it was imported. All imported notes will be organized within the same structure of folders you had configured in Confluence — but you can drag and drop notes or folders individually to reorganize them however it makes sense to you.

Top