ChangeTrail documentation
ChangeTrail shows every field change across any set of Jira issues: who changed what, and when.
Where to find it
- Apps menu: Apps, then ChangeTrail, for any JQL.
- Project sidebar: ChangeTrail, starting from that project.
- Issue view: the Change history panel lists every change to that issue.
Run a report
- Enter JQL, or keep the default (issues updated recently).
- Pick a time range: last 7, 30 or 90 days, last 12 months, or all time.
- Optional: pick fields, for example Assignee, Priority, Due date or Sprint. The list fills in after the first run.
- Click Show changes.
ChangeTrail reads issues 100 at a time and shows progress (for example "Read 2,300 of about 5,100 issues, 8,400 changes"). Click Stop and show what was read to see a report for what has been read so far.
Tabs show every change, counts by field, counts by person, and a table you can paste into Excel or Google Sheets.
Dashboard gadget
Add Recent changes (ChangeTrail) to any Jira dashboard: Edit the dashboard, Add gadget, search for ChangeTrail. In the gadget settings choose:
- JQL: the issues to watch (default: updated in the last 30 days).
- Fields: optional, comma separated, for example
Assignee, Priority. Leave empty for every field. - Changed in: the last 7 or 30 days.
- Show: the newest 10 or 20 changes.
Each change shows the issue, field, old and new value, who and when. The gadget reads up to 1,000 issues and says so when your query matches more. Open full report opens the ChangeTrail report page with the same JQL and time range and runs it.
Notes
- Changes made by automation or apps show as "Automation or app".
- Times are shown in UTC.
- A report reads up to 10,000 issues and 200,000 changes. If your query goes past either limit, ChangeTrail says so; narrow the JQL, time range or fields.
- The Changes and Copy to spreadsheet tabs have an Export these issues to Excel with SheetOut link. It opens SheetOut with the report's JQL filled in (SheetOut is a separate app; the link to its listing is next to it).
- The totals, By field and By person tabs cover every change read. The Changes tab and the spreadsheet tab list the newest 5,000 changes; for a full file with every change, export with SheetOut.
Permissions and privacy
ChangeTrail reads Jira as you, so reports only include issues you can see. It stores nothing and sends nothing outside Atlassian. See the privacy policy.
Pricing
Free for up to 10 users. Paid via Atlassian for larger sites.