The Jira Align support guide provides an overview of the various help resources available for Jira Align, as well as guidelines for creating and monitoring support tickets, feature requests, and test instance refresh requests. We recommend reading this guide to assist you in creating better cases and getting issues resolved as quickly as possible.
We're introducing OAuth 2.0 three-legged authorization (3LO) for the Jira Align API as an early access program. OAuth 3LO provides a more secure and scalable method to access Align data and actions via API, replacing older authentication methods. This is especially important for customers running third-party or custom integrations that need programmatic access to Align data.
This feature is currently in an early access program. Contact Atlassian Support to join.
We've added the ability to mark programs as active or inactive in Jira Align, giving administrators a way to reduce clutter from completed or paused programs. Open any program's details panel and set the Active dropdown to No to make it inactive.
Filtered by default: Inactive programs and their children are automatically filtered out of navigation menus, page filters, and program dropdowns across all work item details panels and key pages including backlogs, roadmaps, grids, OKR hub, program board, and custom hierarchies.
Clearly labeled: When inactive programs do appear in grid views (such as on work items still associated with them), Jira Align labels them as inactive across all grid pages.
Active column and filter on the programs grid: A new Active column and filter on the programs grid lets you quickly see and sort by program status.
API support: The REST API for programs now supports reading and updating the active state.
Roadmaps: Sort epics and capabilities by program rank
Building on the program rank sorting we introduced in 11.23, we've extended this capability to epics and capabilities on roadmaps. You can now sort these work items using the same ranking order defined in your backlog, giving you a consistent view of priorities across planning surfaces.
Program rank: When viewing epics or capabilities at the program level with no program increment (PI) or multiple PIs selected in the sidebar, select the new Program Rank sort option from the Sort by dropdown in View settings. Items will display in the same order as they appear in your backlog for that program.
Program PI rank: When a single PI is selected in the sidebar, the sort option automatically switches to Program PI Rank, reflecting the backlog ranking for that specific program increment.
Unranked items: Unranked items display at the bottom. Sort options respect your platform terminology and are preserved in deep links for easy sharing.
Epics grid: New sorter, inline editing, and snapshot filtering
We've added new ways to organize and edit data directly in the updated epics grid.
New sorter: You can now sort the grid by Primary Program.
Inline editing: Edit the Owner and State columns directly in the grid without opening the details panel. We've also improved inline editing for the Start/Initiation and Target Completion date fields: dates outside of selectable options are now disabled instead of displaying an error after selection.
New filter: You can now filter by your strategic snapshots with the Snapshot filter.
Beta capabilities grid: Expanded columns, filters, and sorters
The updated capabilities grid continues to expand its supported data. In this release, we've added 18 new columns, 7 new filters, and 5 new sorters.
Fields, filters, and sorting options added in this release(select to expand)
Columns
Portfolio
Solutions
Points
Theme
Strategic Value Score
Process Step
Release Vehicle
MVP
Portfolio Ask
Effort SWAG
Strategic Horizon
Functional Areas
Additional Programs
Custom Hierarchies
Custom Dropdown
Custom Multi-Select Dropdown
Custom Text Input
Custom Text Area
Filters
Themes
Snapshot
Process Step
Release Vehicle
MVP
Strategic Horizon
Epic
Sorters
Strategic Value Score
Effort SWAG
MVP
Strategic Horizon
Custom Fields
Grid pages: Persistent caching and manual refresh
The updated epics, capabilities, and features grids now cache your loaded data, including filters, columns, and table contents. When you navigate away and return, the grid loads your previous state instantly instead of loading everything again.
Data is always refreshed in the background, but if you suspect your data might be stale, you can select the Refresh button to force a reload at any time.
Grid pages: On-premise updates
For on-premise environments, we've added the following to updated grid pages:
Total work item counts on all updated grid pages.
The updated epics grid in custom rooms.
Audit logging for all administration pages
We've added comprehensive audit logging across Jira Align's administration settings, giving administrators a detailed record of who changed what and when.
Platform settings: Changes across all configuration tabs, with exact before and after values.
Details panel settings: Field visibility and ordering changes.
Email configuration: Workflow email notification rules and scheduled email setup creates, updates, and deletes.
Platform terminology: Custom terminology changes.
API: Discussion endpoints for objectives
We've added discussion endpoints for objectives to the REST API, giving you the ability to integrate objective-level conversations into your automation and reporting workflows.
List discussions: Use GET to retrieve all comments on a specific objective.
Create discussions: Use POST to add new comments to an objective programmatically.
Update discussion status: Use PUT to change the status of an existing comment.
Delete discussions: Use DELETE to remove comments from an objective.
Delivered suggestions
Feature backlog Kanban view: Additional estimate values on cards
Thanks to your votes on JIRAALIGN-8267, feature cards in the backlog Kanban view now display estimate values from all available sources, including the Details tab, the Forecast tab, and the story point rollup from child stories. Previously, only the Forecast tab estimate was shown. This gives teams a more complete picture of effort estimates when planning.
Progress bar pop-out in Epic (New) Grid shows incorrect terminology
11.26.0
We've corrected the following bugs that were discovered while investigating related issues, building new enhancements, and performing maintenance:
11.26.0
API: The InScope field on features could be set via the REST API v2 to values other than the valid options (0, 1, or null).
Backlog: Items moved to or from the Parking Lot were incorrectly re-ranked when the action was canceled.
Backlog: New items added to the backlog did not appear on the board until the page was reloaded.
Backlog: New items created via quick add on the epic backlog did not display all expected columns until the page was reloaded.
Backlog: We've corrected several issues where work item rankings were not properly cleared or recalculated when items were reassigned to a different program or release. This affected themes, epics, features, and capabilities across the backlog, details panel, and REST API v1/v2 endpoints.
Backlog: When using Copy with Children on an epic, the newly created items did not appear on the backlog board until the page was reloaded.
Defects grid: The Affects Doc column was always displaying as empty, even when values were set on the defect.
Dependency API: The TotalCount value returned by the dependency API for assigned stories, features, and capabilities did not match the actual results when canceled or recycled items were present.
Epics grid (legacy): Sorting by specific columns on the legacy epics grid could cause a blank screen.
Platform: A System. FormatException error could occur in certain conditions, causing a server-side crash.
Release vehicles: The "not equal" filter option was not working correctly for the Date Created filter on the release vehicles page.
Roadmaps: The "No Value" option in the Process Step filter was not working correctly on modernized roadmap pages.
Identified and resolved a vulnerability related to checklist items.
Identified and resolved a vulnerability related to external links.
Identified and resolved a vulnerability related to the Quick Add Story dialog.
Identified and resolved a vulnerability related to user progress cards.
Below is our upcoming release schedule. Sandbox and production environments will be unavailable during our maintenance window, which starts at 11:00PM EST on the day listed below and ends at 2:00AM EST on the following day.
Release Version
Continuous Track for Sandbox and Production (if elected) Environments
Production environments are set to use the bundled release track, while sandbox environments use the continuous track. We recommend using this default setup for your environments, as it allows you to test new features released in a .0 feature release for two weeks in your sandbox environment. Those changes will then deploy to your production environment in a .1 maintenance release.
Jira Align's Enterprise Insights (EI) version 11.26 was deployed to environments on the continuous release track on June 26, 2026. It will then be deployed to environments on the bundled release track on July 3, 2026.
Release highlights
There are no functional changes or bug fixes included in version 11.26. The Enterprise Insights schema remains on version 11.22.
Below is our upcoming release schedule for Enterprise Insights (EI). Sandbox and production environments will be unavailable during our maintenance window, which starts at 11:00PM EST on the day listed below and ends at 2:00AM EST on the following day.
See the Release calendar article for the schedule of releases for the Jira Align platform.
The installation and upgrade process for self-hosted Enterprise Insights is changing with version 11.23. Read on to understand what's new and what steps you need to take.
Enterprise Insights 11.23 contains a reliability and flexibility update for the self-hosted installer. It introduces answer file support for repeatable deployments, comprehensive pre-flight validation, and expanded SQL Server connectivity options.
Benefits of the change
Installing and upgrading Enterprise Insights in self-hosted environments has historically required careful manual input and could surface errors late in the process. This release addresses that by:
Catching problems before they start: credentials, version compatibility, and database readiness are all validated before any changes are made
Enabling repeatable, unattended deployments: a new answer file lets you configure once and reuse across environments and upgrades
Supporting more deployment topologies: remote SQL Server, non-default ports, and self-signed certificates now work without manual script modifications
Making upgrades seamless: existing ETL jobs are detected and handled automatically, eliminating common upgrade errors
All changes are fully backward compatible. Existing installations using default settings will continue to work without modification.
What's included
Area
Highlights
Answer file
Pre-configure all inputs for unattended, repeatable installs and upgrades
Pre-flight validation
Credential, version, and database readiness checks run before deployment begins
SQL Server connectivity
Remote servers, non-default ports, and self-signed certificate support
Upgrade reliability
Automatic detection and safe handling of existing ETL jobs
Error reporting
Clear identification of which step failed, with actionable guidance
Branding
Updated from legacy naming to "Enterprise Insights" throughout
Answer file for unattended deployments
You can now pre-configure all installer inputs in a single answer file and run installations without interactive prompts. A documented template (Install.Answers.psd1) is included in the installer package, organized into clear sections (Data Warehouse, SSIS Catalog, SQL Admin, ETL Job, and Jira Align connection) with inline comments explaining each setting.
Key benefits:
Eliminate manual entry: no more typing 15+ values at each install or upgrade
Reduce errors: pre-validated configuration catches typos and missing values before deployment starts
Enable automation: fully scriptable for CI/CD pipelines and scheduled upgrades
Document your environment: the answer file serves as a living record of your deployment configuration
Hybrid mode: leave any value blank to be prompted interactively; pre-fill the rest
To get started, copy the included template, fill in your environment values, and pass it to the installer. For fully unattended operation, add the -Force flag to skip confirmation prompts while retaining all safety checks. See the Self-Hosted Enterprise Insights Guide for detailed instructions.
Security: Answer files containing credentials should be stored securely and excluded from source control. See the template comments for guidance.
Pre-flight validation
The installer now performs a comprehensive set of checks before making any changes to your environment:
Credential verification: all database connections are tested up front, so you will know immediately if a password or server name is wrong
Version compatibility: Enterprise Insights and Jira Align versions are compared, with a warning on mismatch to prevent accidental misalignment
Database readiness: active connections, open transactions, and database state are checked to prevent deployment failures
Existing ETL job detection: if a job with the same name already exists, the installer shows its current status and safely handles the replacement
This means configuration problems surface immediately, not partway through a deployment.
Flexible SQL Server connectivity
The installer now supports a wider range of SQL Server deployment topologies:
Remote SQL Server: Data Warehouse, SSIS catalog, and Jira Align databases can each be on separate servers
Non-default ports: standard server,port format is now supported across all connections
Self-signed certificates: a single configuration option enables certificate trust across all SQL connections, eliminating the need to manually edit the script
Additional improvements
Smoother upgrades: upgrading with the same ETL job name now works seamlessly. The installer detects the existing job, displays its status, and handles the replacement automatically, including safely stopping a running job before deployment begins.
Better error reporting: when an error occurs, the installer identifies which step failed, provides the specific error with resolution guidance, and reports which steps were not yet executed
Schema deployment reliability: required deployment files are validated before starting, and failures are detected and reported immediately with log file references
Updated branding: legacy product references updated to "Enterprise Insights" throughout the installer
Resolved issues
This release addresses several issues reported by customers and identified during testing:
"MODIFY File Failed. Size is greater than MAXSIZE": the SSISDB file size configuration now checks current file sizes before applying limits, preventing errors when database files have grown beyond the original defaults
"The specified job already exists" during upgrades: re-running the installer with the same ETL job name no longer fails. The existing job is detected and replaced safely.
"The certificate chain was issued by an authority that is not trusted": self-signed certificate environments are now supported via a single configuration option, eliminating the need to manually edit the script
Schema deployment failures not reported: the installer now validates deployment results and halts immediately with a clear error message and log file location if the schema update is unsuccessful
Installer requires localhost SQL Server: the installer now supports remote SQL Server instances and non-default ports for all connections
Changes to installation and upgrade procedures
The installer package now includes the following files:
File
Description
Install.ps1
Main installer script
Install.Helpers.ps1
Required helper functions (new; must be in the same directory as Install.ps1)
Install.Answers.psd1
Answer file template with inline documentation (new; copy and customize for your environment)
Self-Hosted Enterprise Insights Guide
Updated PDF guide
For new installations:
No special action required. Follow the Self-Hosted Enterprise Insights Guide included in the installer package. We recommend using the included answer file template for a streamlined experience.
For upgrades from a previous version:
Ensure both Install.ps1 and Install.Helpers.ps1 are present in your installer directory. Both files are now required.
Run the installer as before. All new settings default to previous behavior.
We recommend creating an answer file from the included template (Install.Answers.psd1) to simplify this and future upgrades.
System requirements are unchanged: PowerShell 5.1, Windows Server 2019 or later. Compatibility has been verified with SQL Server 2019.
If you have questions about this change or installing/upgrading Enterprise Insights on-premise, please contact Atlassian Support.
You can subscribe to three Help Center sections to receive notifications the instant release note articles are published:
Release notes: These articles contain compiled information on a Jira Align version, initially published for the 10.X.0 feature release and updated each additional release through 10.X.3.
Announcements: These articles contain information about upcoming changes, updates about ongoing issues, or specific guidance outside of our normal release schedule.
Enterprise Insights release notes: These articles contain release notes specific to Jira Align Enterprise Insights (EI).
What you need to do
To receive real-time release notes publication notifications, you'll need to create a Help Center account and follow the section or sections you want to receive notifications about. Please note, this will most likely be a different username and password than your Jira Align and Atlassian username and password.
To create an account (or reset your password if an account already exists), click the SIGN IN button on the Help Center (see the pink arrow).
Next, click the Sign up link, enter your name and email, and then click the Sign up button. You'll receive an email to finish setting up your account. If you receive a message that says a user has already signed up with the given email, click the Forgot my password link to reset your password.
Once logged in, from the Help Center home page, click the WHAT'S NEW section (bell icon).
Then click the header for the section you want to follow. Finally, click the FOLLOW button and then the New articles link.
That's it! As soon as we publish new release notes, you'll receive an email notification with a link!
Our mission at Jira Align is to Simplify Software at Scale by bringing your business and your software development organization together in one intuitive platform.