Use Slack and Confluence together

The Confluence Cloud app for Slack lets your team:

• Get their Confluence notifications in Slack instead of in email or in Confluence itself

• Set up notifications in Slack channels about changes in specific Confluence spaces, pages (including child pages) and blog posts

• See link previews of pages, blog posts and comments when they're included in Slack messages

• Like pages, reply to comments, and more without leaving Slack

To get started, install the Confluence Cloud app onto your Slack workspace.

Get your Confluence notifications in Slack

To get started, install the Confluence Cloud app onto your Slack workspace.

1. Open Slack

2. Go to the Apps section in the sidebar and hover over the section name to reveal the + to open a direct message

3. Select +

4. Enter "Confluence" in the To field

5. Select Confluence Cloud from the search results

6. Enter the slash command /confluence notify in the Message field

7. Link your Confluence and Slack accounts. If you’ve already linked your accounts, you’ll skip this step.

8. Select Turn on personal notifications to review the sites whose activity you'll be notified about, the type of direct notifications you'll get, and the notifications you'll receive for pages and spaces you are watching.

9. Select Done 

Subscribe Slack channels to Confluence pages and spaces

A subscription links your Confluence space, blog or page to a Slack channel so you can define which events drive notifications for that channel.

To subscribe to a page or post: 

1. Open the page that you would like to create a subscription for.

2. Select   > Slack Notifications.

3. Select Add subscription.

4. Choose the Slack workspace and channel to connect to your page or blog post. If your workspace isn't on the list, select Add new workspace and follow the prompts to connect it.

5. Choose the notifications you want to send to the Slack channel. 

To subscribe to a page in a Slack channel, type /confluence connect <page-url> into the chat window. A subscription added via Slack will by default send notifications for all available event triggers. 

To subscribe to a space: 

Only space admins can add a space subscription within Confluence; however all users can create a space subscription directly from Slack.

1. Open the space that you would like to create a subscription for.

2. Select Space settings > Integrations > Slack Notifications. 

3. Select Add subscription. 

4. Choose the Slack workspace and channel to connect to your space. If your workspace isn't on the list, select Add new workspace, and follow the prompts to connect it. 

5. Choose the notifications you want to send to the Slack channel. 

To subscribe to a space in a Slack channel, type /confluence connect <space-url> into the chat window. A subscription added via Slack will by default send notifications for all available event triggers. 

Edit a subscription

You can edit the types of notifications you receive for a subscription at any time. In Slack, type /confluence list and then click Edit subscription. Follow the below steps to edit subscriptions in Confluence. 

To edit notifications for a page or post in Confluence: 

1. Open the page for which you would like to edit the notifications.

2. Select  > Slack Notifications.

3. Select next to the existing subscription and choose the notifications you want to send to the Slack channel. 

To edit notifications for a space in Confluence: 

Only space admins can modify space subscriptions within Confluence; however, all users can modify space subscriptions directly from Slack.

1. Open the space for which you would like to edit the notifications.

2. Click Space settings > Integrations > Slack Notifications.

3. Click on  next to the existing subscription and update the notifications you want to send to the Slack channel.

Integration tips and tricks

Once you've connected your Confluence Cloud and Slack accounts, you can:

• Share link previews of pages, posts and comments with your team whenever you paste Confluence links in Slack. For security reasons, restricted pages or posts won't display as link previews.

• Use reactions to take action in Confluence when the @confluence bot is invited to a channel:

  • Add 👍 to a notification or link preview for a page, post, or comment to like the item in Confluence

  • Add ⭐ to a notification or link preview for a page or post to add it to your saved for later

• See a full list of app shortcuts in Slack by typing /Confluence help

Disable and enable the app

When you subscribe a Confluence page, post or space to a Slack channel, the Confluence Cloud for Slack app will be automatically installed in your Slack workspace. Alternatively, you can install it in your Slack workspace from here. It's as simple as that!

Confluence admins can disable the app across Confluence Cloud with these steps:

1. Select the wheel icon () in the top-right corner to open Confluence administration.

2. Find Settings in the left-hand navigation.

3. Select Atlassian Marketplace > Manage apps.

4. Select System from the drop-down at the top.

5. Select Slack > Configure.

6. Turn off the toggle to disable the app.

Space admins can also disable the app for pages in their space by navigating to Space settings > Integrations > Slack notifications, and turning off notifications.

Disabling the app at the instance- or space-level will delete any existing Slack notification subscriptions.

Space permission for user "Chat Notification"

Notification will be triggered from spaces only when the "Chat Notification" is added to space permission.

1. Go to Space settings > Space permissions > General.

2. Under individual users make sure user "Chat Notification" is present.

3. If user "Chat Notification" is not present, Manually add user user "Chat Notification" with the following permission

4. Select Save.

Need support? 

This integration is built and maintained by Atlassian. If you need support, visit https://support.atlassian.com or contact support@atlassian.com