> ## Documentation Index
> Fetch the complete documentation index at: https://social-b97141fb-auto-generate-llmstxt.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Channel Management

> Guide for moderators and administrators to search, create, configure, moderate, and analyze chat channels in the Console

<iframe width="720" height="405" src="https://www.youtube.com/embed/24XZQHgHZPk?si=-R1n9H5Zq8u8xr-G" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />

<Info>
  This page explains how Console moderators and administrators manage channels: discovery, creation, configuration, member governance, lifecycle actions, and activity analytics. Focus: operational workflows (not developer integration).
</Info>

<CardGroup cols={3}>
  <Card title="Discover" icon="magnifying-glass">
    Search & filter active, muted, stopped, deleted channels
  </Card>

  <Card title="Create" icon="plus">
    Launch Community, Live, or Broadcast channels
  </Card>

  <Card title="Configure" icon="gears">
    Privacy & notification modes
  </Card>

  <Card title="Moderate" icon="shield">
    Mute, stop, delete, ban, unban members
  </Card>

  <Card title="Analyze" icon="chart-bar">
    Review flagged messages & user chat activity
  </Card>

  <Card title="Optimize" icon="arrow-progress">
    Apply governance & engagement best practices
  </Card>
</CardGroup>

## Access & Filtering

<Steps>
  <Step title="Open Channels">
    Go to Chat Management → Channels.
  </Step>

  <Step title="Apply Filters">
    Use search + filter controls at top.
  </Step>

  <Step title="Review Icons">
    Identify state (muted, stopped, deleted) via status icons.
  </Step>

  <Step title="Select Channel">
    Open target channel for settings & membership.
  </Step>
</Steps>

<AccordionGroup>
  <Accordion title="Channel States & Icons">
    * Standard (active)
    * Deleted: Gray trash icon (visible to admins only)
    * Muted: Mute icon (all members read-only)
    * Stopped: Gray stop icon (force-closed; members removed)
  </Accordion>

  <Accordion title="Filter Options">
    * Show All Channels: Includes active / muted / deleted
    * Hide Deleted Channels: Active & muted only
    * Flagged Messages: Channels containing user-flagged messages for review
  </Accordion>

  <Accordion title="When to Use Each Filter">
    * Audit cleanup: Show All
    * Safety triage: Flagged Messages
    * Operational focus: Hide Deleted
  </Accordion>
</AccordionGroup>

## Channel Actions Overview

<Tabs>
  <Tab title="Mute / Unmute">
    Temporarily suspend new member messages (read-only). Use for cooling-off periods or announcement-only phases.
  </Tab>

  <Tab title="Stop Channel">
    Immediately close channel and remove all members. Use for irreversible shutdown (archival or policy breach).
  </Tab>

  <Tab title="Delete Channel">
    Hide from non-admin users (soft delete). Still visible to admins with gray trash icon for oversight/audit.
  </Tab>

  <Tab title="Notification Modes">
    Default (all subscribed), Silent (suppress all), Subscribe (only opted-in). Adjust to control noise & relevance.
  </Tab>

  <Tab title="Privacy (Community Type)">
    Public = discoverable; Private = invite-only. Only applies to Community channel type.
  </Tab>
</Tabs>

## Creating a Channel

<Steps>
  <Step title="Launch Dialog">
    Channels → + (Create) button.
  </Step>

  <Step title="Select Type">
    Choose Community, Live, or Broadcast.
  </Step>

  <Step title="Define Identity">
    Set Channel ID & Display Name (member-visible).
  </Step>

  <Step title="Set Privacy (Community)">
    Choose Public or Private.
  </Step>

  <Step title="Mute Option">
    Pre-mute if staging content before opening.
  </Step>

  <Step title="Notification Mode">
    Pick Default, Silent, or Subscribe based on expected activity volume.
  </Step>

  <Step title="Create">
    Confirm settings and create channel.
  </Step>
</Steps>

<Info>
  Use Silent mode for high-volume announcement channels where you want manual opt-in later; use Subscribe mode to reduce irrelevant push volume platform-wide.
</Info>

## Deleting / Stopping a Channel

<Steps>
  <Step title="Open Channel">
    Select target from list.
  </Step>

  <Step title="Settings Panel">
    Navigate to Settings section.
  </Step>

  <Step title="Action Choice">
    Decide: Stop (immediate closure) vs Delete (hide from end users).
  </Step>

  <Step title="Confirm">
    Execute action; verify state icon updates.
  </Step>
</Steps>

<Warning>
  Stopping a channel forcibly disconnects members. Deleting keeps history accessible to admins but hidden from users.
</Warning>

## Managing Channel Users

<Steps>
  <Step title="Open Members Tab">
    Inside channel, select Members.
  </Step>

  <Step title="Locate User">
    Search or scroll through membership list.
  </Step>

  <Step title="Apply Action">
    Mute, Ban, Change Role, or Remove.
  </Step>

  <Step title="Confirm Changes">
    Verify icon/state updates (e.g., ban badge).
  </Step>
</Steps>

<AccordionGroup>
  <Accordion title="Mute / Unmute Member">
    Temporarily restrict a user from sending messages; reversible at any time.
  </Accordion>

  <Accordion title="Ban / Unban User">
    Block user and remove them from active participation. Unbanning restores eligibility to rejoin.
  </Accordion>

  <Accordion title="Change Role">
    Adjust permissions (e.g., moderator vs standard member) aligned with channel governance.
  </Accordion>

  <Accordion title="Remove User">
    Detach user from channel without punitive ban; they may rejoin if channel is public or invited.
  </Accordion>

  <Accordion title="Ban vs Remove">
    * Ban: User flagged as blocked; cannot rejoin until unbanned.
    * Remove: Membership cleared; no block state.
    * Removing a banned user clears ban status—confirm enforcement intent before removing.
  </Accordion>
</AccordionGroup>

<Info>
  Use ban for policy violations; use remove for inactive or off-topic presence without formal enforcement.
</Info>

## Chat Activities (Beta)

A user-centric analytics view (Manage Users → Chat Activities) showing per-user metrics:

* Total messages sent
* Channels joined
* Flagged messages involvement
* Channel-level breakdown of participation

<Tabs>
  <Tab title="Use Cases">
    Identify high-risk users (flag density), evaluate power contributors, support behavioral audits.
  </Tab>

  <Tab title="Moderation Workflow">
    Prioritize intervention for users generating disproportionate flagged content.
  </Tab>

  <Tab title="Engagement Strategy">
    Spot champions for recognition and retention programs.
  </Tab>
</Tabs>

<Warning>
  Beta feature: Data refresh latency may apply; cross-verify before enforcement escalation.
</Warning>

## Best Practices

<AccordionGroup>
  <Accordion title="Channel Governance">
    * Define naming conventions for clarity.
    * Segment high-volume topics into dedicated channels.
    * Use Private Community channels for sensitive collaboration.
  </Accordion>

  <Accordion title="Notification Hygiene">
    * Default sparingly for high-noise channels.
    * Silent reduces fatigue during heavy announcement cycles.
    * Subscribe mode encourages opt-in relevance.
  </Accordion>

  <Accordion title="Moderation Discipline">
    * Ban only with documented rationale.
    * Review muted channels regularly; unmute when stability returns.
    * Reassess stopped channels quarterly (archive or permanently remove metadata).
  </Accordion>

  <Accordion title="Safety & Compliance">
    * Track flagged message ratio per channel.
    * Identify recurring violation patterns (spam clusters, harassment zones).
    * Escalate severe violations per internal protocol.
  </Accordion>
</AccordionGroup>

## Troubleshooting

| Issue                                        | Likely Cause                    | Resolution                               |
| -------------------------------------------- | ------------------------------- | ---------------------------------------- |
| Cannot create channel                        | Missing permission / invalid ID | Verify role & unique ID format           |
| Notification mode not saving                 | Unsaved dialog or permission    | Reopen dialog, confirm role rights       |
| User rejoined after remove                   | Remove used instead of ban      | Apply ban for enforcement scenarios      |
| Ban cleared unexpectedly                     | User removed while banned       | Re-ban without removing membership first |
| Channel still visible to admins after delete | Expected soft delete behavior   | No action; working as designed           |
| Messages still incoming after mute           | Delay / client cache            | Confirm mute state; refresh clients      |
| Flagged count not updating                   | Processing delay                | Wait sync cycle or refresh panel         |

## Quick Reference

<CardGroup cols={2}>
  <Card title="Channel Types" icon="comments">
    Community • Live • Broadcast
  </Card>

  <Card title="Notification Modes" icon="bell">
    Default • Silent • Subscribe
  </Card>

  <Card title="Member Actions" icon="user-minus">
    Mute • Ban • Role • Remove
  </Card>

  <Card title="Lifecycle" icon="arrows-spin">
    Mute → Stop → Delete (soft)
  </Card>
</CardGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Moderation Overview" icon="shield" href="/analytics-and-moderation/console/moderation/overview">
    Strengthen enforcement workflows
  </Card>

  <Card title="User Management" icon="users" href="/analytics-and-moderation/console/management">
    Manage users & roles
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="Channel Analytics (Beta)" icon="chart-bar" href="/analytics-and-moderation/console/analytics">
    Explore chat activity metrics
  </Card>

  <Card title="Branding" icon="badge-check" href="/analytics-and-moderation/console/settings/branding">
    Configure official identity
  </Card>
</CardGroup>