User story maps

Story maps help your team visualize and plan work according to the journey that individuals take as they buy and use your products.

Product and marketing teams use story maps in different ways:

  • Product teams create story maps to structure and prioritize work around the path (the steps) that a user will complete while using your product.
  • Marketing teams create story maps to visualize a buyer’s journey and plan work around each step in the decision to purchase your product.

The steps on a story map start on the left and move to the right as you add steps. Once you have added the steps in your journey, you can add any work that is necessary to improve the experience at each step. Once you have defined the work, you can organize and prioritize the work within each step.

User story maps are enabled by default in all product and marketing workspaces. If you customized your navigation, you will need to enable user story maps at Settings > Product (or Workspace) > Navigation. You must have owner or contributor permissions to create and edit user story maps.

Create a user story map 


To create a user story map:

  1. Navigate to Features > User story map (or Activities > User story map).
  2. Click the Add user story map button to create a new map.
  3. Give the user story map a name by clicking on the title. This will open the map’s drawer where you can edit the title.

Customize a user story map

Once you have created your story map, you can start adding the steps and records that represent the technical and/or non-technical work that must be completed to improve the experience at each step. 

To add new records to a user story map:

  • Add steps to your user story map by hovering over the first horizontal swimlane at the top of the screen. Click the + Add step button that appears. Begin typing to name the step.
  • Add master features (or master activities) by hovering over the second horizontal swimlane and clicking + Add master feature (or + Add master activity). Note: When you add a master feature (or master activity) to a user story map, the Master features (or Master activities) setting will be automatically enabled for your product or marketing workspace.
  • Add features (or activities) by hovering over the grey work area located on the lower half of the page and select the Add feature (or Add activity) button. Begin typing to name the new record. Any features (or activities) that are dragged into a column beneath a master feature (or master activity) will be assigned to the master feature. If you move a feature out of the column beneath a master feature, it will be disassociated from the master feature.
  • Releases (or schedules) can be added by hovering on the space between features (or activities) and then clicking on the Add release button.  


Note: Newly created features (or activities) are assigned to the release (or schedule) shown on the story map. When you first create a story map where there are no releases (or schedules) yet, features will be automatically assigned to the left-most parking lot on the features board (or activities board) for the product or marketing workspace where the story map resides.

To add, update, or remove existing records from a user story map:

  • Use the Add existing records right sidebar to select the existing records that you would like to add. You can choose from records that exist in the product or marketing workspace where the user story map resides. Tip: Select a parking lot release to organize features that are not yet ready to be prioritized into a release (or schedule). Parking lots will appear at the bottom of the map.
  • For master features, master activities, features or activities, click a record's ID number to open the detail drawer for that record. 
  • There are two ways to remove records from the map:
    • Choose the More options button that appears in the top-right corner of each record on the map. Then select the Remove from map option.
    • From the Add existing records sidebar, deselect a record to remove it from the map.

Note: Removing a record from the map does not delete the record. To delete a record, click the More details button on the record, then choose Edit. You can delete the record from the More details button in the record details drawer. If you remove a release (or schedule) from a user story map and would like to add it back, you need to re-add the features (or activities).

Record links

When you create a new record or add an existing record to a user story map, Aha! will automatically establish a link between the record and the user story map. You can view these links in the Record links section of the record details. Any records linked to user story maps will be labeled in this format: Is contained by + [User story map name]. 

Working with user story maps

The View all user story maps collapsible sidebar on the left side of the screen is used to manage the user story maps that you have created within your product or marketing workspace.  

To change the colors of the cards that appear on a story map, click the settings button Aha-settings.png to color the cards by Status or Type.  

  • Status: The cards will appear in the colors that are set at Account > Configure statuses and workflows and assigned to your product or marketing workspace.
  • Type: A set of default colors will be used on the map for each record type. 

To add/remove a new column or row to the story map: 

  • To modify columns, hover over the top of the column and click the More details button Aha-more-details.png. From there, you can choose from Insert column left, Insert column right, or Delete column. Only empty columns can be deleted.
  • To add a new row or column, drag a record into the space between records and hold until a blue line appears. Drop the record onto the line to create a new row or column.
  • To remove a row, remove everything from the row and make the empty row the bottom-most row in your work area. Note: A blank row will always appear at the bottom of a release (or schedule) — the reason for this is to help you quickly add more features (or activities).


To move a group of features that are associated with a master feature, drag the master feature to a new column and all of the associated features will move as a group. 

To delete a user story map, select the More details button in the upper-right corner of the page and choose Delete map. This will not delete the records that are contained within the map — only the map itself.

Share your user story map

Use the More options button in the top-right corner of the page to export your user story map as an image or PDF. You can also add and share your user story map as an Aha! presentation using the Add to presentation option.

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