∙
Cooper
∙
Reading time:
12 min

The Confluence Slack integration connects your Confluence knowledge base to Slack by routing page notifications, personal mentions, and link previews directly into your Slack workspace. Setup takes roughly 15 minutes: install the Atlassian-published app from the Slack App Directory (for Cloud) or from your Confluence admin panel (for Data Center), authenticate both accounts, then configure which spaces send notifications to which channels. Understanding what this integration actually does — and what it doesn't — will save you a frustrating afternoon and set realistic expectations before you begin.
This guide walks through the full setup for both Confluence Cloud and Confluence Data Center, covers the configuration options that actually matter, and is honest about where the Confluence Slack integration hits its ceiling — and what teams use to work around it.
What the Confluence Slack Integration Actually Does
Before touching a single setting, get clear on what you are installing. The Confluence Slack integration is a notification and preview layer. It is not a two-way knowledge sync, and it does not make Confluence searchable in any meaningful sense from inside Slack.
According to a 2024 Atlassian State of Teams report, teams that integrate their documentation tools with communication platforms reduce context-switching by up to 35% — but only when notifications are configured selectively rather than broadly.
The four things it actually does:
Page notifications in Slack channels — when a page is created, updated, or a blog post is published in a Confluence space, a message fires into a designated Slack channel
Personal notifications via Slack DM — mentions, page watches, and task assignments routed to your Slack inbox instead of email
Confluence page previews — when someone pastes a Confluence link into Slack, it unfurls into a preview card showing the page title and excerpt
Slash commands to search Confluence —
/confluence search [query]returns page titles and snippets without leaving Slack
There are also two separate apps, and you need to know which one applies before you start. Confluence Cloud customers install from the Slack App Directory. Confluence Data Center customers install from within the Confluence admin panel. The setup flows are different, and installing the wrong one wastes time.
Before You Start: Prerequisites and Access Requirements
Two admin approvals are required, and you need both before starting:
Confluence admin access — to authorize the app connection on the Confluence side
Slack workspace admin approval — to install a new app into the workspace (some organizations require this to go through IT)
Plan requirements: The Confluence Cloud app works across all Confluence Cloud plans — Free, Standard, Premium, and Enterprise. There is no additional cost for the integration itself, though your Slack plan affects some workflow features. Confluence Data Center requires an active Data Center license. If you are unsure which you have, check your Atlassian billing page.
Before doing anything else, check whether the app is already installed. Go to your Slack App Directory (your-workspace.slack.com/apps), search for "Confluence," and see what comes up. If a team member already installed it, you may just need to configure it — not reinstall from scratch.
How to Install the Confluence Cloud App for Slack
Follow these steps in order. Do not skip the authorization step — it is where most failed installs happen.
Go to the Slack App Directory and search for "Confluence Cloud." Look for the app published by Atlassian. Do not install third-party alternatives unless you have a specific reason to.
Click "Add to Slack" and review the permissions the app requests. It will ask for access to read messages where links are shared (for unfurling previews) and permission to post in channels (for notifications). These are standard and expected — approve them.
Connect your Confluence site by entering your Confluence Cloud URL (usually yourcompany.atlassian.net/wiki) and authenticating with your Atlassian account. This ties your Confluence identity to your Slack identity for personal notifications.
Confirm the integration is live by pasting a Confluence page link into any Slack channel. If the integration is working, the link will unfurl into a preview card within a few seconds. If it does not, check that the app has permission to unfurl links in your Slack workspace settings.
That is the baseline install. Notifications require additional configuration in the next step.
How to Set Up Space Notifications in Slack Channels
Link previews work immediately after install. Space notifications require you to connect specific Confluence spaces to specific Slack channels.
Navigate to the Confluence space you want to connect.
Go to Space Settings → Integrations → Slack. If you do not see this option, use the
/confluenceslash command in Slack and follow the prompts from there.Select the Slack channel where notifications should fire.
Choose which events trigger a notification: page created, page updated, blog post published, comments added. You can enable all four or selectively choose.
Practical tip: Do not connect high-traffic spaces — like your company-wide Engineering or Product spaces — to busy team channels. Notification fatigue sets in fast, and people will either mute the channel or stop reading notifications entirely. Be selective. Connect spaces to channels where that content is genuinely relevant to the people there.
How to Configure Personal Confluence Notifications in Slack
Personal notifications route your individual Confluence activity — mentions, page watches, task assignments — to your Slack DMs instead of your email inbox. For most people, this is the most immediately useful part of the integration.
In Slack, open the Confluence app home (find it in your Apps sidebar).
Go to the Settings tab and connect your personal Confluence account if you have not already done so during install.
Choose which events to route to Slack: mentions, watched page updates, task assignments, and approval requests.
This replaces the Confluence email digest that most people have already unconsciously trained themselves to ignore. The signal-to-noise ratio is better in Slack — assuming you have already done the work of keeping your Slack channels organized.
How to Search Confluence from Slack Using Slash Commands
The slash command is the feature most people do not use — and it is worth understanding both its value and its limits before you depend on it.
Type /confluence search [your query] in any Slack channel or DM. The app returns a list of Confluence page titles and short excerpts matching your search terms. You can click through to open the full page in Confluence.
When this works well: You know roughly what you are looking for. You remember a page title or a keyword from a document you have seen before. The search is fast and keeps you in Slack rather than switching tabs.
When it breaks down: You are looking for an answer, not a page. Someone asks "what is our refund policy for enterprise customers?" — the slash command can surface a page called "Refund Policy" but it cannot tell you the answer. You still have to click through, read the page, and hope the answer is in there. For time-sensitive questions asked in active Slack conversations, that friction is often enough to make the search not worth doing. For a deeper look at how slash commands can be used more broadly to cut repetitive work, it is worth exploring what else they can do.
Confluence Data Center: How the Setup Differs
If your organization runs Confluence Data Center, the setup flow is inverted. You do not start in the Slack App Directory — you start in Confluence.
Log into your Confluence Data Center instance as an admin.
Go to Administration → Application Links → Slack Integration (the exact path varies slightly by version).
Follow the OAuth flow to connect your Slack workspace. You will need to authorize Confluence to post in your workspace — which requires Slack admin approval.
Once connected, space-level notification setup works the same way as Cloud: navigate to a space, go to Space Settings, and configure channel connections.
Key difference from Cloud: The Data Center app supports multiple Slack workspaces simultaneously, which matters for organizations on Slack Enterprise Grid with separate workspaces per business unit. It also means you need to think carefully about which spaces connect to which workspaces.
For self-hosted Data Center instances with firewall restrictions, Atlassian's official documentation covers the specific network configuration requirements for outbound Slack API calls. Do not skip that step — it is the most common reason Data Center installs appear to succeed but silently fail to deliver notifications.
Where the Confluence Slack Integration Falls Short
This is the part the official docs do not say plainly, but anyone who has used this integration for a few months will tell you on Reddit or in a community forum: the integration does not answer questions.
It pushes notifications. It surfaces link previews. It returns page titles in response to slash commands. None of that helps the person who types "anyone know what our SLA is for Tier 2 tickets?" into a Slack channel at 2pm on a Tuesday. That question will get answered by whoever sees it and knows the answer — or it will go unanswered.
The deeper problem is knowledge that never made it into Confluence in the first place. Decisions made in Slack threads. Ad hoc answers given by subject matter experts in DMs. Process clarifications shared during onboarding. None of this is captured by the Confluence integration because none of it lives in Confluence. It lives in Slack, aging out of view.
According to a 2023 McKinsey analysis on knowledge worker productivity, employees spend an average of 19% of their workweek searching for information or tracking down colleagues who have it — a figure that climbs higher in organizations where institutional knowledge is split across disconnected tools.
Teams that rely heavily on Slack for async communication end up with two separate knowledge silos — Confluence for the things people remembered to document, and Slack for everything else. The integration connects those silos at the notification layer. It does nothing about the knowledge that exists only in one of them.
The slash command search compounds this. It requires knowing what to search for. The person who does not know what they are looking for — the new hire, the person in a different department — gets nothing useful back. This is one of Slack's most persistent structural gaps: the platform is excellent at delivering information to people who already know it exists.
Question Base sits inside Slack and automatically captures the answers your team gives in conversations, so institutional knowledge is searchable without anyone having to remember to document it in Confluence.
How Teams Close the Gap Between Confluence and Slack
The teams that get the most out of both tools treat Confluence and Slack as complementary rather than redundant — and they build a bridge between the two that goes beyond the native integration.
Automation via Zapier or Make: Some teams use Zapier workflows to trigger Confluence page creation from specific Slack messages — for example, when a message is starred or pinned, or when a specific emoji reaction is added. This works and is worth setting up for high-value content. The downside is brittleness: it requires someone to remember to trigger the workflow, which means it depends on the same human behavior that caused the knowledge to stay in Slack in the first place.
A dedicated knowledge layer inside Slack: Other teams add a tool that passively captures Q&A and institutional knowledge from Slack conversations without requiring anyone to manually trigger a workflow. The knowledge stays findable in Slack, where the questions are being asked, rather than requiring a round-trip to Confluence.
The goal in both cases is the same: make the answer findable in whichever tool the person is already in. The Confluence Slack integration is a solid foundation — it keeps your Confluence-native knowledge visible in Slack, and it reduces the email noise that buries Confluence notifications. But it is the starting point, not the complete solution. Build from there.
Frequently Asked Questions
How do I connect Confluence to Slack?
For Confluence Cloud, install the Atlassian-published "Confluence Cloud" app from the Slack App Directory, then authenticate with your Atlassian account to link the two platforms. For Confluence Data Center, start from your Confluence admin panel under Administration → Application Links → Slack Integration and follow the OAuth flow. Both setups require admin access on both platforms.
Is the Confluence Slack integration free?
Yes — the native Confluence Slack integration has no additional cost and is available on all Confluence Cloud plans, including Free. Your existing Slack plan governs which Slack-side features (such as advanced workflow automation) are available, but the core notification and preview functionality is included at no extra charge.
Why are my Confluence Slack notifications not working?
The most common causes are: the app lacks permission to post in the target channel, the Confluence space was not explicitly linked to a Slack channel in Space Settings, or — for Data Center — outbound API calls to Slack are blocked by a firewall rule. Check Space Settings → Integrations → Slack to confirm the channel connection is active, and verify the app's posting permissions in your Slack workspace admin panel.
Can I search Confluence from Slack?
Yes, using the slash command /confluence search [query] in any Slack channel or DM. The command returns matching page titles and short excerpts, which you can click through to open in Confluence. It works best when you already know roughly what page you are looking for — it surfaces documents but does not extract direct answers from within them.
What is the difference between the Confluence Cloud and Confluence Data Center Slack apps?
Confluence Cloud customers install the app from the Slack App Directory and manage connections from within Slack or Confluence Space Settings. Confluence Data Center customers configure the integration from the Confluence admin panel, and the Data Center app additionally supports connecting to multiple Slack workspaces simultaneously — which is important for organizations using Slack Enterprise Grid.