# Communities

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

Audience: Everyone using Shuffl

Kind: How-to guide

Canonical: https://shuffl.ai/docs/communities

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

1. Open Communities and filter by kind, or choose Yours for memberships and pending invitations. Invitation-only communities are visible only to members, invited people and community managers.

2. Choose Join for an open community, or Accept invitation for an invitation-only one, which also requests an invitation to its Slack channel.

3. Leaving in Shuffl doesn’t leave the Slack channel, and rejoining an invitation-only community needs a new invitation.

4. Open a community for its page: cover, description, latest Slack posts, newest members and who runs it.

5. Open in Slack goes to the channel. Posts from a private channel or invitation-only community show to members only.

6. 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.ai/app/communities)

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

1. Choose New community and pick a template, or Start from scratch. 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, which a private Slack channel requires.

3. Administrators and owners can link or create its channel, where Mello introduces the community.

4. Creating a private channel needs Slack’s private-channel permission; otherwise link a private channel Shuffl is already in.

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

6. For an invitation-only community, an owner or administrator chooses Manage under Members, selects people and chooses Invite selected people. Each person must accept; Withdraw cancels a pending invitation.

7. Moderators can edit details and remove members but not invite. Only owners and administrators change the Slack link or archive.

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

Administrators manage communities on the same Communities page, seeing every one, archived included, and can create, edit, archive or change owners of any. Community activity on Home shows only to people allowed to see that community.

Your Slack probably has communities already, like a running club. Under Turn channels into communities, Shuffl ticks the channels that look like one; change the kind or ticks, and confirm invitation-only admission for each private channel. Open communities sync membership with Slack.

Workspace setup lists suggested channels under Start communities, each with a reason.

Once created, Mello says hello in each channel, with a Join button for open communities, and Shuffl draws a cover unless you chose one. A cover that fails can be retried 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/northwind/communities/runners|Shuffl>; membership stays in step in both.
```

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

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

- [Example: invite a group to a community](https://shuffl.ai/docs/groups#recipe-community)

## Related guides

- [Praise and badges](https://shuffl.ai/docs/praise)

- [Connect Slack](https://shuffl.ai/docs/slack)

- [Your profile](https://shuffl.ai/docs/your-profile)

Agent documentation index: https://shuffl.ai/llms.txt

