All Collections
Getting Started
How do I connect Velocity to Jira?
How do I connect Velocity to Jira?
Dave Henton avatar
Written by Dave Henton
Updated over a week ago

To sync your project management tools with Velocity, you'll need to first connect your Jira instance followed by adding the Jira Projects you wish Velocity to report on.

Velocity supports Jira Cloud, Jira Server, and Jira Data Center. For Jira Cloud setup, follow the steps below. For Jira Server or Data Center, go to this link.

Step 1: Connect your Jira instance to Velocity

  • In Jira, create a Personal Access Token (PAT), which you'll use in the following steps. Note: the Jira user creating the PAT should have Admin permissions. For more info, check out our docs on Jira Permissions.

  • Next, fill in the required fields.

    • JIRA Version: Jira Cloud

    • Hostname (i.e. your domain name)

    • Personal Access Token (PAT)

    • Email address associated with Personal Access Token

    • Click Create project management tool

  • Once complete, click the button to Create project management tool.

Step 2: Add your Projects to Velocity

Add Projects:

Once you’ve added your Jira instance to Velocity, navigate to Projects page in Settings.

  1. Select Add Project

  2. Select the project(s) you want to be added to Velocity and then click add projects or use the “add all projects” button to add everything

Note: If you can’t find a project or projects aren’t showing up yet, use the Sync Projects button to update the list of available projects.

Project Status

Added projects will show on the Projects page with status information. Newly added projects take about 5 minutes to sync and will show up as “syncing” in the project list. Once the project is sync’d, the status will show as “connected.”

Project Syncs

Projects will sync periodically (about every 15 minutes) ensuring that data in Jira stays up to date with Velocity.


What if my projects show up as errored?

Not seeing your projects?

The Personal Access Token used to connect Velocity to your Project Management Tool needs to have, at minimum, the Browse Projects permission.

Did this answer your question?