Jira Integration

Connect Vanillaround to Jira to sync approved requirement cards directly into your Jira project as issues. This eliminates the manual step of copying approved requirements into tickets and keeps both tools in sync.

How it works

When a requirement card is approved in Vanillaround, a Provider can sync it to Jira with a single action. Vanillaround creates a Jira issue in the configured project and stores the issue key (e.g. “PROJ-42”) on the card. The Jira issue key is displayed on the card and links directly to the issue in Jira.

Additionally, Vanillaround receives webhook updates from Jira — if the issue is updated or its status changes in Jira, that information is reflected back in Vanillaround.

Setup: Account-level connection

Before any project can use the Jira integration, the account must be connected to Atlassian.

1. Go to Account → Integrations
2. Click Connect Jira
3. You will be redirected to Atlassian to authorise Vanillaround
4. Log in with your Atlassian account and grant the requested permissions
5. You are redirected back to Vanillaround — the connection is confirmed

This step only needs to be done once per account, by the account owner.

Setup: Project-level connection

Once the account is connected, link individual projects to specific Jira projects.

1. Open the Vanillaround project
2. Go to Project → Settings → Integrations
3. Click Connect Jira Project
4. Select the Jira site and Jira project from the dropdown
5. Click Save

The project is now connected. Cards in this project can be synced to the selected Jira project.

Syncing a card to Jira

1. Open the spec page containing the card
2. The card must be in Approved state
3. Open the card’s Jira component
4. Click Create Jira Issue (or Link to Existing if an issue already exists)
5. A Jira issue is created and the issue key appears on the card

What is synced

When a card is synced, Vanillaround sends:

• The card title (becomes the Jira issue summary)
• The card description / spec content (becomes the issue description)
• The card type (mapped to Jira issue type where available)

The sync is one-directional at creation time — Vanillaround creates the issue. Subsequent management of the issue (assignees, sprints, comments) happens in Jira.

Linking to an existing Jira issue

If a Jira issue already exists for a requirement:

1. Open the card’s Jira component
2. Click Link to Existing Issue
3. Enter the Jira issue key (e.g. “PROJ-42”)
4. Click Link

The issue is associated with the card without creating a duplicate.

Webhook updates from Jira

Vanillaround registers a webhook with Jira when the integration is connected. When the Jira issue status changes or other relevant updates occur, Vanillaround receives the notification. This keeps the card and issue in sync over time.

Disconnecting

To disconnect the Jira integration at the project level, go to Project → Settings → Integrations and remove the connection. Existing card-to-issue links are preserved as references but will no longer receive updates.

To disconnect the account-level Atlassian connection, go to Account → Integrations and disconnect. This will also break any active project-level integrations.