A Group is a collection of community members. Groups are useful for managing large numbers of users at once, mass DMs (coming soon), assignments to other areas of the Tightknit platform, and more!Documentation Index
Fetch the complete documentation index at: https://docs.tightknit.ai/llms.txt
Use this file to discover all available pages before exploring further.
Groups support up to 100 members when managed through the Slack app, and up
to 1,000 members when imported from CSV in the Studio or managed through the
API.
Terminology: Note that Tightknit Groups are distinct from Slack’s “user
groups” (a
feature only on paid Slack Pro plans). For the purposes of this article, every
time we mention “Group” we are referring to the Tightknit feature.
Managing Groups
Admins can manage groups from either the Admin Studio or directly in Slack. The two experiences differ in capability and scale, so pick the tab that matches where you’re working.- Studio
- Slack
Navigate to the Groups page in the Admin Studio to view, search, and manage all of your community’s groups. The groups list displays each group’s name, slug, visibility, member count, Slack channel sync status, and creation date.
- Search groups by name or slug
- Create new groups (empty or from CSV)
- Click any group to view its detail page with the full member roster
Create a Group
Click the Create Group button on the Groups page. You have two options:- Empty Group
- From CSV
Create a group and configure it manually. Provide the following:
- Name (required) — the display name for the group
- Slug (optional) — a URL-friendly identifier; auto-generated from the name if not provided
- Companion Site Visibility — Public groups appear on the Groups page and member profile pages. Private groups are hidden from the companion site.
Group Detail Page
Click any group in the list to open its detail page. Here you can:- View group metadata (name, slug, visibility, Slack sync status)
- Browse the full member roster with profile information and join dates
- Edit the group — update name, slug, visibility, membership award, and notification preferences
- Add members individually or remove existing members
- Delete the group
Group Settings
When editing a group, you can configure:- Name — the name associated with the group
- Slug — the URL route for the group on the companion site
- Companion Site Visibility — controls whether the group is visible on the companion site
- Permission Set — assign a Permission Set to the group; all members inherit the permissions
- Membership Award — assign an Award to the group. All members automatically receive the award and only retain it while they are a member. When you add or remove members, the award is automatically given or revoked, respectively.
- Notify New Members — when enabled, new members added to the group receive a private notification DM informing them of their membership and any inherited permissions
Import Members from CSV
You can also bulk-add members to an existing group. Open the Import Members dialog from the group detail page or via the Cmd+K command palette (Import Members from CSV). Select the target group, then paste or upload a CSV of email addresses (up to 1,000 rows). A results report shows which imports succeeded or failed, and you can check the Import History page for past import jobs.
Changing the Membership Award on a Group
When you add, swap, or clear the Membership Award on a Group, Tightknit automatically updates every current member:- Add an award (none → Award A): every member receives Award A, along with a Slack DM, activity log entry, and outbound webhook event.
- Swap the award (Award A → Award B): Award A is revoked from every member and Award B is assigned. Only the Award B assignment triggers a DM. The Award A revocation is silent to avoid a confusing “you lost an award” notification.
- Clear the award (Award A → none): Award A is silently revoked from every member. No DMs are sent.