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

# Channel Management

> Comprehensive channel creation, editing, and management system

## Overview

The channel management system provides powerful tools for creating, editing, and managing Discord channels. From simple channel creation to cloning, moving, and detailed inspection, the channel command handles all your channel management needs.

<Info>
  All channel commands support flexible syntax - you can specify channels by mention, ID, name, or even a Discord channel link.
</Info>

***

## Commands

<AccordionGroup>
  <Accordion title="channel create" icon="plus">
    Create a new channel with a specified type and optional category.

    <CodeGroup>
      ```bash Syntax theme={null}
      ~channel create <type> <name> [category]
      ```

      ```bash Example theme={null}
      ~channel create text general
      ~channel create voice Music
      ~channel create category Information
      ~channel create forum suggestions Support
      ```
    </CodeGroup>

    **Channel Types:**

    * `text` — Standard text channel
    * `voice` — Voice channel
    * `category` — Category to group channels
    * `announcement` — Announcement channel
    * `stage` — Stage voice channel
    * `forum` — Forum channel

    **Parameters:**

    * **type** — Channel type (required)
    * **name** — Channel name (required)
    * **category** — Category to place the channel in (optional)

    **Aliases:** `ch new`\
    **Permissions:** Manage Channels
  </Accordion>

  <Accordion title="channel delete" icon="trash">
    Delete a channel by mention, ID, or name.

    <CodeGroup>
      ```bash Syntax theme={null}
      ~channel delete <channel>
      ```

      ```bash Example theme={null}
      ~channel delete #general
      ~channel delete 123456789
      ~channel delete old-channel
      ```
    </CodeGroup>

    **What It Does:**

    * If multiple channels match, shows a selection menu
    * Navigate with arrow buttons
    * Confirm deletion with the Delete button

    **Aliases:** `ch del`, `ch rm`\
    **Permissions:** Manage Channels
  </Accordion>

  <Accordion title="channel rename" icon="pen">
    Rename a channel to a new name.

    <CodeGroup>
      ```bash Syntax theme={null}
      ~channel rename <channel> <new name>
      ```

      ```bash Example theme={null}
      ~channel rename #general new-general
      ~channel rename old-chat updated-chat
      ```
    </CodeGroup>

    **Flexible Syntax:**

    * Channel first: `channel rename #general new-name`
    * Name first: `channel rename new-name #general`

    **Aliases:** `ch name`\
    **Permissions:** Manage Channels
  </Accordion>

  <Accordion title="channel edit" icon="pen-to-square">
    Edit a channel's topic, slowmode, NSFW status, or position using key=value pairs.

    <CodeGroup>
      ```bash Syntax theme={null}
      ~channel edit <channel> [topic=...] [slowmode=...] [nsfw=true/false] [position=...]
      ```

      ```bash Example theme={null}
      ~channel edit #general topic=Welcome to the server
      ~channel edit #chat slowmode=5
      ~channel edit #adult nsfw=true
      ~channel edit #general topic=cool server slowmode=5
      ```
    </CodeGroup>

    **Editable Options:**

    * `topic=` — Set the channel topic
    * `slowmode=` — Slowmode delay in seconds
    * `nsfw=` — Set NSFW status (`true` or `false`)
    * `position=` — Channel position number

    You can combine multiple options in a single command.

    **Aliases:** `ch update`\
    **Permissions:** Manage Channels
  </Accordion>

  <Accordion title="channel clone" icon="copy">
    Clone a channel with all its settings and permissions.

    <CodeGroup>
      ```bash Syntax theme={null}
      ~channel clone <channel> [new name]
      ```

      ```bash Example theme={null}
      ~channel clone #general
      ~channel clone #general general-backup
      ```
    </CodeGroup>

    **What It Does:**

    * Clones the channel with all permission overwrites and settings intact
    * If no new name is provided, defaults to `original-name-clone`

    **Aliases:** `ch copy`\
    **Permissions:** Manage Channels
  </Accordion>

  <Accordion title="channel move" icon="arrow-right">
    Move a channel into a category.

    <CodeGroup>
      ```bash Syntax theme={null}
      ~channel move <channel> <category>
      ```

      ```bash Example theme={null}
      ~channel move #general Information
      ~channel move #music Voice Channels
      ```
    </CodeGroup>

    **What It Does:**

    * Moves the channel into the specified category
    * Existing permission overwrites are preserved

    **Flexible Syntax:**

    * Channel first: `channel move #general Information`
    * Category first: `channel move Information #general`

    **Aliases:** `ch mv`\
    **Permissions:** Manage Channels
  </Accordion>

  <Accordion title="channel info" icon="circle-info">
    Get detailed information about a channel.

    <CodeGroup>
      ```bash Syntax theme={null}
      ~channel info <channel>
      ```

      ```bash Example theme={null}
      ~channel info #general
      ~channel info 123456789
      ~channel info general
      ```
    </CodeGroup>

    **Information Shown:**

    * Channel name, ID, and type
    * Position and category
    * Creation date
    * Topic (if set)
    * NSFW and slowmode status (text/announcement channels)
    * User limit and bitrate (voice/stage channels)
    * Archived and locked status (threads)

    **Aliases:** `ch i`\
    **Permissions:** None (view only)
  </Accordion>
</AccordionGroup>

***

## Channel Finding

The system intelligently finds channels using multiple methods:

1. **Mention** — Most reliable method (`#channel`)
2. **Discord Link** — Paste a channel link directly
3. **ID** — Use the channel's unique ID
4. **Exact Name** — Case-insensitive exact match
5. **Partial Name** — If only one channel contains the text

<Note>
  If multiple channels match, you'll get a selection menu to choose the correct one.
</Note>

***

## Permission Requirements

<CardGroup cols={2}>
  <Card title="Bot Permissions" icon="robot">
    The bot needs:

    * Manage Channels
  </Card>

  <Card title="User Permissions" icon="user">
    Command Requirements:

    * **Manage Channels** — For all commands except `info`
  </Card>
</CardGroup>

***

## Aliases

<Card title="ch" icon="c">
  Main alias for all channel commands
</Card>

***

## Usage Examples

<Tabs>
  <Tab title="Basic Operations">
    ```bash theme={null}
    # Create a text channel
    ~channel create text general

    # Delete a channel
    ~channel delete #old-channel

    # Rename a channel
    ~channel rename #general main-chat

    # Get channel info
    ~channel info #general
    ```
  </Tab>

  <Tab title="Channel Creation">
    ```bash theme={null}
    # Basic text channel
    ~channel create text announcements

    # Voice channel
    ~channel create voice Gaming

    # Category
    ~channel create category Community

    # Channel inside a category
    ~channel create text general Information

    # Forum channel
    ~channel create forum suggestions Support
    ```
  </Tab>

  <Tab title="Editing">
    ```bash theme={null}
    # Set a topic
    ~channel edit #general topic=Welcome to the server

    # Set slowmode
    ~channel edit #chat slowmode=10

    # Toggle NSFW
    ~channel edit #adult nsfw=true

    # Multiple options at once
    ~channel edit #general topic=cool server slowmode=5 nsfw=false
    ```
  </Tab>

  <Tab title="Clone & Move">
    ```bash theme={null}
    # Clone a channel (auto name)
    ~channel clone #general

    # Clone with custom name
    ~channel clone #general general-backup

    # Move into a category
    ~channel move #general Information

    # Move using category first
    ~channel move Information #general
    ```
  </Tab>

  <Tab title="Advanced">
    ```bash theme={null}
    # Multiple ways to specify channels
    ~channel info #general
    ~channel info 123456789
    ~channel info general

    # Paste a Discord channel link
    ~channel info https://discord.com/channels/123/456

    # Flexible rename syntax
    ~channel rename #old-name new-name
    ~channel rename new-name #old-name

    # Flexible move syntax
    ~channel move #general Information
    ~channel move Information #general
    ```
  </Tab>
</Tabs>

***

## Related Features

<CardGroup cols={2}>
  <Card title="Role Management" icon="user-gear" href="/role">
    Create, edit, and assign roles
  </Card>

  <Card title="Server Settings" icon="server" href="/server">
    Manage other aspects of your server configuration
  </Card>
</CardGroup>