Link records in Aha! with existing records in another system

Coming soon: We are introducing a fresh new look for record drawer and details pages on September 30, 2020. This article describes the current experience. Preview the upcoming improvements in your account now so you can get familiar with the new way of working in Aha!

  • Switch to the new experience using a toggle in the More options button in the drawer of each record.
  • The toggle is unique to each user — so you can opt in and out as often as you like.
  • We also updated the application font in the new experience for improved text legibility.

Once you have set up your development tool integration, you may find that you have records that already exist in both Aha! and your development system. It’s important to keep everything in sync without creating duplicates, so Aha! allows you to link Aha! records with existing records in your development tool.

How it works

In the Integrations section for a mapped record type, you will see a Send dropdown. When you open this dropdown, choose Link with existing record

Note: The "Link with existing record" option is available on all 2.0 integrations as well as the Jira 1.0 integration.


You will be asked to identify the record that you would like to link. The unique identifier will be different for each development tool, so make sure to follow the instructions presented on the screen.


When the record has been found in your development tool, you will need to determine which system contains the data that you would like to use. You have two options:

  • Use Aha! and overwrite [development tool]: This option creates a link between the two records and updates your development system with the data found in Aha! for your mapped fields.
  • Use [development tool] and overwrite Aha!: This option creates a link between the two records and updates Aha! with the data found in your development system for your mapped fields.

If a field contains no data, it will remove data from the mapped field in the tool you choose to overwrite. Aha! will display the fields that are mapped along with the data they contain to help you make the best choice.


Once your records are linked, the link will appear in the Integrations section of your record.

Relationship links

If you are using relationship links in your integration, you’ll want to follow a simple rule. Always start at the top by linking the parent record first. This ensures that the child records will retain the proper parent relationship when they are linked. Here is a basic order for how you would link the records.

  • Release
  • Initiative
  • Epic
  • Feature
  • Requirement

Keep in mind that your integration may not contain relationship links for all of these record types. You can always skip linking those records that aren’t applicable to your integration.

When linking any record, Aha! does not attempt to link any of the child records. These must be linked individually.

When you link a child record without first linking the parent records, you will encounter some unexpected behavior —

Use Aha! and overwrite [development tool]:

  • The parent links will be lost in both Aha! and your development tool.
  • If you attempt to link a requirement that doesn’t have a linked parent feature, you will receive an error because the parent record in the development system is unknown.

Use [development tool] and overwrite Aha!:

  • New parent records will be created (duplicated) in Aha! and your record will be linked to the new parent records.

Was this article helpful?
1 out of 2 found this helpful