This changelog is the source of truth for all changes to the Forge platform that affect people developing Forge apps.
See what's next for Forge on our platform roadmap.
We're excited to share that Forge, our app development platform for Atlassian cloud apps, is now generally available. You can rely on Forge's hosted infrastructure, storage, and FaaS functions to support apps in production; all of which are backed by Atlassian's operational readiness. Learn more about building the next Marketplace hit with Forge.
Note that some functionality in Forge remains in beta while we're still making changes that may break your apps. Learn more about the current functionality in beta.
On 15 September 2026, the jiraServiceManagement:queuePage Forge extension point will stop loading on Customer Service Management (CSM) spaces in Jira.
What's changing
Apps using this module on CSM queues will stop rendering on that surface from the deprecation date. The module will continue to function as expected on standard Jira Service Management (JSM) spaces.
What you need to do
You should migrate to the dedicated replacement extension point, customerServiceManagement:queuePage, which is generally available from 15 June 2026.
Replace jiraServiceManagement:queuePage with customerServiceManagement:queuePage in your app's manifest.yml.
Review the manifest reference for the new module.
Deploy your changes before the deadline.
Timeline
15 June 2026: customerServiceManagement:queuePage reaches GA.
15 June 2026 – 14 September 2026: Migration window.
15 September 2026: jiraServiceManagement:queuePage stops loading on CSM spaces.
If you cannot migrate in time, please contact Atlassian for case-by-case support.
Migration: replace jiraServiceManagement:queuePage with customerServiceManagement:queuePage in your app's manifest.yml. The new module exposes equivalent functionality on CSM spaces.
Timeline:
15 June 2026 — customerServiceManagement:queuePage reaches GA.
15 June 2026 – 14 September 2026 — migration window.
15 September 2026 — jiraServiceManagement:queuePage stops loading on CSM spaces.
The new customerServiceManagement:queuePage Forge module is generally available from 15 June 2026.
What's changing
This module lets you add a custom item under the Queues section in the left navigation of a Customer Service Management (CSM) space. When clicked, your app renders a full page within the Jira interface.
What you need to do
Review the customerServiceManagement:queuePage manifest reference for configuration details.
If you currently use jiraServiceManagement:queuePage on CSM spaces, you must migrate to this new dedicated extension point.
Related deprecation
As a result of this new dedicated extension point, the existing jiraServiceManagement:queuePage Forge extension point will no longer load on CSM spaces from 15 September 2026. See CHANGE-3175 for migration details.
The new customerServiceManagement:requestDetail Forge module is generally available from 15 June 2026.
What's changing
This module lets you add a panel to the request details screen of a Customer Service Management (CSM) support site. Your app's content is displayed below the Conversation history section on the request details page.
What you need to do
Refer to the customerServiceManagement:requestDetail manifest reference for technical configuration and schema details.
Forge apps can now make API calls on behalf of JSM portal-only users. JSM portal-only users (also called customer account users) are customers who access your service desk through the JSM portal but don't have a full Atlassian account.
With this release, asUser() in Forge now works for customer accounts from both the frontend and the backend.
Apps can now perform actions like creating customer requests, reading comments, and updating tickets in the context of the portal-only user, with full permission checks preserved, exactly as they would be for a standard Atlassian account user.
The changes will be reflected upon redeployment of the Forge app.
KB Article search & view endpoints are now supported for Forge apps for customer account users / unlicensed users
We have added Forge OAuthScope support for the endpoint /rest/servicedeskapi/knowledgebase/article/view/{pageId}. If your manifest has
1
2
3
4
permissions:
scopes:
- read:servicedesk-request
- read:knowledgebase:jira-service-managementthen Forge apps should fetch contents of the article(page) for portal customers.
What's changing
We've added new error handling documentation for Forge Realtime. This covers expected error patterns and recommended handling strategies for all realtime operations:
publish
subscribe
signRealtimeToken
The new guidance includes details on:
Rate limit errors: How to identify and respond when your app exceeds Realtime service limits.
Token pre-validation errors: Troubleshooting issues during the token signing and validation process.
Common failures: A catalog of other frequent error scenarios with actionable recovery steps.
What you need to do
Review the new https://developer.atlassian.com/platform/forge/realtime/error-handling-for-realtime-methods/ documentation to ensure your app gracefully handles these scenarios. We recommend implementing the suggested retry logic and validation checks to improve your app's reliability.
A new Rovo-powered AI chat widget is now available for all logged-in users on https://developer.atlassian.com. Located in the bottom right corner of developer documentation pages, this assistant can answer questions, surface relevant docs, and help you build on the platform faster.
Key features include:
Contextual answers: The chat understands the context of your question and provides relevant answers rather than generic search results.
Developer-focused knowledge: Trained on Atlassian developer documentation, the assistant understands Forge, REST APIs, Marketplace, and platform concepts.
Natural language understanding: Ask questions in plain language; no need to know exact documentation titles or keywords.
Follow-up questions: Continue a conversation naturally with follow-up questions to drill deeper into a topic.
Source transparency: The widget displays the specific documentation and support sources used to generate each answer.
Conversation history: You can access and review your previous interactions for up to 28 days.
Independent operation: The assistant works independently of your product licenses and organization-level AI settings.
For more details on how the assistant handles data and what sources it uses, see the Atlassian developer AI chat documentation.
You can now use Jira entity properties (issue, project, and user) to filter Forge trigger events and include them in the delivered event payload. This allows your app to process only relevant changes and reduces unnecessary executions.
What’s changing
Entity property filtering: You can now define expressions in your manifest.yml that use Jira entity properties to filter events before they trigger your app.
Payload enrichment: Relevant entity properties can now be included directly in the event payload, eliminating the need for additional REST API calls to fetch this data.
What you need to do
Update your manifest.yml to include expression filters using entity properties.
Update your event handlers to utilize the enriched payload data.
For more information, see the Forge Trigger module reference.
Customer-managed egress and remotes in Forge is now available in Preview. This feature enables apps to dynamically declare egress and remotes post-installation, giving site administrators control over where apps can send and receive data.
Apps using customer-managed egress and remotes can now be used in production environments.
The ability to use Forge Dynamic Modules is now available in Preview. These modules are available across Jira, Confluence and JSM. Please see our documentation here for more information.
Thank you to everyone who engaged in our EAP and provided valuable feedback!
Following on from our previous announcement, customer messaging for Marketplace apps is now enabled on tenants enrolled in the Developer Canary Program. This messaging is scoped only to the Connected Apps admin page and in-app messaging will not be available. Only DCP-enrolled tenants are affected, production instances are unchanged.
This gives enrolled partners and developers early visibility into the admin-facing messaging customers will see before it starts to broadly go live in production later, starting 6th July. Please use this window to test and prepare.
The messaging covers:
Connected Apps page: Admins will see a message on installed apps utilising Connect components indicating the platform is approaching end of support and prompting them to check their app. This messaging will change to be app-specific once you have adopted the connectToForgeMigration module and declared your intent to migrate.
What you need to do:
Review the messaging on your canary tenants to understand what your customers will see.
Adopt the connectToForgeMigration module in your Forge manifest to provide app-specific migration guidance directly within the customer-facing notices.
If you are not yet enrolled in DCP and would like to preview, see the https://developer.atlassian.com/cloud/jira/platform/developer-canary-program/.
A changelog notice will be issued at least one week prior to this change going live to production instances
Rollout of this messaging will be staged across 3 months, starting with apps who have not declared any intent to migrate.
The Forge platform will be undergoing maintenance in FedRAMP production on June 7, 2026 between 11am - 12am UTC.
There should be a few minutes of downtime within this window. During this time, the following capabilities will not be intermittently available:
Creating, updating, or deleting apps
Deploying apps
Installing, uninstalling, upgrading apps
App invocations will continue to work for existing users of the apps. However, new customers may be unable to use apps as consent process will be impacted during this interval as well.
Forge custom fields and Forge custom field types are now displayed as columns in Jira's https://support.atlassian.com/jira-software-cloud/docs/what-is-the-list-view/ (New Issue Navigator).
What's new:
Forge custom fields appear as selectable columns in the List View.
When a formatter is defined in your manifest, the List View evaluates and displays the formatted value instead of the raw stored value.
Limitations:
Read-only — Inline editing of Forge custom field values is not available in the List View. Users must open the issue to edit.
No Custom UI / UI Kit rendering — The view.resource component is not rendered; field values are displayed as text only.
Read more here :
Forge apps using the UI Modifications API configured for Issue View will now have their modifications applied when issues are opened via ViewIssueModal (for example, from global pages, admin pages, or custom UI panels).
Previously, UI Modifications were not loaded silently in this context. This applies to all supported project types, and requires no changes to your app's manifest or code
For more details, see the Jira UI modifications documentation.
The Developer Console’s invocation error metrics and alerts screen now features a new Missing scopes error type for Product Events and Agent Connector invocations. This makes it easier to identify and troubleshoot invocation errors caused by insufficient permissions, which frequently occur during app-to-app validation.
You can now:
View Missing scopes as a distinct category in the Invocation errors chart.
Use Missing scopes as a filter when creating Advanced alerts to stay informed about permission-related failures.
What you need to do
No action is required to enable this feature. If your app experiences invocation failures due to missing scopes, they will now be automatically categorized and surfaced in the Developer Console.
Forge embedded macros have reached general availability (GA). This feature allows Forge bodied macro apps to render other embedded Forge macro apps, enabling more complex and integrated content experiences within Confluence.
What’s changing
You can now use the following methods to render embedded Forge macro apps within a bodied macro:
UI Kit: Use the AdfRenderer component.
Custom UI: Use the view.createAdfRendererIframeProps method from the @forge/bridge package.
What you need to do
To start using embedded macros in your bodied macro apps:
Ensure you are using the latest version of @forge/bridge for Custom UI apps.
Implement the AdfRenderer (UI Kit) or createAdfRendererIframeProps (Custom UI) in your macro's rendering logic.
Refer to the updated Forge rich-text bodied macros documentation for implementation details and examples.
Rate this page: