Last updated Jul 11, 2025

Changelog

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.

Forge changelog

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.

11 July 2025

Announcement Workflow drafts to be discarded when workflows are updated via API

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.

7 July 2025

Deprecation Notice Removal of usage information in workflow, status, and workflow scheme APIs

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.

2 July 2025

Announcement Updates to Icon component in Forge UI Kit

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.

More details
  • 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.

1 July 2025

Added Jira number field formatting through AGG

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

30 June 2025

Removed Removal of JQL search and Evaluate expression endpoints

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.

Announcement Forge Remote now available in Atlassian Government Cloud

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.

26 June 2025

Deprecation Notice Unscoped Atlassian Connect npm packages in favor of @atlassian scoped packages

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

atlassian-openapi

@atlassian/atlassian-openapi

@atlassian/atlassian-openapi 1.0.6

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.

24 June 2025

Announcement Jira number field formatting through AGG

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

Added Introduction of App events (preview)

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.

More details

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" } }

Added New `getUrl` method in @forge/bridge package

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.

More details

Run npm install --save @forge/bridge@latest in your resource directory to install the latest version of Forge bridge.

23 June 2025

Added Enhanced Bulk Move API: Move parent and child work items in one request

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.

19 June 2025

Deprecation Notice Reminder - Deprecating usage information expands in workflow, status, and workflow scheme APIs

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.

More details

What you need to do

Migrate to the new usage APIs announced as part of CHANGE-2292.

17 June 2025

Added Migration guide for inline edit Forge custom fields

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

13 June 2025

Added Modified fields enhancement for the Jira workflow validator function

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.

11 June 2025

Announcement Announcing support for Connect on Forge Jira Software provider modules

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

More details

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: