# Communities

> Groups for interests, places, skills and resource groups, each linked to a Slack channel.

Audience: Everyone using Shuffl

Canonical: https://shuffl-rebuild.vercel.app/docs/communities

<a id="join"></a>
## Find and join a community

1. Open Communities and filter by kind, or choose Yours to see memberships and pending invitations. Invitation-only communities are visible only to their members, invited people and community managers. Coworker profiles respect the same audience.

2. Choose Join for an open community, or Accept invitation for an invitation-only community. Accepting joins you here and requests an invitation to the named Slack channel. Slack membership alone admits people only to open communities. If an invitation cannot be confirmed, check Slack before trying again. Leaving in Shuffl cancels work that has not started; leave the Slack channel separately. An invitation-only community requires a new invitation to rejoin.

3. Choose Show me as a member to decide whether the community appears on your profile. Members lists who is in it, when the owners allow that.

A community is a group of coworkers around an interest, a city or office, a skill or a resource group, with a page, its members and usually a Slack channel. Suggested for you picks communities from your profile and the people you know.

- [Open Communities](https://shuffl-rebuild.vercel.app/app/communities)

<a id="create"></a>
## Start a community

1. Choose New community, or pick a template from the gallery. A template fills in the name, description, category and picture; change what you like.

2. Choose Who can join: open to the workspace or Invite only. A private Slack channel requires Invite only. Administrators can browse existing Slack channels or create a public or private channel; an existing community owner can also create its channel. Shuffl verifies its access before saving the link. Mello introduces the community there. Private creation is available only when the installed connection has the broader private-channel creation permission; otherwise link an existing private channel that already contains Shuffl. Reconnecting adds only permissions currently requested by the app.

3. Add a cover, uploaded or created with AI, choose who is listed as a member, and add owners and moderators. Choose Create community.

4. For an invitation-only community, an owner or administrator opens Members, selects people and chooses Invite selected people. This creates pending invitations in Shuffl; it does not join them or send Slack invitations. Each person must accept. Withdraw cancels a pending invitation. Moderators can edit details and remove members, but cannot invite people or change admission. Only owners and administrators can change the Slack link or archive the community. Archiving leaves the Slack channel alone.

<a id="administrators"></a>
## For administrators

Administrators see every community under Manage → Communities, including archived ones, and can edit, archive or change the owners of any of them. Community activity in Home is visible only to people allowed to see that community.

Your Slack probably has communities already, like a running club or a pets channel. Under Turn channels into communities, Shuffl ticks the channels that look like one. Change the kind or the ticks, and explicitly confirm invitation-only admission for each private channel before creating. Open communities sync membership with Slack; private communities retain each person’s acceptance requirement.

Workspace setup lists the suggested channels under Start communities, each with the reason Shuffl suggests it. Once you create them, Mello says hello in each channel right away and Shuffl draws a cover for each new community. A cover you already chose is kept, and a cover that fails to draw can be tried again from the same list.

Your own agent can also draw or upload a cover for a community you own, moderate or administer, over MCP or the API.

Slack message, Community channel hello (The channel linked to a community; Once, when the channel is linked):

```text
Hi everyone, I'm Mello. This channel is now home to the *Runners* community in Shuffl.

Weekend runs, race plans and route swaps.

Join here or in <https://shuffl.ai/app/communities?community=runners&workspace=northwind|Shuffl>; membership stays in step in both.
```

- [Open Communities in Manage](https://shuffl-rebuild.vercel.app/app/manage/communities)

- [Turn channels into communities](https://shuffl-rebuild.vercel.app/app/manage/setup/slack-channels#communities)

## Related guides

- [Praise and badges](https://shuffl-rebuild.vercel.app/docs/praise)

- [Connect Slack](https://shuffl-rebuild.vercel.app/docs/slack)

- [Your profile](https://shuffl-rebuild.vercel.app/docs/your-profile)

Agent documentation index: https://shuffl-rebuild.vercel.app/llms.txt