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.
Today we published a blog titled Taking the Ecosystem Forward: An Update on the Future of Connect, which shares an early look at plans to phase out support for Connect. This early announcement is intended for owners of business critical Connect apps, including partners and customers with custom apps, to provide ample time to explore requirements and arrive at a fair timeline for end of support, together.
We’re seeking your feedback to help us shape the next steps for Connect - you can provide your feedback via the survey linked in the blog post.
The blog post details the key stages of our plan, as we progress on this journey. By the final stage, Connect will enter an end of support state (defined in the blog post), where apps can continue to utilise Connect modules, but do so at their own risk. At this stage, we do not have definitive dates for each of these phases - determining a fair and appropriate end of support date will be a joint effort with our partners and other app builders. The purpose of today’s announcement is to start that conversation.
We’re happy to announce several improvements to the JQL Functions module as well as the related precomputations API:
New endpoint to fetch precomputations by ID; see the docs to learn more.
New param (skipNotFoundPrecomputations) for the Update precomputations endpoint, allowing the request to succeed even if some of the requested precomputations no longer exist.
The same endpoint now returns a list of IDs of precomputations that couldn’t be found - notFoundPrecomputationIDs.
Apps can now return the storeErrorAsPrecomputation param to store the error message as a precomputation , see https://developer.atlassian.com/cloud/jira/platform/jql-functions/#output.
A new RFC is ready for review at https://community.developer.atlassian.com/t/rfc-79-jira-cloud-rest-api-endpoints-for-plans/87236.
We have added four new Forge modules in Jira, which provide additional extension points for customizing and extending Jira functionality.
The following modules are available in Preview:
Module | Description |
|---|---|
Adds a menu item to the more actions (•••) menu for the Jira backlog view. | |
Adds a menu item to the more actions (•••) menu for the Jira board view. | |
Adds a menu item to the actions (•••) menu on a sprint card in the backlog view. | |
Adds an item to the user's profile menu in the main navigation. When the item is clicked, content is rendered on a new Jira page. |
To be able to use the new modules, you must first update the Forge CLI: npm install -g @forge/cli@latest
These new Forge modules also allow Connect developers to replace equivalent Connect modules. For details on these equivalents, see Connect module equivalents.
Following the EAP release, UI Kit’s Frame component is now in preview. This means you can use the Frame component in the production environments.
The Frame component allows you to load custom resources within UI Kit, making it easy to import non-UI Kit components in a UI Kit module.
This update also supports Frame across all modules for Jira, Confluence and Compass.
For more information about how to use the Frame component, see here.
To use the latest version of the Frame component in your UI Kit app, install the @forge/react latest version by running npm install --save @forge/react@latest
We will no longer support creating Epic or Sub-task issue links via the create issue link REST API. This change is being made to streamline the API and improve performance.
This change will take effect after 3 months.
We will no longer support creating Epic link or Sub-task issue links via the create issue link REST API.
Developers should use the parent field in the Issue API to create hierarchy relationships between issues.
API Reference: https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-links/#api-rest-api-3-issuelink-post
Parent field Reference: https://community.atlassian.com/t5/Jira-articles/Introducing-the-new-Parent-field-in-company-managed-projects/ba-p/2377758
Affecting the create issue link API
Stop specifying an Epic or Sub-task link type to the API. Epic or Sub-task link type is specified by setting type.name="Epic-Story Link",type.name="jira_subtask_link"or type.id="{linkTypeId}"where linkTypeIdis the id of the Epic or Sub-task link type.
Once this deprecation is complete, requests that specify these fields will return a HTTP 400 bad request instead of the current HTTP 201 created response.
Note: All other link types will continue to work as-is.
Example payload that will become invalid
1
2
3
4
5
6
7
8
9
10
11
{
"inwardIssue": {
"key": "HSP-1"
},
"outwardIssue": {
"key": "MKY-1"
},
"type": {
"name": "Epic Link"
}
};Instead provide the parent field to the Issue API (https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-group-issues) for issues of all types to create a hierarchy relationship between issues. This is described in the existing notice here: https://community.developer.atlassian.com/t/deprecation-of-the-epic-link-parent-link-and-other-related-fields-in-rest-apis-and-webhooks/54048
An exmple new payload would be
1
2
3
4
5
6
7
8
PUT /rest/api/3/issue/10054
"fields": {
...
"parent": {
"id": "10055"
}
...
}You can now migrate existing Connect workflow modules to their Forge counterparts that are currently in Preview, with GA expected on those modules in Q1 2025.
This change allows your app to upgrade its existing Connect workflow modules to Forge modules. When upgrading, ensure that you set the Forge module key to the value of the key of the Connect module so that the Forge module can access existing workflow configuration information.
See Migrate Jira modules from Connect to Forge for more information.
The AdfRenderer component provides a way to render a valid ADF document, using the same renderer that Atlassian uses internally to render ADF content in Confluence pages, Jira work items, and so on. See ADF renderer for the full docs.
The ADF renderer component also allows you to replace node types that are unsupported in the context of a Forge app with replacement content, or remove them entirely.
See Atlassian Document Format for information on valid nodes.
Run npm i @forge/react@latest to install the preview version of the components and try them out now.
We’re happy to introduce two new Jira Forge product events:
Component deleted - avi:jira:deleted:component
Issue type deleted - avi:jira:deleted:issuetype
Follow the links to read more about them.
UI modifications, the Forge module that allows apps to modify fields, now supports the cascading select field on the Global issue create view.
For more information, see the list of supported fields for Global issue create.
We have now removed the UI Kit @forge/react version 9 from the Forge platform. This UI Kit version was deprecated on Aug 28, 2024.
We recommend using the latest version of UI Kit (@forge/react10).
For more information, see our deprecation policy.
The non-public endpoint /rest/teams/1.0/teams/find will be removed as part of the changes coming to Teams. This change is necessary to streamline our API offerings and improve performance. This change will take effect 3 months from this notice 05 Mar 2025.
If you have integrations with this internal API endpoint, migrate your system to use the teamSearch GraphQL query instead.
Jira Forge now supports the group, groups, user, users, date, and date time custom fields on the new Transition view. This means that we’ve released support for all custom field types on the new Transition view, thus getting it to full parity. Note that you have to enable the view on your instance to be able to use it.
For more information about the Transition view, go to our documentation.
We’ve added the jira:issueNavigatorAction module to Forge. You can use it to create custom actions on the issue navigator view. For more details, see the Jira issue navigator action documentation.
To be able to use the new module, you must first update the Forge CLI: npm install -g @forge/cli@latest
Rate this page: