Skip to main content
The Jira connector indexes issues, comments, and project metadata from your Atlassian Jira instance.

​
What gets indexed

  • Issues (all types including epics, stories, bugs, tasks)
  • Issue descriptions and comments
  • Custom fields
  • Project metadata
  • Sprint information
Requires Atlassian Jira Cloud. Data Center/Server versions are not currently supported.

​
Setup

1

Connect to Grapevine

  1. In Grapevine, go to Integrations and click on Jira
  2. Enter your Jira site URL (e.g., https://acme.atlassian.net)
  3. Click Save
2

Install Forge app

  1. Click Install Jira App
  2. You’ll be redirected to the Atlassian Marketplace
  3. Click Get it now to install the Grapevine app
  4. Approve the installation for your Jira site
3

Configure signing secret

  1. Return to the Grapevine integration page
  2. Copy the signing secret displayed
  3. In Jira, go to Settings → Manage apps → Grapevine
  4. Paste the signing secret into the app configuration
  5. Click Save
4

Indexing begins

Grapevine will automatically begin indexing your Jira issues. The initial sync may take time depending on the number of issues in your instance.

​
Permissions

The Jira connector respects Jira permissions:
  • Only issues the Forge app can access are indexed
  • Project-level permissions are preserved
  • Restricted issues are handled according to Jira access controls

​
Sync behavior

The initial indexing processes issues by project. Real-time updates are configured automatically via the Forge app.
  • Initial sync - Begins automatically after installation
  • Ongoing syncs - Real-time updates via Forge app webhooks keep your index current
  • Deletions - Deleted issues are removed from the index automatically

​
Limitations

  • Only Jira Cloud is supported (not Data Center or Server)
  • Archived projects are not indexed
  • Some custom field types may have limited support