Skip to main content

Whether you’re looking for quick answers or in-depth guidance, our resources are here to assist you effectively.

Jira Connector

SiftHub's Jira Connector integrates your Jira workspace content into SiftHub, allowing you to search and get AI-generated answers from your Jira projects, issues, comments, and attachments directly through the SiftHub Platform.

Jump to setup

 

What Gets Connected

SiftHub lets you selectively connect:

  • Specific projects
  • All issues within connected projects, including:
    • Issue descriptions
    • Comments
    • Attachments
  • Project and issue metadata (creation date, last modified date, issue type, status, assignees)

This way, SiftHub only reads and indexes the content from projects you explicitly allow it to access.

Learn how to connect specific Jira projects to SiftHub.

 

Supported Content

Projects and Issues

  • Complete project information
  • Issue titles and descriptions
  • Issue metadata (type, status, priority, assignees, dates)
  • All comments and replies within issues

Attachments

Supported file formats:

  • Word documents (.doc, .docx)
  • PowerPoint presentations (.ppt, .pptx)
  • Excel spreadsheets (.xls, .xlsx)
  • PDF files (.pdf)
  • CSV files (.csv)
  • Text files (.txt)

Note: Attachments up to 1 GB in size will be indexed.

 

How It Works

Once connected, SiftHub:

  • Indexes content from selected projects
  • Syncs content updates every day to capture any changes
  • Maintains all native Jira permissions
  • Makes the content searchable and available for AI-generated answers

 

Access Control

SiftHub strictly respects Jira's native permissions:

  • Users only see content from projects they have direct access to
  • Access automatically updates when permissions change in Jira
  • Different users may see different search results based on their access rights
  • Deleted/archived/suspended users automatically lose access

Note: For restricted projects, the SiftHub app needs to be added as a user to enable indexing.

 

Using Jira Content in SiftHub

Your connected Jira content appears in:

  • Search results with relevant snippets and metadata
  • AI-generated Answers and document Autofill as verified sources
  • Conversations and Narratives with SiftMate

Comments appear as individual items linked to their parent issue and project, similar to how Slack messages are displayed.

Clicking any result opens the original issue or comment in Jira.

 

Content Updates

New or modified content appears in SiftHub within 24 hours

Updates include:

  • New issues and comments
  • Issue modifications
  • Attachment updates
  • Permission changes
  • Deletions

Deleted content is automatically removed from SiftHub results.

 

Jira Connector Setup

Time to complete: 2 mins (plus activation time)

Required Permissions: Ensure you have the following access and permissions before you begin the setup, or contact your administrator for the same.

  • Jira Organization Administrator access: To install the SiftHub App
  • SiftHub Admin or Account Owner role: To initiate the connection request from the SiftHub Web App > Connectors > Apps page

Main steps:

Step 1: Installing the SiftHub app for Jira
Step 2: Requesting activation for specific Projects

Additional Handling of Restricted Projects:
Projects with restricted access will require additional configuration steps for SiftHub to be able to read them.

 

Step 1: Install the SiftHub App for Jira

  1. Login to your Atlassian account as an administrator - https://id.atlassian.com/login
  2. Under Apps, click on Jira
  3. In the Jira homepage, Click on Apps → Manage Apps
  4. Scroll to the bottom of the page and click Settings
  5. Select Enable development mode and click Apply
  6. Reload the page
  7. Click on Upload app
  8. Copy and paste the following app descriptor URL:
    https://app.sifthub.io/api/v1/atlassian/connect
  9. Click Upload
  10. Click Close on the confirmation modal for successful app installation

 

Step 2: Requesting Activation for Specific Projects

SiftHub provides you the flexibility of selecting which projects in Jira you want to connect to SiftHub. Once the app installation is complete, you can request activation through the SiftHub platform.

  1. Login to the SiftHub web app
  2. Go to the Connectors → Apps page
  3. Find the Jira connector and click Connect
  4. In the modal that opens, provide your SiftHub Customer Success Manager with:
    • Project URLs you want to connect
    • Project Keys/IDs for those projects
    • Any additional requirements or filters (optional message)
  5. Click Send request

Examples of Project URLs:

  • https://yourcompany.atlassian.net/jira/software/projects/PROJ/boards/1
  • https://yourcompany.atlassian.net/browse/PROJ-123

Example Project Keys:

  • PROJ
  • SALES
  • ENG

Once shared, the Jira Connector will be active within 24-48 hours. Your Customer Success Manager will confirm when the connection is live.

 

Important Notes:

  • All issues within a connected project will be automatically indexed
  • The above applies for unrestricted (or open to all) projects. If a project has restricted access, it will require additional configuration steps mentioned below
  • To add or remove projects after initial setup, contact your SiftHub Customer Success Manager

 

Handling Restricted Projects

If a project has restricted access, the SiftHub app will have to be added as a user to that project before it can be connected.

To add SiftHub to a restricted project:

  1. Navigate to your project in Jira
  2. Click on Project Settings (gear icon)
  3. Click on People or Permissions
  4. Search for SiftHub
  5. Add the SiftHub app with View or Browse permissions
  6. Click Save or Apply

Once the app is added as a user, share the project URL and key with your SiftHub Customer Success Manager for activation.

 

If you are experiencing issues with the connector or its setup, contact your SiftHub Customer Success Manager or reach out to support@sifthub.io.