Confluence Cloud for Slack

Still need help?

The Atlassian Community is here for you.

Ask the community

The Confluence Cloud app for Slack lets your team:

  • Set up notifications in your Slack channels about changes in 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

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.

For security reasons, Slack notifications won't be sent for Confluence pages with both viewing and editing restricted

To subscribe to a page or post: 

  1. Open the page that you would like to create a subscription for.
  2. Click Actions menu icon > Slack Notifications.
  3. Click 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. Click Space settings > Integrations > Slack Notifications
  3. Click 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. 

To create a personal subscription: 

You can have notifications sent to you by direct message from the Confluence bot.

  1. Select Confluence in the Apps section of your Slack's left sidebar.
  2. Type /confluence connect <page-or-space-url>.

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. Click Actions menu icon > Slack Notifications.
  3. Click  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!

Site admins can disable the app for their entire Confluence Cloud site with these steps:

  1. Go to Settings > Manage add-ons.
  2. Select System from the drop-down.

  3. Select Slack Notifications from the displayed apps and click Configure.
  4. 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 a site or space-level will delete any existing Slack notification subscriptions.

Need support? 

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

Last modified on Oct 5, 2018

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.