Aha! Develop | Notes

Use notes to create wiki-like documentation for your team. Document processes, architecture changes, scrum ceremonies, or anything else that will help your team complete excellent innovative work.

Click any of the following links to skip ahead:

Create notes

Create a blank note

  1. Navigate to Documentation Notes and click Add note → Blank or use the appropriate keyboard shortcut.

  2. A blank note will appear.

Use the text editor to create your note and format it with headings, lists, tables, and inline images. You can also assign to-dos and watchers and start a discussion in the note's comments.


Create a note template

Note templates bring consistent structure to your documentation. Aha! Develop comes with seven prebuilt templates for you to choose from. If you are a team owner, you can also create custom note templates for your teams. Contributors can create notes from existing templates.

Shared note templates are customizable using the Aha! text editor, so you can add tables, images, and even Aha! views.


Create a note from a template

To create a note from a template, navigate to Documentation Notes and click Add note From a template or use the appropriate keyboard shortcut. The Add note modal will appear and you will see sections for Shared templates and Example templates. The Shared templates section includes note templates available in your particular team. The Example templates section includes the following prebuilt templates:

  • Architectural decision record

  • Incident postmortem

  • Meeting agenda

  • Meeting notes

  • Process improvement

  • Runbook

  • Sprint retrospective

You can click on a template to see a preview of it. Select the template of your choice and click Add note. Use the text editor to adjust your note to your needs. You can also assign to-dos and watchers and start a discussion in the note's comments.


Create a personal note

Personal notes are visible only to your user. Use them to document thoughts not applicable to or not yet ready for the rest of your team. Navigate to your user's My work page under your profile picture to create a personal note.

Personal notes are only visible to you. Just like team-level notes, personal notes use the full Aha! text editor, and can #mention other records (though will not create persistent record links). You cannot @mention other users in your account.

If you have a personal note that you would like to share with others, you can either share it or move it:

  • Click the Share icon to Export your note to PNG image or PDF document.

  • Click the More options menu in the upper-right corner of a note to Copy or Move it from your personal notes out to a team's Documentation Notes page. Once you move a note, other users with access to that team can see it and collaborate with you.

    • Moving a parent note will move all child notes nested under it.

    • Moving a personal note will change its URL from one with the designation PERSONAL, e.g. PERSONAL-N-150, to one with the designation of the team you are moving it to, e.g. FRED-N-110.

  • From the More options button, you can also choose to Hide nested notes. If hidden, any nested notes will not appear in parent note previews of note collections and standalone notes.

To move a team-level note to your personal notes, click the More options button, then click Move note. From there, click Move to personal notes.


Organize notes

Nested hierarchies

Create a wiki-like nested hierarchy by clicking and dragging notes in the left side panel of the notes page.

  • To re-order a note, click on it and drag it to your preferred order. If you drag a parent note, all nested child notes under it will come with it.
    Note: You can drag parent notes to new locations whether they are expanded or collapsed, but it might be easier visually to do this while they are collapsed.

  • To nest one note under another, click on it and drag it on top of another note.

  • To remove a note from a parent-child relationship, click on it and drag it to a new location.

When you drag a note to a new location, the blue bars in Aha! Develop will show you where it will land in the notes order.

  • A thin blue bar means your note will exist above or below another note in the order.

  • A thick blue bar means that your note will become a nested child note of another note in the order.


Note collections and standalone notes

As you build out the team and personal notes in your account, your notes hierarchy can become quite complex. Instead of scrolling through a hierarchy expanding every parent note, click on a parent note to see a preview of all its child notes.

  • Note collections — child notes with sub-notes of their own — display here as tiles. Each collection includes the first three lines of the note's description, the top three child notes, and a total note count.

  • Standalone notes — child notes without sub-notes of their own — are listed at the bottom.

You can control what notes appear in these views by clicking on a parent note, then clicking More options Hide nested notes.


Customized title icons

Every note you create has a title icon. By default, this is a page icon for standalone notes, and a folder icon for parent notes. You can change these title icons to emojis to help your notes and note collections stand out.

To do this, open a note and click its title icon. Click or search for any replacement emoji you prefer, and the title icon will update.


Additional functionality

Embed views

Notes are excellent tools for collaboration and documentation, so it often makes sense to add Aha! Develop views directly to a note — or to embed view extension contributions from extensions such as Figma, Invision and Adobe XD.

To do this, click the More + dropdown and select Add Aha! view. From there, choose to Use existing report to add an Aha! view or Add Develop extension panel to embed a view from an extension with view extension contributions.

  • When you add one an Aha! Develop view to a note, Aha! Develop copies the view and your note view displays the copy. This way, changes you make to the configuration of the original view — the view's type, style, or filters — will not affect the information displayed in your note. Changes you make to your Aha! Develop data will be reflected in either view.

  • Extension panels you add respect the permissions set in the external tool. This means, for example, that a publicly shared design will be visible to all users, while a privately shared design will require users to be logged into the service.

Once you have added your view, click and drag a corner to Resize it. Or click its More options button to Open the report it is based on, Configure the view you have added to your note, or Remove the view altogether. When you Configure the view, you can change the view's Title or — for chart views in accounts integrated with Aha! Roadmaps — choose to show the chart's Legend.


Inline comments

In addition to collaborative editing, notes in Aha! Develop support inline text comments. Use them to highlight the exact part of the note you want to discuss, then create conversation threads to focus on and resolve the issue.

To create a new inline comment, highlight the text you want to comment on and click the Add comment + icon that appears on the right side of the text editor. Your text will be highlighted and underlined in orange, the Comments sidebar will appear, and you can start creating your comment. Click Save comment once you are done.

Resolved comments will be highlighted and underlined in green and you can always reply to a resolved comment to reopen it.

Inline comments have access to the full text editor, so feel free to format your text, @ and #mention Aha! Develop users and records, add and color tables, or insert images.


Revert to previous versions

Every note created automatically tracks the history of edits that have taken place. You can revert back to previous versions of a note by clicking the History icon in the text editor and then moving the slider to the time frame you want to revert to.


Record and user mentions

Use #mentions to reference Aha! Develop records, or to reference your team-level note from any Aha! Develop text field.

Use @mentions to reference users in your Aha! Develop account. @mentioned users will be added as watchers to your note.


Move notes

Use the More options button on notes to move notes between teams. If you move the note at the top of a hierarchy tree, all child notes move as well.

Note: You can also move a team note to a personal note. Instead of choosing Move to team from the Move note menu, select Move to personal notes.


Reference Aha! Develop records

Team-level notes can be added as related records to other data objects in Aha! Develop. To add a related record to a note, click on the More options button in the upper-right of the note and select Link to another record. Once linked, a new Record links section will display at the bottom of the note. This will reference the related data records, which you can visualize to keep track of the relationships.


Share and export notes

With your note completed, share it with your team or external stakeholders by selecting one of the export options under the Share menu on the top right of the screen.

  • To share your note as a webpage, select Share as webpage.
    Note: Since personal notes are personal to you, you can only share team notes as webpages.

  • For a static version of your note, export it to PNG image or PDF document.


Aha! Ideas
Aha! Roadmaps
Aha! Develop