{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["availability","partial","callout","img","faq","faq-item"]},"type":"markdown","userRole":"Users, Editors, and Admins","accountType":"All accounts","plan":"One or more features exclusive to select subscription plans or add-ons"},"seo":{"title":"Integrate Jira with Databox","description":"Connect Jira to Databox to track issue progress, monitor sprint performance, and gain actionable insights to improve team productivity and project delivery.","siteUrl":"https://help.databox.com","llmstxt":{"title":"Databox Knowledge Base","description":"Databox is a business analytics platform that consolidates data in one place, enabling real-time performance tracking and insights by mixing and matching data from various sources for a comprehensive view.","details":{"content":"This knowledge base covers everything from account setup and integrations to building Databoards, creating custom metrics, and using AI-powered features."},"sections":[{"title":"General","includeFiles":["docs/general/*.md","docs/general/visualization-types/*.md","docs/general/templates/*.md"],"excludeFiles":[]},{"title":"AI","includeFiles":["docs/ai/*.md"],"excludeFiles":[]},{"title":"Account Management","includeFiles":["docs/account-management/**/*.md"],"excludeFiles":[]},{"title":"Databoards","includeFiles":["docs/databoards/**/*.md"],"excludeFiles":[]},{"title":"Data Management","includeFiles":["docs/data-management/**/*.md"],"excludeFiles":[]},{"title":"Metrics","includeFiles":["docs/metrics/**/*.md"],"excludeFiles":[]},{"title":"Forecasts","includeFiles":["docs/forecasts/*.md"],"excludeFiles":[]},{"title":"Goals","includeFiles":["docs/goals/*.md"],"excludeFiles":[]},{"title":"Reports","includeFiles":["docs/reports/*.md"],"excludeFiles":[]},{"title":"Notifications","includeFiles":["docs/notifications/*.md"],"excludeFiles":[]},{"title":"Pricing and Billing","includeFiles":["docs/pricing-and-billing/*.md"],"excludeFiles":[]},{"title":"Mobile","includeFiles":["docs/mobile/*.md"],"excludeFiles":[]},{"title":"Support","includeFiles":["docs/support/*.md"],"excludeFiles":[]},{"title":"Integrations","includeFiles":["docs/integrations/**/*.md"],"excludeFiles":[]}],"hide":false,"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"integrate-jira-with-databox","__idx":0},"children":["Integrate Jira with Databox"]},{"$$mdtype":"Tag","name":"Availability","attributes":{"users":"users","accounts":"all","plans":"partial"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Jira is a widely used project management and issue tracking platform designed to help teams plan, track, and manage work efficiently. It allows users to create and organize tasks, monitor project progress, manage backlogs and sprints, and collaborate across teams. With customizable workflows, detailed reporting, and support for agile methodologies, Jira provides visibility into team performance and project status, making it a central tool for software development and business operations."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connection","__idx":1},"children":["Connection"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"before-you-begin","__idx":2},"children":["Before you begin"]},{"$$mdtype":"Tag","name":"IntegrationPermissions","attributes":{"integrationKey":"jira"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Callout","attributes":{"type":"note"},"children":["This integration is compatible with ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Jira Cloud"]},". Jira Server and Data Center versions are not currently supported."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-1-create-an-api-token-in-your-atlassian-account","__idx":3},"children":["Step 1: Create an API token in your Atlassian account"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Databox uses an API token to securely authenticate your Jira connection."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Follow ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account"},"children":["Atlassian's official guide"]}," to create an API token."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After generating the token, ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["copy and store it securely"]},". You will need to paste it into Databox in the next step."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-2-add-your-jira-details-in-databox","__idx":4},"children":["Step 2: Add your Jira details in Databox"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In Databox, ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["enter your Jira Domain"]},". Your domain should look like ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://your-instance.atlassian.net/"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enter the email"]}," you use to log in to Jira."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Paste the API Token"]}," you created in Step 1."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connect"]},"."]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/integrate-jira-with-databox_1.2176d66314b8b70188a02cdc95389eab625b99233bdafcb1a5a7a07a8af530ea.4783b0ec.png","alt":"connection","withLightbox":true,"className":"ss-img"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"metric-builder","__idx":5},"children":["Metric Builder"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Jira integration allows you to create custom metrics using the metric builder, ideal for visualizing data not included in the basic metrics offered by the integration."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/integrate-jira-with-databox_2.5a00815ec0f4de77c6a06612a57064b0af96c55bb3228d72fd90e8e86743d4dc.4783b0ec.png","alt":"connection","withLightbox":true,"className":"ss-img","style":"margin: 10px 0;"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To create a custom metric, start by selecting a metric from the \"Metric\" selector. Next, customize your metric by optionally adding a dimension and applying one or more filters. The available options depend on the selected entity and data type (e.g., number, text, etc.)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The available selector values are pulled directly from your Jira instance to mirror what you can use in JQL. When you open the builder, Databox requests Jira's JQL autocomplete metadata to list the fields that can be used for building and filtering metrics, including Jira system fields and any visible custom fields, along with their supported types. For dimensions and date fields, Databox retrieves your Jira field catalog and then surfaces the fields that can be used to group results or define time-based reporting. When you add a filter and start selecting values, Databox calls Jira's suggestions endpoint to return valid values for the chosen field, so filter pickers show relevant options based on Jira's own JQL suggestions."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"datasets","__idx":6},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/lock.2fb1bbc208afcc03d15a0a45f22bdf7f830322016e038e5721965851130807af.419bb737.svg","alt":"lock"},"children":[]}," Datasets"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ","Jira"," integration supports the creation of ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/understanding-datasets"},"children":["datasets"]},", which allow you to structure and format your ","Jira"," data for more flexible reporting in Databox. By organizing your data into a tabular format, datasets make it easier to filter, segment, and visualize key metrics across projects, clients, and team members."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The entity relationship diagram (ERD) below illustrates how data is organized within the ","Jira"," integration, displaying the available ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["views"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["columns"]},", as well as the relationships between them (primary and foreign keys). This diagram represents the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["schema"]},", or structure, of the data and helps you understand the underlying data model. With this context, you can create datasets using the relevant views and columns to build custom metrics tailored to your reporting needs."]},{"$$mdtype":"Tag","name":"SchemaExplorer","attributes":{"integrationKey":"Jira"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"resources","__idx":7},"children":["Resources"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For comprehensive details on metrics, data availability, templates, specifications, usage guidelines, and other key information, refer to the resources listed below."]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":4,"cardMinWidth":240},"children":[{"$$mdtype":"Tag","name":"IntegrationResources","attributes":{"integrationKey":"jira"},"children":[]}]},{"$$mdtype":"Tag","name":"Faq","attributes":{},"children":[{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"Why are certain entities or properties unavailable in the metric builder?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The metric builder pulls raw and analytics data from Jira's APIs. If an entity or property is missing, it is likely due to limited API support or technical implementation restrictions. If there's something you'd like to see included, feel free to ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://databox.com/roadmap-request"},"children":["submit a request"]},", so we can consider it for future updates to the integration."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[" "]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":4,"cardMinWidth":160},"children":[{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Ask Genie","icon":"genie","to":"https://app.databox.com/genie","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Get instant answers or help with your data using the in-app AI assistant."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Talk to an expert","icon":"assistance","to":"https://meetings.hubspot.com/databox-meeting/account-management","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For customers: Get help with your setup, strategy, or making the most of Databox."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Book a demo","icon":"eye-open","to":"https://meetings.hubspot.com/databox-meeting/ref-knowledge-base","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["New to Databox? See how it works and get guidance on getting started."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Send an email","icon":"help","to":"mailto:help@databox.com","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Reach out to support for help with your account, data, or technical issues."]}]}]}]},"headings":[{"value":"Integrate Jira with Databox","id":"integrate-jira-with-databox","depth":1},{"value":"Connection","id":"connection","depth":2},{"value":"Before you begin","id":"before-you-begin","depth":3},{"value":"Step 1: Create an API token in your Atlassian account","id":"step-1-create-an-api-token-in-your-atlassian-account","depth":3},{"value":"Step 2: Add your Jira details in Databox","id":"step-2-add-your-jira-details-in-databox","depth":3},{"value":"Metric Builder","id":"metric-builder","depth":2},{"value":"Datasets","id":"datasets","depth":2},{"value":"Resources","id":"resources","depth":2}],"frontmatter":{"slug":"integrate-jira-with-databox","seo":{"title":"Integrate Jira with Databox","description":"Connect Jira to Databox to track issue progress, monitor sprint performance, and gain actionable insights to improve team productivity and project delivery."},"keywords":{"includes":["jira","connect jira","jira integration","jira data source","jira API token","atlassian","jira not working","jira metric builder","jira custom metrics","jira JQL","jira sprint","jira issues","jira project tracking","jira cloud"]},"metadata":{"userRole":"Users, Editors, and Admins","accountType":"All accounts","plan":"One or more features exclusive to select subscription plans or add-ons"}},"lastModified":"2026-05-29T09:01:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/integrate-jira-with-databox","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}