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
Copy file name to clipboardExpand all lines: docs/ai/plane-ai-credits.mdx
+7Lines changed: 7 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,6 +10,13 @@ import Tags from "@site/src/components/Tags";
10
10
11
11
Plane AI uses credits as a universal measure of AI processing. This system ensures fair usage while giving teams predictable costs and transparent billing.
12
12
13
+
14
+
:::caution[IMPORTANT]
15
+
AI credits apply only to Plane Cloud.
16
+
17
+
On self-hosted instances, you use your own AI provider [API key](https://developers.plane.so/self-hosting/govern/instance-admin#artificial-intelligence), and all AI usage and costs are managed directly through your provider. Plane does not track, pool, or enforce usage through credits.
18
+
:::
19
+
13
20
## Why credits instead of limits?
14
21
15
22
Traditional AI tools often impose hard limits, like "10 queries per day" or "50 messages per month." These limits create frustration because not all AI tasks are equal. A quick status check shouldn't cost the same as generating a full project plan.
Copy file name to clipboardExpand all lines: docs/core-concepts/projects/manage-project-members.mdx
+40Lines changed: 40 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,6 +4,8 @@ sidebar_label: Manage members
4
4
description: Add members to projects, assign roles, and configure access
5
5
---
6
6
7
+
importTagsfrom"@site/src/components/Tags";
8
+
7
9
# Manage project members
8
10
9
11
Manage who has access to your project and what they can do by adding members and assigning roles.
@@ -124,3 +126,41 @@ Users can become project members in two different ways, and understanding both h
124
126
125
127
Users can have both types of access simultaneously. When this happens, Plane automatically applies whichever role gives them higher permissions. For example, if someone is a `Guest` on your project but joins a linked teamspace, they're automatically upgraded to `Member` access. If they're already an `Admin`, they keep their `Admin` role.
The Enterprise plan is currently only available for self-hosted instances. If you're interested in Enterprise features for your self-hosted deployment, contact [sales@plane.so](mailto:sales@plane.so) for pricing and licensing information.
137
+
:::
138
+
139
+
Track member actions like additions, role changes, and removals to maintain visibility over project access management.
140
+
141
+
**To view member activity:**
142
+
143
+
1. Navigate to **Project Settings → Members & Teamspaces**.
144
+
2. Click **Activity** in the top right corner of the Members section.
145
+
146
+
The activity panel shows recent project member events:
147
+
-**Member additions** - Who added which members to the project and when.
148
+
-**Role changes** - Role updates with who made the change and when.
149
+
-**Member removals** - Who removed members from the project.
150
+
151
+
Each activity entry shows:
152
+
- The action taken
153
+
- Who performed the action
154
+
- When it happened (relative time like "6 days ago" or "3 days ago")
155
+
156
+
This audit trail helps project admins monitor membership changes and verify that access permissions are correct. Activity is retained for project history.
157
+
158
+
## How users join projects
159
+
160
+
Users can become project members in two different ways, and understanding both helps you manage your project team effectively.
161
+
162
+
**Direct project membership** is where you specifically invite users to your project and assign them roles. These members have access only to the projects you've added them to, and you have full control over their permissions.
163
+
164
+
**Teamspace-based membership** happens automatically when your project is linked to a [Teamspace](/core-concepts/workspaces/teamspaces). All members of that teamspace automatically receive `Member` access to your project, making it perfect for teams that collaborate across multiple projects.
165
+
166
+
Users can have both types of access simultaneously. When this happens, Plane automatically applies whichever role gives them higher permissions. For example, if someone is a `Guest` on your project but joins a linked teamspace, they're automatically upgraded to `Member` access. If they're already an `Admin`, they keep their `Admin` role.
Copy file name to clipboardExpand all lines: docs/core-concepts/workspaces/members.mdx
+74-2Lines changed: 74 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,14 +3,18 @@ title: Manage workspace members
3
3
sidebar_label: Manage members
4
4
description: Add, update, and remove workspace members
5
5
---
6
+
importTagsfrom"@site/src/components/Tags";
6
7
7
8
# Manage members
8
9
9
10
Keeping your workspace organized and secure is essential for smooth project management. Plane makes it easy to control who can access your workspace, what they can do, and how they collaborate with others.
10
11
11
12
This guide shows you how to add members to your workspace, change their roles, and remove them when needed.
12
13
13
-
## Invite a member to your workspace
14
+
## Invite members to your workspace
15
+
16
+
You can add members individually or in bulk using CSV import.
Workspace admins can bulk invite members by importing a CSV file. This is useful when onboarding teams or migrating users from another system.
40
+
41
+

42
+
43
+
**To import members:**
44
+
1. Navigate to **Workspace settings → Members**.
45
+
2. Click **Import**.
46
+
3. Upload your CSV file (drag and drop or click to browse).
47
+
4. Select **Import** to bulk invite the members.
48
+
49
+
Imported users are added directly to the workspace. When they sign in using the imported email, they're automatically redirected to the workspace without going through onboarding.
50
+
51
+
**CSV format requirements**
52
+
53
+
Your CSV must contain these columns in this exact order:
54
+
```
55
+
Email, Display Name, First Name, Last Name, Role
56
+
```
57
+
58
+
**Example CSV:**
59
+
```
60
+
Email,Display Name,First Name,Last Name,Role
61
+
alex@company.com,Alex Chen,Alex,Chen,15
62
+
sarah@company.com,Sarah Kim,Sarah,Kim,20
63
+
mike@company.com,Mike Rodriguez,Mike,Rodriguez,5
64
+
```
65
+
66
+
**Role values:**
67
+
-`5` – Guest
68
+
-`15` – Member
69
+
-`20` – Admin
70
+
71
+
**Important notes**
72
+
- Only `.csv` files are supported.
73
+
- Valid users appear immediately in the Members list after import.
74
+
- Invalid entries are skipped (check your CSV for errors if some users don't appear).
75
+
30
76
:::caution[Self-hosted Plane instance]
31
77
Ensure your SMTP server is properly configured to send invite emails successfully. See [Configure SMTP for email](https://developers.plane.so/self-hosting/govern/communication) for more information.
32
78
:::
@@ -42,6 +88,32 @@ Ensure your SMTP server is properly configured to send invite emails successfull
Track member actions like invitations, role changes, and removals to maintain visibility over workspace management.
97
+
98
+

99
+
100
+
**To view member activity:**
101
+
102
+
1. Navigate to **Workspace settings → Members**.
103
+
2. Click **Activity** in the top right.
104
+
105
+
The activity panel shows recent workspace member events:
106
+
-**Member invitations** - Who invited which members and when
107
+
-**Invitation acceptances** - When members accepted and joined the workspace
108
+
-**Role changes** - Role updates with who made the change and when
109
+
-**Member removals** - Who removed members from the workspace
110
+
111
+
Each activity entry shows:
112
+
- The action taken
113
+
- Who performed the action
114
+
- When it happened (relative time like "about 1 month ago" or "5 days ago")
115
+
116
+
This audit trail helps workspace admins monitor membership changes and troubleshoot access issues. Activity is retained for workspace history and can be filtered by clicking on specific activity types.
45
117
46
118
## Remove a member from your workspace
47
119
@@ -56,4 +128,4 @@ The member loses access to the workspace and all its projects immediately.
56
128
57
129
:::warning
58
130
Removing members doesn't change your seat count or billing. You must [remove seats](/workspaces-and-users/add-remove-seats#remove-unused-seats) separately.
Copy file name to clipboardExpand all lines: docs/integrations/slack.mdx
+13-4Lines changed: 13 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -153,20 +153,29 @@ Once you add Plane to your private channel, you can use all the same features yo
153
153
154
154
### Connect project to Slack channel
155
155
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.
156
+
Stay on top of project updates by linking Plane projects to Slack channels. You can configure which events trigger notifications, so your team only sees updates that matter.
157
157
158
158

159
159
160
160
To configure this:
161
161
162
162
1. Go to your [Workspace Settings](/core-concepts/workspaces/overview#access-workspace-settings) in Plane.
163
-
2. Navigate to **Integrations > Slack**.
163
+
2. Navigate to **Integrations > Slack** in Plane.
164
164
3. Click **Configure** on the Slack integration.
165
165
4. Under **Project Notifications**, click the **➕** button.
166
166
5. Select a Plane Project and the corresponding Slack Channel you’d like to connect.
167
-
6. Click Save.
167
+
6. Under **Notify when**, choose which events trigger Slack notifications:
168
+
-**When a work item is created** - Posts a notification whenever someone creates a new work item in this project.
169
+
-**When a work item state changes** - Notifies the channel when work items move between states (e.g., Todo → In Progress).
170
+
-**When a comment is created on a work item** - Posts updates when someone comments on a work item. You can reply to these comments directly from Slack using the **Reply** button on the notification.
171
+
-**When a work item is marked cancelled or done** - Notifies when work items reach completion states or the cancelled state.
168
172
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.
Find the project-channel mapping in the Project Notifications list. Click the edit icon to change notification settings or the delete icon to remove the connection entirely.
0 commit comments