Last updated Jul 30, 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.

30 July 2025

Added Board context is now available in the Jira project page extension data

We've updated the Forge module jira:projectPage to include board.id and board.type in its extension data. This change allows developers to access board-specific information directly within the project page, enabling more tailored and context-aware apps.

28 July 2025

Announcement Jira number field formatting for company-manged projects through AGG

We are augmenting the existing company-managed 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 do the following through the Atlassian GraphQL Gateway (AGG):

  • Retrieve and display values with correct formatting (currency, percentage, or number) by querying formatUnit, formatStyle, and formatDecimals on JiraNumberFields

  • Set and update the number field formatting via setting formatConfig when creating or updating custom fields

Please note that:

  • 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 functionality has already been released in team-managed projects. See the announcement here

Rollout: will be progressively rolled out by tenant starting late August 2025

23 July 2025

Added New API to get the Default Workflow Editor for a user

Currently, global admins have access to both the new and old workflow editors for CMP workflows. When a workflow is edited in Jira it opens in the admin’s default workflow editor. This may be the new or old editor based on user preference or system logic.

The default workflow editor API can be used to determine the default workflow editor for the authenticated user.

22 July 2025

Announcement Announcing support for Forge Jira Software provider modules

We are announcing support for the following Forge Jira Software provider modules. More information can be found in our documentation: https://developer.atlassian.com/platform/forge/manifest-reference/modules/index-jsw/

  • devops:developmentInfoProvider

  • devops:featureFlagInfoProvider

  • devops:deploymentInfoProvider

  • devops:buildInfoProvider

  • devops:remoteLinkInfoProvider

21 July 2025

Announcement Generally Available (GA) UI Kit components

16 July 2025

Early Access Home Dashboards Forge EAP

We’re launching a Forge module to allow extension of the new home dashboards that are currently in open beta. This early access program (EAP) will enable partners to test the new module, and provide feedback and requests.

We plan to run this EAP for roughly 3 months and we are particularly keen to hear what is missing from the module and the additional areas of extensibility we can provide.

As per the Atlassian Developer Terms, EAPs are offered to selected developers for testing and feedback purposes. APIs and features under EAP are considered “Early Access Materials” (set forth in section 10 of the Atlassian Developer Terms) and are unsupported, subject to change without notice, and are not recommended for use in production environments.

To participate, please sign up for the EAP here.

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

Rate this page: