DEV Community

Cover image for How to Set Up Jira the Right Way (Most Teams Get This Wrong)
Nisha
Nisha

Posted on

How to Set Up Jira the Right Way (Most Teams Get This Wrong)

Most Jira setups aren't wrong. They're just set up for the team that existed on day one — not the team that exists six months later.
By the time a team of 20 becomes 80, the Jira instance is a mess of duplicate issue types, 12 custom fields nobody remembers creating, and a permission scheme that's been patched so many times it's held together with assumptions. The code still ships. The board still moves. But the overhead keeps climbing.
This is what a poor Jira implementation actually looks like — not a broken system, just one that scales against you instead of with you.
Here's what a proper implementation gets right from the start.

  1. Workflow design before configuration The most common mistake: admins open Jira, start clicking, and build workflows around how they think work flows — not how it actually flows. A workflow audit before you touch the configuration should answer:

What does "done" actually mean for each issue type?
Who has authority to move an issue from one status to the next?
Are there approval gates? Who owns them?
Which transitions need conditions or validators, and which don't?

Get this wrong and you end up with statuses nobody uses, transition conditions that block real work, and a backlog that doesn't reflect reality. Get it right and the board becomes a live picture of actual delivery.
Bad: To Do → In Progress → Done
Good: Backlog → Ready for Dev → In Progress → In Review → QA → Done
The difference isn't the number of statuses — it's whether each status represents a real handoff point that somebody owns.

  1. Issue type hierarchy that matches how your teams think Jira gives you Epics, Stories, Tasks, Subtasks, and Bugs out of the box. Most teams either use all of them inconsistently or collapse everything into Tasks because "it's simpler." Neither works at scale. The right hierarchy depends on what you're tracking:

Software teams: Epic → Story → Subtask (with Bug as a parallel type)
DevOps/Platform teams: Epic → Task → Subtask (stories don't fit infrastructure work)
Business/Ops teams using Jira Work Management: Campaign → Task → Subtask

The mistake is mixing these in a single project without clear governance — developers creating Epics that should be Stories, PMs creating Stories that should be Tasks. Reporting breaks. Roadmaps break. Velocity becomes meaningless.
Define the hierarchy before you create the first project. Document what each level means. Make it boring and obvious.

  1. Custom fields: less is almost always more Every custom field adds to query time, slows board load, and creates a schema management headache when you need to clean it up later. Before adding a custom field, ask:

Can a label or component cover this instead?
Is this field actually needed for reporting, or does someone just "want to track it"?
If we need this field, should it be global or project-scoped?

A common rule: no new global custom field without a documented reporting use case. Everything else gets a label.
Jira Cloud now enforces hard limits on custom fields starting from March 2026 — so this isn't just good practice, it's a compliance constraint going forward.

  1. Permission schemes that don't break when people leave
    Most Jira permission schemes are built around named users — "Sarah has Browse access on this project" — instead of roles. Then Sarah leaves and six months later someone notices a project is either locked or wide open.
    The right pattern:
    Project Role: Developer → Permission: Edit Issues, Create Issues
    Project Role: Reporter → Permission: Browse Projects, Create Issues
    Project Role: Viewer → Permission: Browse Projects
    Assign users to roles, not directly to permissions. When Sarah leaves, you remove her from the Developer role. Nothing else changes.
    This becomes even more important when you're running 50+ projects. Auditing named-user permissions across 50 projects is a manual nightmare. Auditing role membership is a five-minute query.

  2. Automation rules with a naming convention
    Jira automation is powerful and easy to break in subtle ways. The biggest operational risk isn't the rule itself — it's that nobody knows what it does six months later because it was named "Auto-assign rule 3."
    Before you build:

Establish a naming convention: [PROJECT] - [TRIGGER] - [ACTION] e.g. DEVOPS - Issue Created - Auto-assign to On-Call
Document the business rule it's implementing, not just what it does technically
Set a rule owner — someone who gets notified if it starts failing

For JSM specifically: automation rule execution is capped per plan tier in Cloud. Standard plan gets 5,000 rule runs/month per user. Premium gets 1,000/user. If you're building heavy automation on Standard, you'll hit the ceiling faster than you expect — plan for it.

  1. Integration setup order matters Teams typically set up Jira first, then try to connect everything else later — Confluence, Bitbucket, Slack, CI/CD. This creates integration debt where each connection has to work around decisions already baked into the Jira config. The right order:

Define the issue key format and project structure
Connect version control (Bitbucket/GitHub/GitLab) — smart commits depend on the issue key
Connect CI/CD (Bamboo/Jenkins) — deployment tracking depends on issue keys and project structure
Connect Confluence — space linking and page templates depend on project names
Connect communication tools (Slack, Teams) — notification rules depend on workflow statuses being final

Doing it backwards means your smart commits reference issues that don't exist yet, your Confluence spaces link to the wrong projects, and your Slack notifications fire on the wrong status transitions.

  1. User training isn't optional — it's the last mile A technically perfect Jira setup with zero adoption is still a failed implementation. The failure pattern: admins spend three weeks configuring everything, run one lunch-and-learn session, and then wonder why the board looks nothing like the documented workflow six weeks later. What actually works:

Role-based training: Admins, Project Managers, and End Users need different sessions — they interact with Jira in completely different ways
Workflow walkthroughs, not feature tours: show users their actual workflow in the configured system, not a generic demo
Power user identification: find 2-3 people per team who will own adoption and answer questions — this scales better than centralizing all support

The goal isn't that users can click around Jira. It's that the board reflects reality by default because the workflow matches how people actually work.

The sequence that works
If you're doing a Jira implementation from scratch or resetting a messy one, here's the sequence:

Workflow design (on paper, before any configuration)
Issue type hierarchy definition
Permission scheme design using roles
Project setup with scheme assignment
Custom field audit — add only what's needed for reporting
Integration connections in dependency order
Automation rules with naming conventions and documented owners
Role-based training before go-live
Post-go-live review at 30 days

The 30-day review is the part most teams skip. It's also where you find the things that looked right in the design but don't match how people actually work — and it's much cheaper to fix at 30 days than at 6 months.

Getting Jira right isn't complicated, but it does require doing the boring work first — documenting the workflow before touching the config, defining roles before assigning permissions, building the naming convention before creating the first rule.
The teams that skip that upfront work are the ones rebuilding their Jira instance 18 months later.

Empyra is an Atlassian Platinum Solution Partner with 30+ years of experience in enterprise IT consulting. Our Jira implementation services cover everything from initial workflow design to post-go-live optimization across industries including financial services, healthcare, and government.

Top comments (0)