Baseline X adds baselines to Jira. A baseline is a frozen, approved copy of a set of issues, such as a release scope, a contract phase or a requirements package. You can always compare it with what the issues look like today.
Jira shows the current state of every issue. Baseline X keeps the agreed state as well, so you can answer questions like what did we agree to?, what has changed since? and who approved it?
Key ideas
Term | Meaning |
|---|
Baseline | A named set of issues with a description, an approver and an optional budget. It belongs to one Jira project and gets an ID such as MOB-BL-1. |
Snapshot | A frozen copy of an issue's fields at a moment in time. Committing a baseline snapshots every issue in it. |
Baseline version | Each re-snapshot of a committed baseline creates a new baseline version (v1, v2, …). Earlier versions are kept. |
Issue version | A numbered snapshot of a single issue (v1, v2, …). It's created by a snapshot, a baseline commit, a re-snapshot or a Jira Automation rule, and only when the issue's content has changed. Every baseline that holds the issue shares the same numbering. |
Baseline lifecycle
Status | What you can do |
|---|
Open | Add and remove issues, or delete the baseline. Issues show live Jira data. |
Committed | The issue list is locked and every issue is snapshotted. You can view snapshots, compare them with today, re-snapshot, duplicate and complete the baseline. |
Completed | A closed record. Snapshots and versions stay viewable; the baseline can't be re-snapshotted. |
What you can do with Baseline X
Create baselines and add issues by search, JQL, saved filter or from the issue view.
Commit a baseline to freeze its scope, recording who committed it and when.
View each issue's snapshot, its current state and a field-by-field comparison.
Find what changed since the snapshot with Show changes, and record accepted changes as a new baseline version with Re-snapshot.
Duplicate a baseline into a new open baseline, for example to record approved additions.
Compare baselines, or two versions of one baseline, field by field.
Keep a version history for each issue (new): snapshot an issue at any time, see every version, compare versions and read the change history grouped by version.
Create issue versions from Jira Automation (new), for example whenever an issue reaches an approval status.
Search with JQL functions such as issue in baseline("MOB-BL-1") and issue in baselineCommitted().
Show baseline membership on issues and in list views with the Baseline custom field.
Where to find Baseline X in Jira
Project page: in a project, open the Baseline X tab. This is Baseline Home, where baselines are created and managed.
Issue view: the Baseline X panel on every issue shows its baselines and versions. The issue's ••• menu has Snapshot version (Baseline X).
Apps menu: Apps → Baseline X opens the global page, where Jira admins manage who can work with baselines in each project.
Cloud and Data Center
Baseline X runs on Jira Cloud and Jira Data Center. Issue versions and the Jira Automation action are currently available on Jira Cloud only. On Data Center the Versions section and version history don't appear, and everything else works as described.