# LinearB Best Practices for Integrating Jira | LinearB Blog

> Integrating Jira with LinearB presents an opportunity for software development teams to streamline project delivery and enhance productivity.

_This is a markdown rendering of a live HTML page on linearb.io, generated for AI/LLM consumption — it is not a markdown-only site. To get the full HTML page instead, request this URL with an explicit `Accept: text/html` header (no wildcard, no markdown preference)._


```json
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Home",
      "item": "https://linearb.io/"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Blog",
      "item": "https://linearb.io/blog"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "LinearB Best Practices for Integrating Jira",
      "item": "https://linearb.io/blog/jira-best-practices"
    }
  ]
}
```

[Home](https://linearb.io/)

/

[Blog](https://linearb.io/blog)

/

LinearB Best Practices for Integrating Jira

# LinearB Best Practices for Integrating Jira

![Photo of Necco Ceresani](https://assets.linearb.io/image/upload/c_limit,w_2560/f_auto/q_auto/v1/Necco_Ceresani_debfc5efc3?_a=BAVMn6ID0)

By [Necco Ceresani](https://linearb.io/blog/jira-best-practices#necco-ceresani)

|

March 12, 2024

![Group_6854_1_40c6892a6e](https://assets.linearb.io/image/upload/c_limit,w_2560/f_auto/q_auto/v1/Group_6854_1_40c6892a6e?_a=BAVMn6ID0)

Integrating Jira with LinearB presents an opportunity for software development teams to streamline project delivery and enhance productivity. This document outlines essential best practices for optimizing this integration, covering key aspects of project organization, issue tracking, resource allocation, and incident management. 

By leveraging LinearB's advanced analytics and automation capabilities alongside Jira's project management features, teams can gain deeper insights into their development processes and make informed decisions that drive project success.

![Group 6854 (1).png](https://assets.linearb.io/image/upload/v1720000000/Group_6854_1_40c6892a6e.png)

## **LinearB Best Practices**

As an out-of-the-box tool, LinearB is highly flexible. Most organizations do not need to change their Jira configuration or existing workflows in order to gain the efficiency and productivity benefits the LinearB platform offers. That said, we’ve worked with teams across the world to build a list of Jira best practices that will make your experience using LinearB easier than ever before. 

### **1\. Project Organization in LinearB:**

Utilizing LinearB projects based on Jira boards is essential for effectively managing software development efforts. Projects in LinearB are based on Jira boards. You can add more than one Jira board to a project, and you can add additional filtering to get only part of the issues from the boards, such as Label, Epic, Fix version, or custom fields.  
  
Pro Tip: Scrum Projects: If you want to track the work of a team or project and see its accuracy over time, it is essential to have the sprints aligned across the boards you used for the projects’ configuration.

#### **Project Investment Profile**

Defining clear issue types in Jira is crucial for accurately categorizing and tracking work items. To ensure LinearB’s project investment profile accurately represents your team’s work, make sure issue types represent all types of work you have and want to track:

* User story \- smallest work needs to be done to present a change in the product.
* Task/Non-functional story \- Work needs to be done. Usually, it is non-functional work such as refactor or infrastructure work.
* Bug \- Issue with the product that require a fix
* If you have different types of work you want to track, you can create separate Standardissue types (for example, Automation tasks, Security tasks, Tests, Infra changes)

#### **Project People Effort**

Accurate people effort data within LinearB is highly dependent on ensuring all issues are assigned. To ensure a high level of data integrity in your Jira instance, we recommend using the following methods: 

* Field configuration - configure the field as mandatory, which will make it required while creating a new issue
* Workflows - during specific transitions (transition to “In progress,” for example), create a validation rule called “Field Required Validator.”
* Component lead can also be set as a default assignee if you are using Jira’s Component field.
* Automation rule - You can create automation to set a default assignee based on a different field (such as Team).

### **2\. Resource Allocation and Investment Profile**

Efficient resource allocation is vital for maximizing productivity and achieving project goals. Leveraging LinearB's resource allocation and investment profile features provides valuable insights into where your team's resources are being invested and where you need to prioritize effort. 

By associating work items with specific issue types, labels, components, or custom fields, you can accurately track resource utilization across different types of tasks. 

One way is to have issue types that represent the actual work (as explained in the PDT section):

* User story \- the smallest work needs to be done to present a change in the product.
* Task/Non-functional story \- Work that needs to be done. Usually, it is non-functional work such as refactor or infrastructure work.
* Bug \- Issue with the product that requires a fix
* If you have different types of work you want to track, you can create separate Standardissue types (for example, Automation tasks, Security tasks, Test, Infra changes)

In addition to issue types, you can have labels, use components, or add custom fields to specify the work being done. For example, add a custom field to represent the roadmap category, revenue driver, and investment type. 

* Anything that can be a closed list (select list - single option) can help you get the exact information you need to invest the resources the way you intended.

### **3\. Custom Project Management Metrics** 

In LinearB, you can create custom dashboards to track specific metrics relevant to your team's goals. Consider metrics such as Defect Escape Bugs, Closing Rate of Stories, or Cycle Time. These metrics provide valuable insights into your team's efficiency, quality of work, and overall productivity. By regularly monitoring custom PM metrics, you can make data-driven decisions to optimize your team's performance.

The following metrics can be configured in any custom dashboard: 

**Metric Type**

Display counts of issues, or the sum of story points assigned to issues.

**Scope**

Filter which issues this widget displays. Widgets can pull issues for Jira boards, epics, labels, fields, LinearB teams, or combinations. Note that these filters build on each other, meaning if a board and label are selected, LinearB will only display issues in a board that contains the label.

**Issue Type**

This data is pulled from your Jira instance and can be any issue type built into your instance. Multiple issue types can be selected.

**Jira State**

* **Single Jira State**

Collects all issues that were in the selected Jira state at any point in the designated time frame.

Example: Any issue that was set to "in QA" at any time in the day, week, or month displayed.

* **Transition between 2 states**

Collects all issues which transitioned from one state to the second.

Example: All issues which moved from "in progress" to "In review".

### **Custom Metrics FAQs**

* **I see a difference between daily and weekly numbers**.

It's very possible that an issue enters a specific state or transitions between two states multiple times in its lifetime. For example, an issue goes between "in progress" and "in review" states two times as a team QAs a ticket. When viewing a monthly breakdown of issues "in progress," this issue will be counted once, as it was in this state during that month. However, if you change a report to view a daily breakdown, this issue will be included in counts on each calendar day the issue was in the "in progress" state.

* **What timezone are these reports using?**

Days are measured using the UTC timezone.

* **I should have more issues in my done issues widget.**

The Done filter in these widgets will only count issues that transition to done (and remain in done) on that particular day. If an issue is removed from the done state, it will not be counted.

## **General Jira Best Practices for Software Development Teams**

By following these best practices, your software development team can maximize the benefits of using Jira for project management and collaboration.

**Clear Project Organization:** Structure Jira projects logically, considering team responsibilities, project scope, and workflow requirements. Use categories like Epics, Stories, Tasks, and Sub-tasks to break down work efficiently.

**Customized Workflows:** Customize Jira workflows to reflect your team's development process accurately. Ensure workflows are intuitive, streamlined, and aligned with Agile or other methodologies your team follows.

**Consistent Issue Tracking:** Enforce consistent use of issue types, priorities, and fields across projects. Standardize naming conventions and ensure all team members understand how to categorize and track issues effectively.

**Effective Sprint Planning:** Utilize Jira boards and Agile features to plan and manage sprints effectively. Use features like backlog grooming, story point estimation, and sprint retrospectives to improve sprint outcomes.

**Collaborative Documentation:** Encourage collaboration by using Jira for documentation, including requirements, user stories, design specifications, and technical documentation. Link documentation to relevant issues for easy reference.

**Transparent Communication:** Use Jira comments, mentions, and notifications to facilitate transparent communication among team members. Keep discussions focused and ensure everyone is aware of updates and changes.

**Version Control Integration:** Integrate Jira with your version control system (e.g., Git) to track code changes and link commits to relevant issues. This improves traceability and facilitates code reviews and debugging.

**Automated Testing Integration:** Integrate Jira with your automated testing tools (e.g., Jenkins, Selenium) to automate testing workflows and link test results to corresponding issues. This ensures efficient testing and faster issue resolution.

**Regular Maintenance and Cleanup:** Regularly review and clean up old or outdated issues, workflows, and configurations. This prevents clutter and ensures Jira remains efficient and relevant to your team's current needs.

**Continuous Improvement:** Foster a culture of continuous improvement by regularly soliciting feedback from team members on Jira usage. Identify areas for improvement and implement changes to optimize your team's workflow and productivity.

Implementing these best practices can streamline Jira usage, improve development processes, and enhance engineering operations. By adding structure, consistency, and classification to Jira instances, teams can achieve better results in their software development endeavors. 

## Improve developer productivity with LinearB

Find us on

[](https://www.linkedin.com/company/linearb)
[](https://devinterrupted.substack.com/)

![Necco_Ceresani_debfc5efc3](https://assets.linearb.io/image/upload/c_limit,w_2560/f_auto/q_auto/v1/Necco_Ceresani_debfc5efc3?_a=BAVMn6ID0)

## Necco Ceresani

Necco Ceresani is a product leader at LinearB with a background in CI/CD and workflow orchestration. With a passion for storytelling, Necco enjoys exploring the human experiences behind technical tools and processes. “In a world full of AI, we need the context of real-life more now, than ever before.”

### Connect with

[](https://www.linkedin.com/in/necco-ceresani-49a8a685)

## Your next read

[![Cover image for AI ROI comes from measuring engineering outcomes on day one](https://assets.linearb.io/image/upload/c_limit,w_2560/f_auto/q_auto/v1/Blog_AI_ROI_comes_from_measuring_engineering_software_security_2400x1256_2c5eae0862?_a=BAVMn6ID0)](https://linearb.io/blog/kraken-nik-sudan-measure-ai-roi-engineering-outcomes)

Product

[AI ROI comes from measuring engineering outcomes on day one](https://linearb.io/blog/kraken-nik-sudan-measure-ai-roi-engineering-outcomes)

Kraken Engineering Operations Lead Nik Sudan details how to establish day-one data infrastructure to accurately measure AI ROI. Discover why raw token adoption...

[![Cover image for Best Appfire Flow alternatives in 2026](https://assets.linearb.io/image/upload/c_limit,w_2560/f_auto/q_auto/v1/Blog_Moving_beyond_flow_88c071e703?_a=BAVMn6ID0)](https://linearb.io/blog/flow-alternatives-2026)

Product

[Best Appfire Flow alternatives in 2026](https://linearb.io/blog/flow-alternatives-2026)

Flow provides DORA metrics, workflow diagnostics, and useful dashboards for engineering leadership. But it has real limitations, and the market has moved...

[![Cover image for 8 million pull requests reveal where engineering productivity breaks down](https://assets.linearb.io/image/upload/c_limit,w_2560/f_auto/q_auto/v1/Blog_8_million_pull_requests_2400x1256_03724bfbb2?_a=BAVMn6ID0)](https://linearb.io/blog/8-million-prs-engineering-productivity)

Product

[8 million pull requests reveal where engineering productivity breaks down](https://linearb.io/blog/8-million-prs-engineering-productivity)

8.1M pull requests reveal the gap between AI adoption and engineering impact, and why code review is the bottleneck blocking real productivity gains.

## Structured data

_Machine-readable metadata (JSON-LD) embedded in the page for search/AI context — not content rendered on the page itself._

```json
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "LinearB",
  "url": "https://linearb.io/",
  "logo": "https://assets.linearb.io/image/upload/v1715628027/logo-mark-lg.svg",
  "description": "LinearB is the engineering productivity platform that helps engineering leaders prove AI is improving throughput without sacrificing delivery confidence, flow efficiency, or developer experience.",
  "sameAs": [
    "https://www.linkedin.com/company/linearb"
  ],
  "award": [
    {
      "@type": "Award",
      "name": "LinearB is a Leader in the 2026 Gartner® Magic Quadrant™ for Developer Productivity Insight Platforms",
      "dateAwarded": "2026",
      "awardedBy": {
        "@type": "Organization",
        "name": "Gartner®"
      }
    },
    {
      "@type": "Award",
      "name": "Great Place to Work Certification",
      "dateAwarded": "2025-2027",
      "awardedBy": {
        "@type": "Organization",
        "name": "Great Place to Work"
      }
    },
    {
      "@type": "Award",
      "name": "America's Best Startup Employers 2025",
      "dateAwarded": "2025",
      "awardedBy": {
        "@type": "Organization",
        "name": "Forbes Magazine"
      }
    }
  ],
  "hasCertification": [
    {
      "@type": "Certification",
      "name": "SOC 1 Type 2"
    },
    {
      "@type": "Certification",
      "name": "SOC 2 Type 2"
    },
    {
      "@type": "Certification",
      "name": "GDPR Compliance certification"
    },
    {
      "@type": "Certification",
      "name": "ISO 27001"
    }
  ]
}
```

```json
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "LinearB Best Practices for Integrating Jira",
  "url": "https://linearb.io/blog/jira-best-practices",
  "author": {
    "@type": "Person",
    "name": "Necco Ceresani"
  },
  "datePublished": "2024-03-12T12:19:05.978Z",
  "dateModified": "2024-03-12T12:19:05.978Z",
  "image": "https://assets.linearb.io/image/upload/v1720000000/Group_6854_1_40c6892a6e.png",
  "publisher": {
    "@type": "Organization",
    "name": "LinearB",
    "logo": "https://assets.linearb.io/image/upload/v1777485755/linearb-logo-2026.png"
  },
  "description": "Integrating Jira with LinearB presents an opportunity for software development teams to streamline project delivery and enhance productivity."
}
```

## More on linearb.io

### Top navigation

- [Book a Demo](https://linearb.io/book-a-demo)
- [AI Code Reviews — Catch security risks, bugs, and spec mismatches](https://linearb.io/platform/ai-code-reviews)
- [AI & Productivity Insights — See how AI tools affect cycle time and delivery speed](https://linearb.io/platform/ai-developer-productivity-insights)
- [Measure AI Impact — Track AI adoption and tie it to delivery outcomes](https://linearb.io/use-case/measure-ai-impact)
- [MCP Server — Chat with your data to spot patterns and boost output](https://linearb.io/platform/mcp-server)
- [Resource Allocation — Cost initiatives and shape your investment strategy](https://linearb.io/platform/resource-allocation)
- [Cost Capitalization — Capitalize engineering costs with audit-ready reports](https://linearb.io/platform/cost-capitalization)
- [Dev Team Management — Set targets and tie throughput to business outcomes](https://linearb.io/platform/goals-and-reporting)
- [DevOps Workflow Automation — Policy-based PR routing, approvals, and tests](https://linearb.io/platform/ai-workflow-governance)
- [AI Powered Support — Unify AI and human code delivery in one clear view](https://linearb.io/use-case/ai-powered-support)
- [Optimization — Surface friction with feedback and MCP insights](https://linearb.io/platform/developer-experience)
- [Reporting — Spot what's working and what needs attention](https://linearb.io/use-case/measuring-developer-experience)
- [Surveys — Turn developer feedback into actionable signals](https://linearb.io/platform/developer-surveys)
- [Platform overview](https://linearb.io/platform/overview)
- [Register now](https://linearb.io/event/engineering-productivity-gap)
- [Customers](https://linearb.io/customers)
- [Pricing](https://linearb.io/pricing)
- [Why choose LinearB — Explore your data. Measure performance. Act to improve it.](https://linearb.io/why-linearb)
- [APEX framework — The operating model for AI-era engineering teams](https://linearb.io/resources/apex-framework)
- [Anti-FAQ — The questions other vendors won't answer](https://linearb.io/why-linearb/anti-faq)
- [Security — Enterprise-grade compliance and zero code access](https://linearb.io/security)
- [Build vs. buy — The hidden cost of building it yourself](https://linearb.io/resources/build-vs-buy)
- [Dev Interrupted Podcast — Conversations with engineering leaders](https://linearb.io/dev-interrupted/podcasts)
- [Reports & Guides — Deep dives on productivity and delivery](https://linearb.io/resources)
- [Webinars — Expert sessions on productivity and AI](https://linearb.io/resources?category=workshops)
- [Metrics Benchmarks — See how your engineering org stacks up](https://linearb.io/resources/software-engineering-benchmarks-report)
- [Blog — Product updates and practical insights](https://linearb.io/blog)
- [Help Center — Documentation, setup, and support](https://linearb.helpdocs.io)
- [API Docs](https://docs.linearb.io/api-overview)
- [Status](https://www.linearbstatus.com/)
- [Integrations](https://linearb.io/integrations)
- [LinearB Library](https://linearb.io/library)
- [Engineering metrics](https://linearb.io/library/engineering-metrics)
- [Platform engineering](https://linearb.io/library/platform-engineering)
- [Engineering glossary](https://linearb.io/library/engineering-glossary)
- [Developer productivity](https://linearb.io/library/developer-productivity)
- [AI in software development](https://linearb.io/library/ai-in-software-development)
- [Engineering management](https://linearb.io/library/engineering-management)
- [Developer experience](https://linearb.io/library/developer-experience)
- [DevOps](https://linearb.io/library/devops)
- [Engineering operations and the context layer](https://linearb.io/library/engineering-operations)
- [Engineering efficiency](https://linearb.io/library/engineering-efficiency)
- [Software delivery](https://linearb.io/library/software-delivery)
- [Research and data](https://linearb.io/library/engineering-benchmarks-and-research)
- [LinearB is a Leader in the 2026 Gartner® Magic Quadrant™ for Developer Productivity Insight Platforms](https://linearb.io/resources/gartner-magic-quadrant-dpi-platforms-2026)
- [Sign in](https://app.linearb.io/login)
- [Enterprise](https://linearb.io/solutions/enterprise)
- [Contact](https://linearb.io/contact-us)
- [About us](https://linearb.io/about-us)
- [Careers](https://linearb.io/careers)
- [Service agreement](https://linearb.io/services-agreement)
- [Privacy policy](https://linearb.io/privacy-policy)
- [DPA](https://linearb.io/data-processing-agreement)
- [Security FAQ](https://linearb.io/security-faq)
- [Substack](https://devinterrupted.substack.com/)

### Footer

_Additional links from the site footer, not repeated from the top navigation above._

- [GitHub](https://github.com/linear-b)
- [LinkedIn](https://www.linkedin.com/company/linearb)
- [Twitter](https://twitter.com/LinearB_Inc)