You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Integrating Slack with Plane allows your team to streamline communication and stay updated on your projects, directly from within Slack. Whether you're syncing threads, receiving updates, or collaborating in real-time, this integration brings the power of Slack and Plane together for a more connected workflow.
16
-
15
+
Plane's Slack integration brings your project management directly into your team's communication flow. Create work items from conversations, get notified about updates, interact with Plane AI, and keep everyone aligned — all without leaving Slack.
17
16
This guide will walk you through how to set up and connect your Slack account to Plane.
18
17
19
18
## Set up Slack integration
@@ -31,21 +30,20 @@ Follow the steps below to complete the setup:
31
30
32
31
To get started, you need to connect your Slack workspace to Plane.
1. Navigate to [Workspace Settings](/core-concepts/workspaces/overview#access-workspace-settings) in Plane.
37
-
2. On the right pane, select **Integrations**.
38
-
3. Find the **Slack** integration and click **Configure**.
39
-
4. Click the **Install** button. This will redirect you to Slack’s authentication page. Slack will ask you to review the permissions it needs to integrate with Plane. Make sure to allow them.
40
-
5. After allowing permissions, you’ll be redirected back to Plane. You should now see that your Slack workspace is successfully connected.
35
+
1. Navigate to **Workspace Settings** → **Integrations** in Plane.
36
+
2. Find the **Slack** integration and click **Configure**.
37
+
3. Click the **Install** button. This will redirect you to Slack’s authentication page. Slack will ask you to review the permissions it needs to integrate with Plane. Make sure to allow them.
38
+
4. After allowing permissions, you’ll be redirected back to Plane. You should now see that your Slack workspace is successfully connected.
41
39
42
-
That's it! Your Slack workspace is now integrated with Plane.
40
+
Your workspace is now integrated. Team members can start using Plane shortcuts in Slack channels.
43
41
44
42
### Connect personal Slack account
45
43
46
44
For a more personalized experience, you can connect your personal Slack account. This is particularly useful for features like Thread Sync. When Thread Sync is enabled, any messages posted to a work item will be sent back to Slack. If you're connected, it will show your name as the sender. If you're not connected, the message will appear as coming from the Plane Bot or the name of your Slack bot.
47
45
48
-
46
+
49
47
50
48
#### From Workspace settings
51
49
@@ -66,8 +64,8 @@ If you don’t have admin access, you can still connect your personal Slack acco
66
64
1. Head to the [Profile settings](/core-concepts/account/settings) page in Plane.
67
65
2. Select the **Connections** tab on the sidebar.
68
66
3. In the dropdown menu, select the Plane workspace you want to connect your personal account to.
69
-
70
-
67
+
68
+
71
69
4. Click **Connect** in the Slack section, which will redirect you to Slack to complete the connection.
72
70
:::info
73
71
If your workspace doesn’t have Slack integration enabled, you won’t be able to connect your personal account. In this case, contact your Workspace Admin.
@@ -80,42 +78,52 @@ Now that you’ve connected Slack to Plane, let’s explore what you can do with
80
78
81
79
### Create work items from Slack
82
80
81
+
Turn conversations into trackable work without switching apps.
82
+
83
83
There are two easy ways to create issues from Slack, depending on your workflow: using the message shortcut or the `/plane` command. Any updates in Plane to fields like State, Assignee, or others will automatically reflect in the linked Slack thread.
84
84
85
85
#### Message shortcut
86
86
87
-
If a message sparks an action item, turn it into a Plane workitem in just a few clicks:
3. A modal will open where you can select the project.
94
-
4. Add a title and description (the original message is pre-filled).
95
-
5. Assign Labels, State, Priority, and Assignee.
96
-
6. Enable Thread Sync (optional). When enabled, Thread Sync keeps your conversation and Plane work item comments in sync. Anything you say in the Slack thread appears in the Plane work item comments, and vice versa. It’s the easiest way to keep everyone aligned without repeating updates in two places.
97
-
7. Once you hit **Create Issue**, the work item gets added to the Backlog of your selected project, and a preview is posted in the Slack thread so everyone knows it's being tracked.
-**Project** - Select which Plane project receives the work item.
97
+
-**Add as** - Choose between:
98
+
-**Work Item** - Standard task in your project.
99
+
-**Intake** - Sends to your project's intake queue for triage.
100
+
-**Work Item Type** - Select from your project's work item types. This will also show mandatory custom properties associated with the work item type.
101
+
5. Add a title and description. The original Slack message text auto-fills as the description.
102
+
6. Assign Labels, State, Priority, and Assignees.
103
+
7. Turn on Thread Sync (optional). When enabled, Thread Sync keeps your conversation and Plane work item comments in sync. Anything you say in the Slack thread appears in the Plane work item comments, and vice versa. It’s the easiest way to keep everyone aligned without repeating updates in two places.
104
+
8. Click **Create** and the work item appears in Plane, with a confirmation posted in the Slack thread.
98
105
99
106
#### `/plane` command
100
107
101
108
The `/plane` command lets you create a work item on the fly, without referencing a specific message.
2. A pop-up will appear where you can fill in work item details—title, description, state, labels, priority, and more.
107
-
3. Click **Submit**, and the work item is instantly created in Plane.
113
+
2. Press Enter to open the creation modal.
114
+
3. Fill in the same fields as the message shortcut.
115
+
4. Click **Create**.
108
116
109
117
This is great for when an idea or task comes up mid-conversation—you can create the work item in just a couple of clicks without breaking your flow.
110
118
111
-
### Link work items to Slack threads
119
+
### Link existing work items to Slack threads
112
120
113
121
If a Plane work item already exists, and you want to connect it to a Slack thread (for updates, visibility, or comments), just use the **Link Work Item** shortcut. Here’s how:
114
122
115
123
1. Hover over the relevant Slack message or thread.
116
-
2. Click the three-dot menu adn select **Link Work Item**.
124
+
2. Click the three-dot menu and select **Link Work Item**.
117
125
118
-
126
+
119
127
3. In the modal, search for the work item by title or ID.
120
128
4. Select the right work item and hit **Link**.
121
129
@@ -147,7 +155,7 @@ Once you add Plane to your private channel, you can use all the same features yo
147
155
148
156
Stay on top of project updates without switching tabs. You can now link each Plane project to a default Slack channel to receive notifications whenever new work items are created.
149
157
150
-
158
+
151
159
152
160
To configure this:
153
161
@@ -160,6 +168,58 @@ To configure this:
160
168
161
169
Once set, Plane will automatically post updates to the selected Slack channel every time a new work item is created in that project keeping your team informed and your workflows connected.
162
170
171
+
### Get DM notifications
172
+
173
+
Stay informed about work items that need your attention through Slack DMs.
174
+
175
+
#### Enable DM notifications
176
+
177
+
1. Go to **Profile Settings** → **Connections**.
178
+
2. Find the Slack section for your connected workspace.
179
+
3. Enable **Get notified in Slack DMs for important updates, reminders, and alerts just for you**.
-Change its state (e.g., move it to "In Progress").
180
-
-Add a comment.
238
+
-**View in Plane** - Opens the work item in Plane
239
+
-**Assign to me** - Instantly assigns you to the work item
240
+
-**Update Work Item** - Opens a modal to change priority, labels, state, or assignees
181
241
182
242
This makes it easy to stay updated and take action without leaving Slack.
183
243
184
-
## Privacy and data handling
244
+
## Privacy and permissions
185
245
186
246
When you use the Slack integration with Plane, we take your privacy seriously. The integration only accesses the minimum permissions necessary to function properly, and we handle your data in accordance with our [Privacy Policy](https://plane.so/legals/privacy-policy).
187
247
@@ -192,6 +252,4 @@ The integration may collect and process:
192
252
193
253
All data is encrypted in transit and at rest, and you can disconnect the integration at any time from your [Workspace Settings](/core-concepts/workspaces/overview#access-workspace-settings) or [Profile settings](/core-concepts/account/settings).
194
254
195
-
---
196
-
197
-
By using these features, you can reduce context-switching and manage Plane work items directly from Slack—keeping your workflow smooth and efficient.
0 commit comments