This page includes release notes and updates for Compass app developers. Use this page to keep track of new features, upcoming changes and deprecation notices about the Compass developer platform and GraphQL API.
If you're new to building apps for Compass, check out Get started building Compass apps to begin your journey.
For updates about changes to the Forge platform, see the Forge changelog in the Forge documentation.
You may also be interested in the What's New blog for Atlassian Cloud where we announce new product features and other major changes affecting all users of Compass.
Forge Automation Actions is now available in Preview. This feature allows you to extend the Automation Platform and add new Forge-based actions to your app. During Preview, the Automation Actions in your app can be used in production environments.
For more information, see the Forge Automation Action documentation and share your feedback to help us improve
Forge platform will be undergoing maintenance in commercial production on October 12, 2025 for approximately 1 minute between 3-4am UTC
During this interval, below capabilities will not be available intermittently:
Create/update/delete apps
Deploy apps
Install/uninstall/upgrade apps
App invocations will continue to work for existing users of the apps. However, new customers might not be able to use apps as consent process will be impacted during this interval as well.
Forge platform will be undergoing maintenance:
in FedRAMP production on September 21, 2025 between 5-6am UTC
in commercial production on September 28, 2025 between 5-6am UTC
During this interval, below capabilities will not be available intermittently:
Create/update/delete apps
Deploy apps
Install/uninstall/upgrade apps
App invocations will continue to work for existing users of the apps. However, new customers might not be able to use apps as consent process will be impacted during this interval as well.
The allow-popups attribute of the sandbox directive (content security policy) is now supported in Forge Custom UI and UI Kit apps when using * as your client egress configuration. This enables external content (such as those from 3rd party integrations) to open properly in new tabs instead of being blocked by browser security restrictions.
With this enhancement, external content will open in a new browser tab while keeping your Forge app running.
For more information, see the valid domain formats documentation.
We are announcing the deprecation of the following Compass GraphQL API fields:
createComponentFromTemplate
createWebhook
userDefinedParameters
updateUserDefinedParameters
These APIs will be removed on December 1, 2025.
Why is this deprecation necessary? The Compass Templates feature is being removed. See the community post for more details.
We're deprecating the createComponentScorecardJiraIssue, updateComponentScorecardJiraIssue, and activeIssues fields in Compass. These fields will be replaced by createComponentScorecardWorkItem, updateComponentScorecardWorkItem, and activeWorkItems.
This change will take effect on October 1, 2025.
Why is this deprecation necessary? The new fields provide enhanced functionality and better integration with Compass.
What is changing? Developers should transition to using the new fields: createComponentScorecardWorkItem, updateComponentScorecardWorkItem, and activeWorkItems.
Dates and rollout: The deprecation will be effective from October 1, 2025.
For more information, see the Compass API documentation https://developer.atlassian.com/cloud/compass/graphql/#overview.
The following UI Kit components are now generally available:
https://developer.atlassian.com/platform/forge/ui-kit/components/adf-renderer/
https://developer.atlassian.com/platform/forge/ui-kit/components/calendar/
https://developer.atlassian.com/platform/forge/ui-kit/components/checkbox-group/
https://developer.atlassian.com/platform/forge/ui-kit/components/empty-state/
https://developer.atlassian.com/platform/forge/ui-kit/components/inline-edit/
https://developer.atlassian.com/platform/forge/ui-kit/components/list/
https://developer.atlassian.com/platform/forge/ui-kit/components/popup/
https://developer.atlassian.com/platform/forge/ui-kit/components/time-picker/
No code changes are required. These components will now follow the 6 month deprecation period if any breaking changes were to be made.
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.
The scorecardScore field on CompassScorecard has been deprecated. Use the score field on CompassScorecardAppliedToComponentsEdge instead.
The CompassScorecardAppliedToComponentsEdge field is part of CompassScorecardAppliedToComponentsConnection, available from appliedToComponents on CompassScorecard.
The scorecardScore field on CompassComponent has been deprecated. Use the score field on CompassComponentHasScorecardsAppliedEdge instead.
The CompassComponentHasScorecardsAppliedEdge field is part of CompassComponentHasScorecardsAppliedConnection, available from appliedScorecards on CompassComponent.
The scorecardScores field on CompassComponent has been deprecated. Use the score field on CompassComponentHasScorecardsAppliedEdge instead.
The CompassComponentHasScorecardsAppliedEdge field is part of CompassComponentHasScorecardsAppliedConnection, available from appliedScorecards on CompassComponent.
The scorecardScore field on CompassComponentHasScorecardsAppliedEdge has been deprecated. Use the score field on CompassComponentHasScorecardsAppliedEdge instead.
The scorecardCriteriaScore field on CompassScorecardCriteria has been deprecated. Use the criteriaScores field on CompassScorecardScore instead.
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"
}
}Blob objects can now be sent and received via the events API. This enhancement allows for more efficient data handling and transmission within the API.
Update to the latest version of @forge/bridge with npm install --save @forge/bridge@latest
Rate this page: