On a PRO or Enterprise space you can easily raise requirements and stories from the diagram activities. You can also see the status of requirement and story implementation for each activity, as well as of all requirements and stories for the whole process diagram.

If you integrated with JIRA, stories linked to an activity will also display links to JIRA stories. And finally, you can easily toggle between viewing requested or worked on process changes, and viewing the history record of all implemented changes. 

Article outline

  • Adding requirements and stories from/to process activities
  • Viewing change requests on a diagram

Adding requirements & stories

You can add requirements & stories to a diagram activity by either right-clicking on the activity and selecting an option “Add change”, or by opening the right panel for an activity and choosing an option to “Add requirement” or “Add story” in the Changes tab. 

In both cases, you will have an option to either add one-to-many requirements/stories already existing in the system or to create a new one.  You can drag and drop the requirement/story modal window around the canvas to stop it from obscuring the view the underlying diagram.

You can also work multi-tab in a browser and paste a requirement or story link directly to an activity. The easiest way to do it would be to right-click on a target requirement or story in the change grid and select "Copy link".

You can also copy the link to a change item from the collapsable right panel. 

Viewing change requests on a diagram

The diagram application has 3 distinct modes: view mode; expanded view mode; and edit mode. You can see your change requests while in expanded view mode and in edit mode.

Edit mode / change requests on activity boxes

When you click on an activity in edit mode and open the right panel (unless it is already opened) you can see all change requests linked to that activity box in the "Changes' tab. 

In order to view details about the linked requirement or story simply roll over it in the right panel and you'll see a popover with the crucial info. Click on the name of the requirement/story at the top of the popover to navigate to the item in the change grid.

If you switch to “Closed” list you will see all the requirements & stories that have been raised on this activity box in the past & have been implemented. This is effectively your change history record. 


The closed list of requirements & stories is dependent on what statuses are marked as “closed” category status in your requirements/story workflows. These can be customized in Space Management.

Expanded view mode/ change requests on entire diagram

You can also view all change requests raised in the context of the entire diagram.

  • If you are in edit mode just click on the canvas (to unselect any activity box you might have clicked on already) and open the right panel for the diagram. If you had the right panel open for an activity box already it will automatically switch to diagram panel.
  • If you are in view mode make sure you are in expanded view mode which is available to all users who were individually invited to a diagram. Then open the right panel for the diagram.

The Changes tab on the diagram lists all requirements & stories raised in the scope of this diagram, i.e. all activities. As you roll over individual requirements or stories, the activities which are linked to that change request will start glowing. You will also see a small information box with the key insights about the change request.

You might also find these articles helpful:

Did this answer your question?