Get Started

  1. Open any Jira project, navigate to Project Pages, and select the Vercel DevOps for Jira app:

Selecting the Vercel DevOps for Jira app in the Jira project pages

  1. When opening the app for the first time, you will see an empty state:

Initial empty state of the Vercel DevOps for Jira app

  1. Provide a Vercel API token to allow the app to access your Vercel projects:

API token input field prompting for a Vercel token

Learn how to create an API token for Vercel.

  1. After saving the token, select the Vercel projects you’d like to connect to this Jira project:

Selecting Vercel projects to connect with the Jira project

  1. Click “Connect” to link the selected projects:

Connecting selected Vercel projects

After a successful connection, you’ll see a confirmation:

Successfully connected Vercel projects

  1. The overview page now shows all connected Vercel projects for this Jira project:

Overview page showing connected Vercel projects

  1. To track deployments on issues, include a Jira issue key in your commit message (e.g. feat: setup basic website structure TEST-2):

Git commit message containing a Jira issue key

  1. Once a deployment completes, the deployment information appears directly on the Jira issue:

Deployment information displayed in the Jira issue panel

You can view the latest deployments associated with the issue:

Latest deployments linked to the Jira issue