This page includes release notes and updates for Jira Cloud app developers. Use this page to keep track of upcoming changes, deprecation notices, new features, and feature updates from Jira Cloud Platform.
For updates about changes to the Forge platform, see the Forge changelog in the Forge documentation.
Go to our developer community to ask questions. You may also be interested in the What's New blog for Atlassian Cloud where details of major changes that affect all users of the Jira Cloud products are announced.
Rollout: Progressive rollout by tenant. IMPLEMENTING
Updating workflows via the Bulk update workflows API will discard existing draft workflows that are associated with the workflow.
This change is being made because draft support will be discontinued with the retirement of the old workflow editor.
As of Jul 7, 2025 , the following APIs will stop returning usage data in their responses:
Workflows
Statuses:
Workflow schemes:
Refer to CHANGE-2298 for more details.
As part of the Atlassian visual refresh updates, we updated the UI Kit Icon component. Some glyphs get a new look, and many more glyphs have been added. There are also a number of deprecations, as detailed below.
The size
prop will only support the values "small"
and "medium"
. The value "large"
is now deprecated and will be removed.
The prop primaryColor
has been renamed to color
.
The prop secondaryColor
is now deprecated and will be removed.
Some glyphs haven been replaced and others will be removed. Visit the Icon migration guide for information on finding a replacement.
The new default size for icons will change from 24x24 pixels to 16x16 pixels.
All deprecations and breaking changes will take place on Jan 1, 2026. Until then, the new Icon
component will be fully backwards-compatible. Any deprecation will trigger a console warning prefixed with [@forge/react: Icon]
on non-production environments.
On Jun 24, 2025, we announced the addition of number field formatting through the Atlassian GraphQL Gateway (AGG) for Jira team-managed projects.
Rollout: The change will be progressively rolled out by tenant starting today, Jul 1, 2025 and is expected to finish on Jul 14, 2025
In October 2024, we announced the deprecation of Deprecation of some JQL search and evaluate expression endpoints. These deprecated search endpoints are now being removed:
GET /rest/api/2|3|latest/search
POST /rest/api/2|3|latest/search
POST /rest/api/2|3|latest/search/id
POST /rest/api/2|3|latest/expression/eval
For full details of this deprecation, including replacement endpoints, see https://developer.atlassian.com/changelog/#CHANGE-2046.
Forge Remotes are now available in the Atlassian Government Cloud. Please refer to the AGC documentation for details on supporting Forge Remotes within your AGC Forge app.
We are deprecating the following Atlassian Connect-related unscoped npm packages in favor of their @atlassian scoped equivalents.
Starting 24th of July 2025, these packages will no longer be supported, and we recommend transitioning to the corresponding scoped packages instead.
The affected packages are:
old package name | new package name | latest version of new package |
---|---|---|
|
|
The scoped packages maintain 100% API compatibility with their unscoped versions, ensuring a seamless migration experience. We recommend updating to the scoped versions as soon as possible before the deprecation date.
All of these packages are part of the Atlassian Connect ecosystem and are used for developing Connect apps. The scoped packages provide identical functionality but align with our standardized package naming conventions. This change helps ensure consistency across our npm ecosystem and improves package security.
To update your dependencies, replace the unscoped package names with their scoped equivalents in your package.json files.
If you encounter any issues during migration, please reach out through the Developer Community forums.
We are augmenting the existing team-managed project Number custom field in Jira cloud to support unit configuration. This will include currency and percentage unit types, as well as formatting.
Apps will be able to retrieve, and display monetary values with correct formatting and units through the Atlassian GraphQL Gateway (AGG) by:
Querying formatUnit
, formatStyle,
and formatDecimals
on JiraNumberFields
The underlying Number value storage will remain unchanged, meaning that this is a purely additive change and no action is needed
JQL search will behave exactly like the number field works today. It will be unaware of the currency unit through all the access points.
This capability will be extended to number fields in company-managed projects in the coming months and communicated separately
Rollout: will be progressively rolled out by tenant from Jul 1, 2025
We’re introducing the ability for apps to publish events, allowing for enhanced interoperability between apps. This feature enables apps to subscribe to events using the existing https://developer.atlassian.com/platform/forge/manifest-reference/modules/trigger/ module, opening up new possibilities for app interactions.
Developers can start using app events by implementing the https://developer.atlassian.com/platform/forge/manifest-reference/modules/event/ module in their apps. For detailed guidance and examples, refer to https://developer.atlassian.com/platform/forge/events-reference/app-events/.
To publish events using the runtime API, you need at least version 2.0.0
of the @forge/events
dependency. Add this to your package.json
:
1
2
3
4
5
{
"dependencies": {
"@forge/events": "^2.0.0"
}
}
A new getUrl
method has been added to router
in @forge/bridge
. The method will accept a NavigationLocation
object and return a URL object for the corresponding destination.
This method is in Preview. For more details, see the router documentation.
Run npm install --save @forge/bridge@latest
in your resource directory to install the latest version of Forge bridge.
We have enhanced Bulk Move API to allow users to move both parent and child work items/issues in a single request, as well as move multiple work items/issues of different types in the same request.
REMINDER As previously announced in CHANGE-2298, starting from Jul 7, 2025, we will begin the process of deprecating the expands
query parameter used for retrieving associated projects, workflows, issue types, and schemes across various Jira Cloud APIs. We strongly recommend transitioning to the usage APIs detailed here.
Affected APIs and parameters
Workflows:
Bulk get workflows: The ability to use the workflows.usages
and statuses.usages
expands will be deprecated.
Bulk create workflows: Usage information will no longer be included in responses.
Bulk update workflows: Usage information will no longer be included in responses.
Statuses:
Bulk get statuses: The usages
and workflowUsages
expands will be deprecated.
Search statuses paginated: The usages
and workflowUsages
expands will be deprecated.
Bulk create status: The usage
and workflowUsages
fields will no longer be returned.
Workflow schemes:
Bulk get workflow schemes: The workflows.usages
parameter will be deprecated.
You may need to update your app as a result of this change - see the More details section.
Migrate to the new usage APIs announced as part of CHANGE-2292.
We have published a new migration guide to assist you in transitioning your Forge custom fields to use the isInline
property.
The guide includes two practical examples:
Migrating a Forge custom field to render inline
Migrating a Forge custom field to render in a modal
For more details, please refer to https://developer.atlassian.com/platform/forge/manifest-reference/modules/jira-custom-field/#inline-edit-migration-guide
The list of modified fields in the Jira workflow validator has been expanded to include two new fields:
Linked Issues
Comment
For a complete list of all supported field types, please refer to the documentation: Jira Workflow Validator.
We are announcing support for the following Connect on Forge Jira Software provider modules:
jira:jiraDevelopmentTool
jira:jiraFeatureFlagInfoProvider
jira:jiraDeploymentInfoProvider
jira:jiraBuildInfoProvider
jira:jiraRemoteLinkInfoProvider
jira:jiraSecurityInfoProvider
jira:jiraOperationsInfoProvider
jira:jiraDevOpsComponentProvider
This means that Connect apps using these Jira Software provider modules can now adopt Forge and continue to use the functionality in the Connect modules. See this page for more information about how to adopt Forge from Connect: https://developer.atlassian.com/platform/adopting-forge-from-connect/how-to-adopt/.
Rate this page: