Linking stories

Sometimes, stories are related to each other. For example, a story may depend on another story, or there might be a similar story that contains useful information we want to remember. Scrum Mate offers a simple yet powerful method to link related stories together.

How story linking works?

You can add story links to the description field of a story card. When you add a link to another story, Scrum Mate will show a short snippet of the story title in the description. You can place the story link into the body of the description, so it’s easy to add a description of the relationship.

If you click on the story link, Scrum Mate will open the linked story card on the top of the referring story.

If the linked story is in the last column (completed) of a board, or it’s already delivered, you can see a green checkmark which indicates that the referred story is completed. For example, when a linked story blocks the referring story, it’s useful to know how many of the referred stories are already completed.

You can choose from three options to link a story.

  • Paste the URL of the story card you want to link
  • Add a story link using the story search input

Copying the URL of the story card

You can access and copy the URL of a story card via three different methods.

  • Copying the story card URL from the browser’s address bar or the ‘Copy story link to clipboard’ from the more menu of a story card.
  • Using the story smart summary copy.

Copying story link URL

Copying smart link

Scrum Mate offers a simple and smart method to copy a summary of a story card.

Move the mouse pointer over a story on the board or backlog and press CTRL/CMD+C key combination. Scrum Mate copies the story title, story ID and the URL of the story card to the clipboard.

You can paste the smart summary link into a commit message, send it via email or share it with any method you prefer. 

If you paste the smart story link into the description field of a story card, it will be pasted as a clickable story link.

Tip: you can open two browser tabs when adding story links. On one tab, you can keep the story card and the description, on another tab you can browse and copy story URLs of stories you want to link.

Adding a story link with story search

If you don’t want to leave the context of the story description, you can simply add a story linked using the story search feature.

Click on the [+ story link] command on the description editor’s toolbar and start typing the title or the ID of the story you want to add.

You can also use the SHIFT + CTRL / CMD + K key combination to add a story link via story search.

The story search feature searches for the story title and story ID in all projects across all organizations you can access.

The search result list will show up 15 stories that match the search text. You can narrow the results list by adding more text to the search criteria.