Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

Upgrade the Confluence Cloud + Slack integration to granular permissions

We are updating the Confluence Cloud + Slack Integration to use Slack’s shiny new granular permissions. This allows our app to ask for only the permissions it needs and makes it more reliable. For this update, action is required by Slack admins of workspaces using the Confluence Cloud + Slack integration.


What are granular permissions?

Slack has required that all integration apps update to support their new granular permissions model. Before granular permissions, “classic” apps using a bot token received a broad set of scopes, and developers did not have a way to pick and choose the information their app actually accessed. Now, with granular permissions, developers can specify only the exact, minimal scopes needed for their app to function

Apps using granular permissions are also more reliable as they can remain in a workspace even if the app installer leaves the company, reducing unwanted interruptions. Furthermore, granular permissions provide a wider set of scopes that we as developers can cherry-pick in the future to add cool new features that wouldn’t be possible with classic apps.


What do Slack admins need to do?

Slack Admins are required to upgrade permissions for the Confluence Cloud + Slack integration in their workspaces by January 28, 2021, when the old version of the integration will no longer work. Upgrading is super simple and should only take a minute.


What happens if an admin doesn’t upgrade?

We strongly recommend upgrading well before the deadline once the upgrade becomes available on January 13, 2021. Until an admin upgrades the app:

  1. New users will not be able to log in to the app and access its features

  2. Any new features will not be available to your team

  3. On January 28, 2021, the old version of the app will no longer work, and Slack admins will continue to receive reminders to upgrade. Upgrading will immediately make the app work as expected.


How does a Slack admin upgrade the integration?

1. A few days before the upgrade becomes available, admins receive a message letting them know that they will need to upgrade the app soon. No action is yet required at this point, it is just a heads up.

Confluence Pre Announcement.png

2. On January 13, 2021, the upgrade will actually become available and admins will receive a message with a button to "Update permissions" which will begin the simple upgrade process.

confluence gbp update permissions.png

3. Clicking “Update permissions” will let admins view and accept the new granular permissions. If you are a member of multiple Slack workspaces, make sure you are upgrading for the correct workspace in the Workspace switcher in the top right corner of the page.

Screen Shot 2020-12-08 at 1.25.15 PM.png

4. Click “Allow” and you’re all done! Your Confluence Cloud + Slack integration is now on Slack’s shiny new granular permissions 🎉 

You can disregard past update messages as you are on the most up-to-date and supported version of the app. New members will be able to log in, and you will have access to all new future features. 


Will upgrading the app cause any interruptions with the app or our Slack experience?

No. Upgrading will not negatively impact your app or Slack experience. There will be no interruptions. Everything will still continue to work as normal as you upgrade and after you upgrade.


Hello, I still have not received my message to update permissions, is this still planning on going out today? Thank you!

@Sarah Henzel thank you for commenting! We are progressively messaging all admins with the Confluence Cloud Slack app, you should receive it some time soon, either today or tomorrow.

When I click on the "Update Permissions" tab I get this error:  image.png

Hi there,


I haven't received the update permission message, is there way to trigger this manually?

Like Sarah Henzel likes this

@Mark Anderson If you try again, are you able to successfully upgrade?

@JeongWoo Park It's possible that you may not be an admin of your Slack workspace, in that case you will not have received a message. You can trigger the update manually by clicking this installation URL:

Like JeongWoo Park likes this

@David Michelson Yes It worked once I logged out of the Slack admin page and clicked on the Update Now link.



Thanks, that link worked!


Log in or Sign up to comment
Community showcase
Published in Confluence

An update on Confluence Cloud customer feedback – June 2022

Hi everyone, We’re always looking at how to improve Confluence and customer feedback plays an important role in making sure we're investing in the areas that will bring the most value to the most c...

142 views 1 3
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you