> ## Documentation Index
> Fetch the complete documentation index at: https://help.hoopai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Communities

> Build and manage an interactive community space for your members inside the HoopAI Platform.

Communities give your members a dedicated space to connect, discuss, share wins, ask questions, and build relationships with each other — all within your branded member portal, alongside your courses and membership content.

<Frame caption="Communities overview showing all community groups in the platform">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/I-7NA7h4R_oTZgd5/images/memberships-communities-overview-section.png?fit=max&auto=format&n=I-7NA7h4R_oTZgd5&q=85&s=0cfd656a933aa1563afde09c9770b412" alt="Communities overview" width="1597" height="819" data-path="images/memberships-communities-overview-section.png" />
</Frame>

## What is a community?

A community is a social feed-style space attached to your member portal. Members can:

* Post text updates, images, and videos
* Comment on and react to other members' posts
* Create and join topic-based **Groups** within the community
* Direct message other members (if enabled)
* Receive notifications for new posts, comments, and mentions

As an admin, you can moderate posts, pin important announcements, create groups, and manage member roles.

***

## Creating a community

<Steps>
  <Step title="Navigate to Memberships and Communities > Communities">
    Click **Memberships and Communities** in the left sidebar, then select **Communities**. Click **+ New Community**.

    <Frame caption="Creating a new community group from the Communities section">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/I-7NA7h4R_oTZgd5/images/memberships-communities-create-group.png?fit=max&auto=format&n=I-7NA7h4R_oTZgd5&q=85&s=c1a82ee65de1778875bcc0478f9c0359" alt="Create community group" width="929" height="234" data-path="images/memberships-communities-create-group.png" />
    </Frame>
  </Step>

  <Step title="Name and configure the community">
    Enter a community name, description, and upload a cover image and logo. These appear in the member portal and on the community landing page.

    <Frame caption="Community group setup — entering name, description, and branding">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/I-7NA7h4R_oTZgd5/images/memberships-communities-group-setup.png?fit=max&auto=format&n=I-7NA7h4R_oTZgd5&q=85&s=1f2678eb7f2a0acbfc19c4c557b80b71" alt="Community group setup" width="1646" height="719" data-path="images/memberships-communities-group-setup.png" />
    </Frame>
  </Step>

  <Step title="Set access rules">
    Choose who can join the community:

    * **Open** — any member who logs into the portal can join
    * **Restricted** — only members with a specific membership or tag can access the community

    <Frame caption="Community privacy settings — public, private, or paid access options">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/I-7NA7h4R_oTZgd5/images/memberships-communities-privacy-settings.png?fit=max&auto=format&n=I-7NA7h4R_oTZgd5&q=85&s=e15dbd33da11a39a2603a774fa46831f" alt="Community privacy settings" width="1071" height="755" data-path="images/memberships-communities-privacy-settings.png" />
    </Frame>

    <Frame caption="Community group settings panel with access configuration options">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/I-7NA7h4R_oTZgd5/images/memberships-communities-group-settings-panel.png?fit=max&auto=format&n=I-7NA7h4R_oTZgd5&q=85&s=72bf12cb435b26b5fd2f8ffadca54cac" alt="Group settings panel" width="1828" height="777" data-path="images/memberships-communities-group-settings-panel.png" />
    </Frame>
  </Step>

  <Step title="Create groups and channels">
    Groups are topic or interest-based sub-spaces within the community. Click **+ Add Group** to create groups such as "Introductions", "Questions & Answers", "Wins & Celebrations", or "Resources".

    <Frame caption="Community channels panel showing all available channel types">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/I-7NA7h4R_oTZgd5/images/memberships-communities-channels-panel.png?fit=max&auto=format&n=I-7NA7h4R_oTZgd5&q=85&s=4cfa335ab4bab54bf1b43ec585ab4c2d" alt="Channels panel" width="1887" height="866" data-path="images/memberships-communities-channels-panel.png" />
    </Frame>

    <Frame caption="Channel type selection — feed, chat, events, and learning tabs">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/I-7NA7h4R_oTZgd5/images/memberships-communities-channel-types.png?fit=max&auto=format&n=I-7NA7h4R_oTZgd5&q=85&s=2196369dd7bf7eb9e6ec5fab9fd1ba0f" alt="Channel types" width="1887" height="866" data-path="images/memberships-communities-channel-types.png" />
    </Frame>

    <Frame caption="Community group channels view showing all channels within a group">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/I-7NA7h4R_oTZgd5/images/memberships-communities-group-channels.png?fit=max&auto=format&n=I-7NA7h4R_oTZgd5&q=85&s=6d477f3b8f55b37b47c5d0614e01e9d7" alt="Group channels" width="332" height="144" data-path="images/memberships-communities-group-channels.png" />
    </Frame>
  </Step>

  <Step title="Configure notifications">
    Set up email digest notifications to keep members engaged. Options include:

    * Immediate notifications for new posts or comments
    * Daily or weekly digest emails summarizing activity
  </Step>

  <Step title="Publish and invite members">
    Publish the community and send invitations to your existing members via email automation. New members who purchase access can be automatically added via an automation action.
  </Step>
</Steps>

***

## Community channel types

When you create groups inside a community, you choose a channel type for each group. Different channel types support different interaction styles:

| Channel type | Description                                                           | Best used for                                                 |
| ------------ | --------------------------------------------------------------------- | ------------------------------------------------------------- |
| Feed         | Social-style post wall where members create posts, comment, and react | General discussion, announcements, wins and celebrations      |
| Chat         | Real-time threaded messaging, similar to a group chat                 | Quick questions, live event chats, team coordination          |
| Events       | Scheduled community events with RSVP and calendar integration         | Workshops, Q\&A sessions, live calls                          |
| Learning     | Displays courses linked to the community inside the group             | Cohort-based course discussion, module-by-module study groups |

<Frame caption="Channel type selection — feed, chat, events, and learning tabs">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/I-7NA7h4R_oTZgd5/images/memberships-communities-channel-types.png?fit=max&auto=format&n=I-7NA7h4R_oTZgd5&q=85&s=2196369dd7bf7eb9e6ec5fab9fd1ba0f" alt="Channel types" width="1887" height="866" data-path="images/memberships-communities-channel-types.png" />
</Frame>

<Frame caption="Community channels panel showing all available channel types">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/I-7NA7h4R_oTZgd5/images/memberships-communities-channels-panel.png?fit=max&auto=format&n=I-7NA7h4R_oTZgd5&q=85&s=4cfa335ab4bab54bf1b43ec585ab4c2d" alt="Channels panel" width="1887" height="866" data-path="images/memberships-communities-channels-panel.png" />
</Frame>

### Feed channels

Feed channels are the default channel type. Members create posts (text, images, videos), and other members comment and react. Admins can pin posts, approve content before it appears, and create polls. Feed channels work best as the main social hub of your community.

### Chat channels

Chat channels support real-time threaded messaging. Unlike the feed, chat messages are shorter and conversational. Use chat channels alongside live events or office hours to give members a space to ask quick questions without cluttering the main feed.

### Events channels

Events channels let you schedule and promote community events. Members RSVP, receive reminders, and can view upcoming events in a calendar view. Link events to specific modules or course milestones to drive attendance at relevant sessions.

### Learning channels

Learning channels embed courses directly inside a community group. Members can switch between the social feed and their course content without leaving the community interface. This is ideal for cohort programs where course consumption and peer discussion happen side by side.

***

## Community moderation

As an admin or moderator you can:

* **Pin posts** — keep important announcements at the top of the feed
* **Delete posts or comments** — remove inappropriate content
* **Mute or ban members** — restrict posting rights for specific members
* **Approve posts** — enable a moderation queue so posts require approval before appearing publicly
* **Create polls** — post a multiple-choice poll to gather member opinions

<Frame caption="Post creation interface in a community channel">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/I-7NA7h4R_oTZgd5/images/memberships-communities-post-creation.png?fit=max&auto=format&n=I-7NA7h4R_oTZgd5&q=85&s=c9396024067f8a8318d4ca81f9cf2ad2" alt="Post creation" width="664" height="667" data-path="images/memberships-communities-post-creation.png" />
</Frame>

<Frame caption="Community leaderboard showing top contributing members">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/I-7NA7h4R_oTZgd5/images/memberships-communities-leaderboard.png?fit=max&auto=format&n=I-7NA7h4R_oTZgd5&q=85&s=5260956baf42471b73840704719f685c" alt="Community leaderboard" width="577" height="649" data-path="images/memberships-communities-leaderboard.png" />
</Frame>

***

## Member roles

| Role      | Capabilities                                                             |
| --------- | ------------------------------------------------------------------------ |
| Admin     | Full access — manage settings, groups, members, and moderate all content |
| Moderator | Moderate posts and comments, pin content, manage members                 |
| Member    | Post, comment, react, and direct message                                 |

Assign roles from the **Members** tab inside the community settings.

<Frame caption="Member list showing all members and their roles in the community">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/I-7NA7h4R_oTZgd5/images/memberships-communities-member-list.png?fit=max&auto=format&n=I-7NA7h4R_oTZgd5&q=85&s=7004e974117d14728f9b934022b06e37" alt="Member list" width="350" height="104" data-path="images/memberships-communities-member-list.png" />
</Frame>

<Frame caption="Managing members inside a community group — roles and permissions">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/I-7NA7h4R_oTZgd5/images/memberships-communities-manage-members.png?fit=max&auto=format&n=I-7NA7h4R_oTZgd5&q=85&s=6c4c4467de8278cd37644949dfc2b02f" alt="Manage members" width="667" height="818" data-path="images/memberships-communities-manage-members.png" />
</Frame>

<Frame caption="Member role assignment — changing member roles within a community">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/I-7NA7h4R_oTZgd5/images/memberships-communities-member-roles.png?fit=max&auto=format&n=I-7NA7h4R_oTZgd5&q=85&s=6f0d6bd8a4214850300bf80fd2ee8167" alt="Member roles" width="964" height="351" data-path="images/memberships-communities-member-roles.png" />
</Frame>

<Frame caption="Member actions — message, promote, or remove members from the community">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/I-7NA7h4R_oTZgd5/images/memberships-communities-member-actions.png?fit=max&auto=format&n=I-7NA7h4R_oTZgd5&q=85&s=7c6b1c076a2c52d6810876198f8b1549" alt="Member actions" width="513" height="298" data-path="images/memberships-communities-member-actions.png" />
</Frame>

<Frame caption="Membership approval requests for restricted community groups">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/wsOWInSUNx2udRj3/images/memberships-communities-approval-requests.png?fit=max&auto=format&n=wsOWInSUNx2udRj3&q=85&s=7a13f0483190beba7dc9b2fc94fa3d4a" alt="Approval requests" width="1451" height="436" data-path="images/memberships-communities-approval-requests.png" />
</Frame>

***

## Paid communities

You can require a paid subscription to join a community group.

<Frame caption="Paid group setup — configuring payment type and pricing for community access">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/I-7NA7h4R_oTZgd5/images/memberships-communities-paid-group-details.png?fit=max&auto=format&n=I-7NA7h4R_oTZgd5&q=85&s=fe708703f662f71d5a1529204e680f1a" alt="Paid group details" width="1094" height="853" data-path="images/memberships-communities-paid-group-details.png" />
</Frame>

<Frame caption="Subscription options for a paid community group">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/I-7NA7h4R_oTZgd5/images/memberships-communities-paid-group-subscription.png?fit=max&auto=format&n=I-7NA7h4R_oTZgd5&q=85&s=6e4eb93eb956480b75089c396599c7fe" alt="Paid group subscription" width="1112" height="846" data-path="images/memberships-communities-paid-group-subscription.png" />
</Frame>

<Frame caption="Pricing configuration for a paid community group">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/I-7NA7h4R_oTZgd5/images/memberships-communities-paid-group-pricing.png?fit=max&auto=format&n=I-7NA7h4R_oTZgd5&q=85&s=1c39d7e3246e36cf5cd29dd0ac197afa" alt="Paid group pricing" width="1112" height="846" data-path="images/memberships-communities-paid-group-pricing.png" />
</Frame>

<Frame caption="Payment gateway settings for a paid community group">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/I-7NA7h4R_oTZgd5/images/memberships-communities-paid-group-payment.png?fit=max&auto=format&n=I-7NA7h4R_oTZgd5&q=85&s=7e1907631d7c0c529be09fed7cc913b8" alt="Paid group payment settings" width="579" height="549" data-path="images/memberships-communities-paid-group-payment.png" />
</Frame>

***

## Community badges

Badges reward members for participation and achievement within the community.

<Frame caption="Community badge creation — designing and naming a new member badge">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/wsOWInSUNx2udRj3/images/memberships-communities-badge-creation.png?fit=max&auto=format&n=wsOWInSUNx2udRj3&q=85&s=108185964bc7b6dc2e7d677786fe49d7" alt="Badge creation" width="415" height="376" data-path="images/memberships-communities-badge-creation.png" />
</Frame>

<Frame caption="Badge assignment criteria — setting conditions for earning a badge">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/wsOWInSUNx2udRj3/images/memberships-communities-badge-assign-criteria.png?fit=max&auto=format&n=wsOWInSUNx2udRj3&q=85&s=d520790830f12a460b2a0e93e96f0e60" alt="Badge assignment criteria" width="981" height="437" data-path="images/memberships-communities-badge-assign-criteria.png" />
</Frame>

<Frame caption="Badge levels and progression settings for community gamification">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/I-7NA7h4R_oTZgd5/images/memberships-communities-badge-levels.png?fit=max&auto=format&n=I-7NA7h4R_oTZgd5&q=85&s=dc75298d7497a696bb297f916f00fe5c" alt="Badge levels" width="1320" height="765" data-path="images/memberships-communities-badge-levels.png" />
</Frame>

***

## Community and courses

Pairing a community with a course creates a cohort experience:

* Members work through the course and discuss lessons in the community
* Create a group for each course module as a dedicated discussion space
* Post weekly challenge prompts to drive engagement and accountability

<Frame caption="Learning tab in a community showing courses available to members">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/I-7NA7h4R_oTZgd5/images/memberships-communities-events-tab.png?fit=max&auto=format&n=I-7NA7h4R_oTZgd5&q=85&s=7f53451a291533686e5d7f90e94189e1" alt="Learning tab courses" width="1416" height="867" data-path="images/memberships-communities-events-tab.png" />
</Frame>

***

## Automations for communities

Use the **Community Member Joined** trigger in Automations to:

* Send a welcome email with community guidelines and tips to get started
* Add a tag to the contact record for community members
* Notify a team member or moderator

<Tip>
  Post a welcome prompt ("Introduce yourself — where are you from and what are you working on?") as a pinned post on day one. This single action dramatically increases new member participation rates.
</Tip>

***

## Frequently asked questions

<AccordionGroup>
  <Accordion title="What types of channels can I create within a community?">
    Communities support several channel types you can add within any group: **Feed** (social-style post wall), **Chat** (real-time threaded messaging), **Events** (scheduled community events with RSVP), and **Learning** (linked courses displayed inside the community). Choose the channel type that best fits each group's purpose.
  </Accordion>

  <Accordion title="Can I restrict a community to specific members?">
    Yes. When setting access rules for a community group, choose **Restricted** to limit access to members who have a specific membership offer, tag, or custom field value. Members without the required access see the community listed but cannot join or view content.
  </Accordion>

  <Accordion title="How do I charge members to join a community?">
    In the community group settings, enable **Paid** access and configure the subscription type, billing frequency, and price. Members are prompted to pay before joining the group. Ensure your Stripe account is connected in your Hoop payment settings to accept payments.
  </Accordion>

  <Accordion title="What are the different member roles in a community?">
    There are three roles: **Admin** (full access — manage settings, groups, members, and moderate all content), **Moderator** (moderate posts and comments, pin content, manage members), and **Member** (post, comment, react, and direct message). Assign roles from the **Members** tab inside the community settings.
  </Accordion>

  <Accordion title="Can I enable a post approval queue?">
    Yes. Enable the moderation queue in the community group settings. When activated, all new posts from members are held for admin or moderator review before appearing publicly in the feed.
  </Accordion>

  <Accordion title="How do badges work in communities?">
    Badges are visual credentials you can create and award to members based on participation or achievement criteria. You design the badge (icon, name, description) and then either issue it manually from a contact record or link it to an automation trigger. Earned badges appear on the member's profile inside the community.
  </Accordion>

  <Accordion title="How do I automate a welcome message when someone joins?">
    Use the **Community Member Joined** trigger in Automations. Add a **Send Email** action to deliver your welcome message, include community guidelines, and provide tips on getting started. You can also add a tag or notify a team member via the same workflow.
  </Accordion>
</AccordionGroup>

***

## Paid groups

You can require payment to join a specific community group, creating a monetized community experience:

1. In the group settings, enable **Paid** access.
2. Choose the payment type: **one-time**, **subscription** (monthly/annual), or **payment plan**.
3. Set the price.
4. Connect your payment gateway (Stripe is required for paid groups).
5. Members are prompted to pay before gaining access to the group.

Paid groups are ideal for premium content channels, mastermind groups, VIP access tiers, and exclusive coaching communities.

***

## Paid courses inside communities

Embed paid courses directly within community groups to create a cohort learning experience:

1. Add a **Learning** channel to the group.
2. Select the course to embed.
3. Link the course to a paid offer (configured in **Memberships and Communities > Courses > Offers**).
4. Members who purchase the offer gain access to both the course content and the community group.

This combines the social engagement of a community with structured course delivery — members discuss lessons, share wins, and ask questions alongside the curriculum.

***

## Member approval questions

When a group is set to **Private**, you can add custom approval questions that members must answer before their join request is submitted:

1. In the group settings, navigate to **Approval Questions**.
2. Click **+ Add Question** and enter your question (e.g., "What is your main goal for joining this group?").
3. Add as many questions as needed.
4. When a member requests to join, their answers appear alongside the join request for admin review.

Approval questions help you screen members, gather insights about your audience, and ensure the group maintains quality.

***

## Ban members and report content

Admins and moderators have tools to maintain community safety:

### Banning members

1. Navigate to the **Members** tab in the community or group.
2. Find the member and click the three-dot menu.
3. Select **Ban**. The member is immediately removed from the community and cannot rejoin.
4. Banned members can be unbanned later from the **Banned Members** list in community settings.

### Reporting content

Members can report posts and comments that violate community guidelines:

1. The member clicks the three-dot menu on a post or comment.
2. They select **Report** and choose a reason (spam, harassment, inappropriate content, etc.).
3. The report appears in the admin's **Moderation Queue** for review.
4. Admins can delete the content, warn the member, or ban the member based on the report.

<Tip>
  Publish clear community guidelines as a pinned post in your main group. This sets expectations for behavior and gives moderators a reference point when handling reports and enforcing rules.
</Tip>
