Automatically post changelog updates to your Slack channels when you publish new posts.

Slack Integration

Automatically notify your team when you publish changelog updates by posting directly to your Slack channels.

Prerequisites

Before you begin, make sure you have:

PRO Plan: Slack integration is only available on the PRO plan
Slack Workspace: Member or admin access to authorize the Changelogy app
Organization: At least one changelog page created in Changelogy

Setup Guide

Step 1: Connect Your Slack Workspace

Navigate to your organization's integrations page
Go to Settings → Integrations → Slack
Click the "Add to Slack" button
You'll be redirected to Slack's authorization page
Select the workspace you want to connect
Review the permissions and click "Allow"
You'll be redirected back to Changelogy with a success message

Required Permissions:

The Changelogy Slack app will request the following permissions:

chat:write — Post messages to channels
chat:write.public — Post to public channels without joining
channels:read — View basic channel information

These permissions allow Changelogy to automatically post your changelog updates to your chosen Slack channels.

Note: Slack integration requires a PRO subscription. If you don't have a PRO plan, you'll be prompted to upgrade.

Configure Channel Mappings

After connecting Slack, configure which changelog pages post to which Slack channels.

Step 1: Get Channel IDs

In Slack:

Right-click any channel name
Select View channel details
Scroll down and click Copy Channel ID

Step 2: Map Pages to Channels

Navigate to your organization in Changelogy
Click Slack Integration in the sidebar
For each page, enter:
- Slack Channel ID (e.g., C01234567)
- Channel Name (e.g., general)
Toggle Enabled to activate notifications
Click Save

Step 3: Configure Multiple Pages

You can map different pages to different channels:

Product Updates → #product-announcements
Bug Fixes → #engineering
API Changes → #developers

Each page can only post to one channel, but multiple pages can post to the same channel.

Testing Your Integration

Send a Test Post

Create a new changelog post or edit an existing draft
Set the status to Published
Click Publish
Check your configured Slack channel

You should see a message like this:

📢 New Changelog Update

Your Post Title

Post content preview goes here...

Posted to Product Updates | Dec 5, 2025

[View Full Changelog]

What Gets Posted?

Slack messages include:

Post title
Content preview (first 200 characters)
Page name and publish date
Link to view the full changelog

Troubleshooting

Messages not appearing in Slack?

Check these common issues:

Verify Slack integration is Enabled in your organization settings
Ensure the page has a channel mapping configured
Confirm the channel mapping is Enabled
Check that your Slack bot has permission to post to the channel
Make sure you published (not drafted) the post

"Channel not found" error?

Double-check the channel ID is correct
Verify your bot is a member of the channel (or use chat:write.public scope for public channels)
Make sure the channel exists and hasn't been archived