Contents:

Integrating your story map with a Jira project allows teams to plan more effectively, utilizing the visual power of story mapping to achieve transparency and shared understanding among stakeholders. Bring the team around to the story map to see the big picture and take advantage of real-time and bidirectional sync with Jira to keep everyone up to date at all time. The integration makes it possible to plan releases on the story map and push cards to Jira for execution and keep your backlog in sync.With the powerful integration between StoriesOnBoard and Jira you can build and manage amazing products from the very beginning. This allows to do product discovery with user centric approach to build great products that users love.

You must have Admin role on the story map on StoriesOnBoard to be able to setup the integration with Jira. On the Jira side you must hold Admin rights as well.

Navigate to your settings then select "Jira integration settings".

Proceed with the "Jira Server" option.

Enter your Jira instance URL then proceed the next step.

In the nest step you must configure the application link to take advantage of the integration.

For a two-way synchronization, you must set up an application link between Jira and StoriesOnBoard. An application link is a trusted relationship between StoriesOnBoard and JIRA. You will need a user with an Administrator role in Jira for this setup.

In order to finalize the integration with Jira server you must have an active application link configured. There are two options:

To create a new application link select the "New app link" option.

In the nest step you need to open the Jira Application settings. You will need to copy the StoriesOnBoard URL.
​

Once you opened the Application settings in Jira, select the "Create link" option.

Now you need to paste the copied StoriesOnBoard URL to the Application URL field and click on "Continue".

If a popup window “Configure Application URL” appears with the error message “No response was received from the URL…”, then just click Continue (it’s normal).

Go back to StoriesOnBoard and proceed the next phase as following.

In the nest step, you need to copy the Application name from StoriesOnBoard as below.

In Jira paste the copied Application name into the "Application Name" field and make sure you enabled the "Create incoming link" option as well. Then select "Continue".

Now your new Application link will appear in the list and select the three dots menu and choose "Edit".

Then go back to StoriesOnBoard and select "Continue" to proceed the next step.

You will need to copy the "Consumer Key and Consumer Name" value which is "StoriesOnBoard". You will also need to copy the Public Key as well.

Paste into Jira the copied "Consumer Key and Consumer Name" value which is "StoriesOnBoard".

Then select the "Incoming Authentication" tab and paste the copied Public Key from StoriesOnBoard into the Public Key field and save your settings.
​

Go back to StoriesOnBoard and click on "Continue".
​

In the next step, you have two options for setting up a webhook:

If you wish to setup your webhook manually, keep follow our guide below.

You will need to create a webhook and follow the instructions on your screen as below:

You will see the following screen where you will find the instructions.

To setup the webhook manually, open Jira's Webhook management here.

Proceed with the "Create a webhook" option.

Copy the [ Name ] and [ URL ] from StoriesOnBoard and paste it into the relevant webhook fields in Jira.

Then scroll down to find the "Issue related events" section and enable the following fields:

Then scroll further down to find the "Project related events" section and enable the following fields:

To complete the webhook configuration select "Create" at the bottom of the screen.

If the webhook is successfully created in Jira, select the "Enable integration" option.

You will land on the following screen:

Now you are ready to move forward to create your story map and connect it to your selected Jira project by following these steps on the story map:

💡 Tip - Setting up Jira integration for your story map

Learn more about: