This page includes release notes and updates for Confluence Cloud app developers. Use this page to keep track of upcoming changes, deprecation notices, new features, and feature updates from Confluence Cloud.
For updates about changes to the Forge platform, see the Forge changelog in the Forge documentation.
You can also ask questions and learn from other Confluence Cloud developers on the Atlassian Developer Community.
As announced in July 2025, a number of glyphs for the Icon component will now be removed.
We have now postponed enforcement of the new point-based rate limits for Jira and Confluence REST APIs to March 2, 2026.
What's changing
Enforcement of point-based rate limits has been postponed from February 2, 2026 to March 2, 2026.
As previously announced in CHANGE-2958, the new rate limiting system will now be enforced starting March 2, 2026.
What you need to know
No action is required at this time.
Continue to monitor the changelogs for further announcements and updates.
For more information about rate limiting, see:
We’ve added a new query parameter include-public-link to the v2 Get page by ID API endpoint that allows for optional fetching of Public Link data related to the given page.
By default, this property will not be included in the response unless specified.
Forge apps can now run for guest and anonymous users in Confluence. This means your apps will work on publicly accessible pages and for users who don't have a full Confluence license.
By default, Forge apps only run for licensed Confluence users. To allow your app to serve guest and anonymous users, add the unlicensedAccess property to your modules in manifest.yml.
Confluence has two types of unlicensed users that Forge apps can serve:
User type | Manifest value | Description |
|---|---|---|
Guest |
| Users with an Atlassian account who have limited access to a single Confluence space. Guests are authenticated but don't consume a paid license. |
Anonymous |
| Users who are not logged in. This includes anyone on the internet viewing public content. |
The following Confluence Forge modules support guest and anonymous access:
Add the unlicensedAccess property to your module in manifest.yml:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
modules:
macro:
- key: my-macro
resource: main
resolver:
function: resolver
title: My Confluence Macro
unlicensedAccess:
- unlicensed # Allow guest users
- anonymous # Allow anonymous users
function:
- key: resolver
handler: index.handler
resources:
- key: main
path: static/hello-world/build
app:
id: ari:cloud:ecosystem::app/your-app-idThe cleanHistory field will be deprecated on June 30, 2026. As part of this deprecation, we’re changing the cleanHistory field in Content Redaction API requests from required to optional.
Existing implementations that include the cleanHistory field will continue to function during the deprecation period. However, we recommend that you start implementing the following changes for any apps impacted by this change:
Update your API client to treat cleanHistory as an optional field.
Use the versionNumber field to specify the historical version you want to redact.
Remove the cleanHistory parameter from your redaction requests.
The following UI Kit components are now generally available:
Comment, which displays discussions and user feedback.
Pressable, which is a primitive for building custom buttons.
CommentEditor, provides a contained comment editor UI with a simple toolbar.
ChromelessEditor, provides a simple text editor that does not have a toolbar.
For more information, see the component documentation.
To access these components, you will need to update your app to the latest version of @forge/react. In the terminal of your project directory, run:
npm install --save @forge/react@latest
We are changing the way we measure rate limits across Jira and Confluence Cloud for all free and paid apps. A phased enforcement of the new rate limits will begin on February 2nd, 2026.
When the phased enforcement begins, API requests then start consuming points based on the work they perform, such as the data (objects) returned or operations triggered. Each request starts at a base point of 1 point, with additional points for each object involved.
We’re also introducing two types of app-level quotas (tiers) that apply consistently across the Atlassian platform for all apps.
It’s important to note that the vast majority of free and paid apps do not require any changes and are already operating within these limits. We’ve also reviewed usage and upgraded eligible apps to a higher tier where appropriate.
If your app requires additional capacity in the future, rest assured we will provide clear pathways to request for this. For more information, please refer to the following documentation:
Here’s how the points-based limiting works.
Points-based measurement | API requests consume points based on the work they perform, such as the data (objects) returned or operations triggered. Each request starts at a base point of 1 point, with additional points for each object involved. |
|---|---|
Two-tier quota system | Apps start in Tier 1 - Global Pool, with a shared hourly quota across all tenants. Apps with consistently high or concentrated usage may qualify for Tier-2 Per‑Tenant Pool, which provides dedicated hourly quotas per tenant. |
Points-based costs | Different objects have different point values:
|
Hourly quotas by edition | Quotas reset at the top of each UTC hour. Per-tenant pool quotas vary by customer edition and number of users. |
Here are the benefits for you:
Fairer limits, heavy operations use more quota than simple ones.
This provides more predictable API usage planning and scaling.
This gives you better visibility through detailed rate limit headers.
The vast majority of free and paid apps already operating well within the new limits.
Some updates you need to know:
Updates to the RateLimit-Reason header with new reasons:
jira-quota-global-based, which refers to the Global pool limits being breached in Jira
jira-quota-tenant-based, which refers to the Per Tenant pool limits being breached in Jira
confluence-quota-global-based, which refers to the Global pool limits being breached in Confluence
confluence-quota-tenant-based, which refers to the Per Tenant pool limits being breached in Confluence
Updates to the developer documentation regarding rate limit quotas for different tiers in both Jira and Confluence
Planned updates to the developer console to show which tier your app belongs to ahead of the enforcement
Following the Preview release, the Forge Automation Actions is now generally available. The Automation action module allows you to extend the Automation Platform and add new Forge-based actions to your app. With this release Forge Actions can now output smart values, enabling seamless data flow and dynamic automation.
For more information, see the Forge Automation Action module documentation.
We've added a new optional hidden property to the Forge macro module. When you set "hidden": true in your macro definition, the macro will be hidden from the quick insert menu and macro browser. This prevents users from searching for and inserting the macro into new pages, but existing macros will continue to render as usual.
For more information, see Macro.
You can now configure the Forge Content Byline Item module to open in a modal instead of a pop-up. The modal supports both standard and full-screen sizes, giving you more flexibility in how your content is displayed. This can be done by using viewportContainer: modal in your manifest.
For more information, see our documentation.
Forge platform will be undergoing maintenance in commercial production on November 23, 2025 for approximately 1 minute between 5:30-6:30am 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.
Following our prior deprecation notice, requests to the following internal API endpoints will now fail.
/download/attachments/{id}/crash-scraper/files/{id}
/download/attachments/{id}/{id}/customer-card-payment-rest
/download/attachments/{id}/{id}
/download/attachments/{id}/{id}/{id}
/download/download/attachments/{id}/{id}
/download/attachments/{id}/{id}/{id}/{id}
/download/attachments/{id}/attachments/{id}/{id}/{id}
/download/attachments/{id}/{id}/image
/download/all_attachments
Learn more about why we deprecated these internal endpoints & alternatives in our prior deprecation notice.
The sidebar will now span the full height of your Atlassian app, making it easier to find and interact with. Starting late November 2025, this update will roll out to all customers who haven’t customized the look and feel of their sites. This change won’t affect the width and height of your Forge and Connect apps.
Along with this, we’re introducing a few improvements to sidebar interactions:
Double-click to collapse: When expanded, double-click the button to quickly collapse the sidebar.
Global shortcut: Use Ctrl + [ to expand or collapse the sidebar at any time.
Helpful tooltips: Tooltips will appear to guide you through the interaction.
For sites with customized look and feel, the full-height sidebar can disrupt intentional design choices, such as:
Custom logos and titles
Favicons
Navigation colors
Dark and light mode settings
Because of this, the sites with customized look and feel won’t receive the update just yet.
For the sites without customized look and feel, we’re opening up the opportunity on Nov 21, 2025 to let you use this feature early and test it with your apps. If you’re interested, please sign up here with your site details.
As part of our new design language, the refreshed colors and components in the Atlassian Design System (that first launched in products at Team '25) are now officially in GA. Also included is a further tweak to accent token colors in hover/pressed states to improve accessibility.
What you need to do if you are using Forge Custom UI or Atlassian Connect:
Bump @atlaskit/tokens + relevant component packages to the latest version to align your app's look and feel with Atlassian apps.
What you need to do if you are using Forge UI Kit or Forge UI Kit 2:
Nothing! You should have the newest components by default.
Visual changes to Atlassian components and tokens:
New base color tokens: We've introduced new color stops across our base color ramps, namely 250 and 850, to support better hover/pressed state contrast and improve WCAG AA accessibility.
The GET methods of the Key-Value Store and Custom Entity Store SDKs can now return optional metadata fields, namely:
createdAt
updatedAt
Rate this page: