Excited about Aha! Roadmaps — but all your data is in your development tool? Do not worry!
You can import records directly into Aha! Roadmaps from your development tool of choice (and even create an integration with that tool at the same time). Once imported, your records will retain their link to the development system, so that you and your development team can collaborate on the same records at once.
Only workspace owners can import data to a workspace.
Click any of the following links to skip ahead:
Or see more information on the integrations that support development tool imports:
Import records
Navigate to User menu -> Settings → Workspace → Import from Jira, Azure, Rally, and more.
First, choose whether you want to import from an Existing integration, or create a New integration and import records from there.
Note: If you choose a Jira integration that is running integrations 1.0, a message prompts you and takes you to the original 1.0 Jira import workflow.Next, select the integration you want to use for your import.
Select which types of records you want to import. The type of records you can import depends on the integration you select, but generally you will be importing records from your development tool as Aha! Roadmaps features/activities, requirements, and releases/schedules.
After selecting the record types you wish to import, you can add filters to the record type being imported.-
Finally, you will see a list of the records you are about to import. Click Import records to import them.
Note: If you import GitHub sub-issues, the Sub-issue records tab does not show a record count, and its preview may list fewer than 10 records. A GitHub API limitation affects the preview only — the import still brings in every matching sub-issue.
Items to note
Imported records automatically populate your Aha! Roadmaps workspace.
Depending on your integration configuration, it can be difficult to import active releases and schedules without also importing all releases or schedules. To avoid importing unwanted data, import features and activities instead of releases and schedules. Aha! Roadmaps also imports the releases and schedules associated with the features and activities you import.
If you do import the wrong records by mistake, don't worry! You can bulk delete any unwanted records using a list report.
-
As records are imported into Aha! Roadmaps, Aha! Roadmaps may make changes to records in your development system:
For any fields configured to send one-way from Aha! Roadmaps, the import updates the field in the development system to match Aha! Roadmaps and create consistency. For example, this is useful when a custom field in the development system stores a hyperlink to the Aha! Roadmaps record — the import populates the hyperlink.
For the GitHub integration, the import adds a link to the Aha! Roadmaps record at the end of each issue's body.
In addition to importing from your development tool you can also import data into Aha! Roadmaps by CSV file.
If you get stuck, please reach out to our Customer Success team. Our team is made up entirely of product experts and responds fast.