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 excited to announce that Rovo, Atlassian’s AI-powered assistant, is coming soon to Jira Align! With this enhancement, you’ll be able to chat with Rovo directly in Jira Align and ask questions about your organization’s data to get instant insights.
Early access will be available through a beta program running from February 2nd through March 31st. Participants will help shape the final experience and receive dedicated support. Your feedback during the beta will directly impact how Rovo evolves in Jira Align.
To join the early access program, contact your Advisory Services representative, or open a new request with Atlassian Support, titled Align Rovo early access.
You can now share your customized view with teammates and other users on the roadmaps, new epics grid, and beta features grid pages.
When creating or editing a saved view, choose a visibility setting:
Private is the default, and keeps the view accessible only to you.
A lock icon displays next to the view name in menus and the page title.
Public lets other users access the view from the page’s Views menu.
The creator’s name and avatar will be displayed in the More actions menu, allowing others to identify a view owner.
Permissions to save and modify public views are based on two new system role permission toggles. By default, only the Super Admin role has these new permissions enabled at launch:
Additional options > Allow to save public view
Provides the ability to save a view as public.
Additional options > Allow to modify non-owned views
Provides the ability to edit and delete public views created by others.
Roadmaps: sort features by program ranks
You can now sort features on roadmaps using the same ranking order defined in your feature backlog, giving you a consistent view of priorities across planning surfaces.
Program Rank: When viewing features at the program level with no program increment or multiple PIs selected in the side navigation menu, select the new Program Rank sort option from the Sort by dropdown in View settings. Features will display in the same order as they appear in your feature backlog for that program.
Program PI Rank: When a single PI is selected in the side navigation menu, the sort option automatically switches to Program PI Rank, reflecting the backlog ranking for that specific program increment.
Unranked features display at the bottom.
Sort options respect your platform terminology and are preserved in deep links for easy sharing.
Roadmaps: sort capabilities by solution ranks
Similar to program rank for features, you can now sort capabilities on roadmaps by solution rank to align your roadmap view with your capability backlog priorities.
Solution Rank: When viewing capabilities at the solution level with no PI or multiple PIs selected in the side navigation menu, select the new Solution Rank sort option from the Sort by dropdown in View settings. Capabilities will display in the same order as they appear in your capability backlog for that solution.
Solution PI Rank: When a single PI is selected in the side navigation menu, the sort option automatically switches to Solution PI Rank, reflecting the backlog ranking for that specific program increment.
Unranked capabilities display at the bottom.
Sort options respect your platform terminology and are preserved in deep links for easy sharing.
Roadmaps: improved custom hierarchy permissions
We've improved how role toggle permissions work for custom hierarchies and the new roadmap, making it easier for administrators to grant the right level of access without over-provisioning.
More granular access for roadmaps and custom hierarchies: The Administration > Roadmaps (New) for Custom Hierarchies system role toggle can now be enabled even if the main Custom Hierarchies toggle is disabled, as long as the role has view access to at least one custom level.
Previously, enabling roadmaps for custom hierarchies would automatically turn on the Custom Hierarchies toggle, granting the ability to create and edit custom hierarchy levels. Administrators can now grant roadmap access to custom rooms without also granting custom hierarchy administrative permissions.
Custom hierarchy columns and filters available to all users: Custom hierarchy columns and filters on roadmaps are now visible for all roles and no longer require the Custom Hierarchies system role toggle to be enabled. This brings roadmaps in line with other areas of Jira Align, where users can already see and access custom rooms and custom hierarchy values in work item details panels regardless of this toggle.
Epics grid page: edit dates inline
You can now edit date fields inline on the new epics grid page, using the same interaction found on roadmaps. This gives you a quick way to prepare multiple epics for planning discussions.
Select a Start/Initiation or Target Completion cell to open a date picker. Once you’ve selected a date, tab or select away from the cell to save your choice.
Epics grid page: Release vehicle column
You can now add the Release vehicle column when viewing the new epics grid page.
Program increments: consistent planning across mixed-capability hierarchies
Previously, Jira Align required separate program increments for portfolios that use capabilities and portfolios that don't. If your instance had a mix of both, you couldn't assign a single program increment across them, forcing teams to create and manage duplicate PIs for the same planning period.
Now, a single program increment can be assigned to any portfolio regardless of its capability configuration. This works across both the UI and the public API.
Other enhancements included with this change:
Accurate Strategy Room rollups: Previously, rollups when grouping by PI were driven by the primary portfolio's capability setting, which could produce incorrect results for mixed configurations. Rollups now respect each portfolio's individual settings.
Correct PI slide-out details: The Program Increment slide-out now shows the Capability tab and calculates progress only for portfolios where capabilities are enabled.
Backlog views that match your hierarchy: When viewing by PI, the backlog now displays the correct child work item type: epics for non-capability portfolios and capabilities for capability-enabled portfolios. Previously, mixed PIs could incorrectly show "no features" for portfolios where capabilities should have been listed instead.
API: New endpoints for forecasts
We’ve introduced a new set of Forecasts Public APIs so you can programmatically read and manage forecast estimates for Jira Align work items, making it easier to keep external planning tools and reports aligned with what’s configured in Jira Align.
Work across key portfolio items: Access forecasts for epics, capabilities, and features, with support for release‑level, program‑level, and team‑level forecasts on each work item.
Read and write forecasts via API: Use GET endpoints to retrieve existing forecasts, and POST/PUT endpoints to create or update program and team forecasts where applicable, following the same validation rules as the Forecast tab in the UI.
Support multiple estimation systems: Send and receive estimates in points or member/team weeks; when the portfolio is configured for T‑shirt sizing, the API uses member or team weeks as the numeric representation behind those sizes.
Respect permissions and data integrity: All endpoints honor Jira Align permissions and Forecast tab access. Attempts to edit estimates that are retained from past program increment assignments are blocked and return a 409 Conflict, ensuring historical data remains read‑only.
Handle large data sets with pagination: Bulk GET endpoints support skip and top query parameters so you can iterate through large collections of forecasts efficiently.
Beta features grid page: new abilities, filters, and operators
We’ve made the following enhancements to the beta version of the features grid page:
Export support: Find the Export option available in the More (…) menu, providing parity with the legacy features grid.
Custom Hierarchy columns are now included in exports, with each hierarchy represented as its own uniquely named column.
Setup workflow support: Find the Setup workflow option available in the More (…) menu, providing parity with the legacy features grid.
New filters: Use the following filters to find specific features for your team and work.
Release vehicle
Category
Custom hierarchy
New filter operators: Use the following operators when filtering to identify specific features you care about.
Not in operator for
State
Portfolio
Solution
Primary program
Programs
Owner
Approach
Category
Customer
Product
Theme
Process step
Custom hierarchy
Custom single dropdown
Custom multi dropdown
No value operator for
Portfolio
Solution
Theme
Customer
Product
Program increment
Tag
Process step
Filters for custom text input and custom text area fields now support the Is, Is not, and Doesn’t contain operators.
Filters for custom multi dropdown fields now support all operators, providing full parity with other dropdown filters.
Bug fixes
This list of resolved bugs will be updated weekly to reflect changes from maintenance and bug fix releases.
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.23 will be deployed to environments on the continuous release track on March 27, 2026. It will then be deployed to environments on the bundled release track on April 10, 2026. The following changes are included in version 11.23:
Release highlights
Enhancements and features:
Self-hosted installer improvements for Enterprise Insights: Introduces an answer file for unattended installs and upgrades, comprehensive pre-flight validation, and expanded SQL Server connectivity options to make on-premise deployments more reliable and repeatable. For full details, see the announcement: Changes to Enterprise Insights self-hosted installation and upgrade procedures in 11.23.X.
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:
Main 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.
Supplemental Release Notes: These articles contain information on individual supplemental releases, published each release from 10.X.1 through 10.X.3.
Enterprise Insights Release Notes: These articles contain release notes specific to Jira Align Enterprise Insights (EI).
We recommend subscribing to both the Main and Supplemental Release Notes sections to get weekly notifications on the latest Jira Align version.
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.