TidyCord Documentation

Complete Guide to Commands & Features

Learn how to use TidyCord to transform your Discord server with this comprehensive documentation.

Getting Started with TidyCord

TidyCord is the ultimate Discord channel manager that helps you organize your server with private & public channels, instant voice rooms, and powerful management tools.

Quick Setup Guide

  1. Add TidyCord to your server using the invite link on our homepage
  2. Configure settings with the /settings command (admin only)
  3. Start using commands like /claim to create private text channels
  4. Join the "➕ Add Voice Channel" to create your own voice channel

Need help? Use /help to see all available commands or join our support server.

Core User Commands

These commands are available to all server members and don't require special permissions.

Command Description Usage
/claim Creates a private text channel that only you can access Type /claim and confirm by clicking the "Claim Channel" button
/help Displays a comprehensive help menu with all available commands Simply type /help
/info Displays detailed information about the bot Simply type /info
/feedback Submits feedback, suggestions, or bug reports Type /feedback and complete the modal form

Channel Management Commands

These commands help you manage access to your private channels.

Command Description Usage
/addtextuser @user Adds a specific user to your private text channel Type /addtextuser followed by a mention or selection of the target user
/addtextrole @role Adds a role to your private text channel Type /addtextrole followed by the target role
/addvoiceuser @user Adds a specific user to your voice channel Type /addvoiceuser followed by a mention or selection of the target user
/addvoicerole @role Adds a role to your voice channel Type /addvoicerole followed by the target role

User Selection Dropdown

All channel management commands feature an intuitive dropdown interface with:

  • Search functionality with real-time filtering
  • Avatar preview for easy identification
  • Single-click permission granting
  • Validation to prevent duplicate access

Administrative Commands

These commands are only available to server administrators.

Command Description Usage
/settings Opens an interactive settings panel for server configuration Type /settings as a server administrator
/helpadmin Displays a list of administrative commands Type /helpadmin as a server administrator
/add_voice_channel Creates a join-to-create voice channel if it has been deleted Type /add_voice_channel as a server administrator

Settings Configuration

The /settings command provides access to:

  • Text Channel Settings: Category, naming format, deletion time
  • Voice Channel Settings: Category, naming format, deletion time, privacy toggle
  • General Settings: View configuration, apply templates

All settings are saved immediately and persist across bot restarts.

Private Voice Channel System

TidyCord's voice channel system allows users to create their own private or public voice channels instantly.

Creation Process

  1. User joins the designated "Add Voice Channel" (default name: "✚ Add Voice Channel")
  2. System automatically creates a personal voice channel
  3. User is moved to their new channel instantly

Key Features

  • Customizable Naming: Format with {owner} placeholder (default: {owner}-voice)
  • Automatic Deletion: Configurable emptiness timer (default: 120 seconds/2 minutes)
  • Privacy Options: Configure as public (anyone can join) or private (invite only)
  • Permission Management: Add users and roles via dropdown menus

Voice Channel Management

Once in your voice channel, you can:

  • Add users with /addvoiceuser @user
  • Add roles with /addvoicerole @role
  • Switch between private/public mode anytime (if enabled by admin)
  • Channel is automatically deleted when empty (based on admin settings)

Private Text Channel System

TidyCord allows users to create their own private text channels with full permission control.

Creation Process

  1. User initiates with /claim command
  2. Confirmation button prevents accidental creation
  3. System checks for existing user channels
  4. New private text channel is created with the user as owner

Key Features

  • Customizable Naming: Format with {owner} placeholder (default: {owner}-text)
  • Automatic Deletion: Configurable inactivity timer (default: 300 seconds/5 minutes)
  • Permission Management: Interactive searchable dropdowns for adding users/roles
  • Privacy Control: Only the owner and added users/roles can see the channel

Text Channel Management

Once you have your text channel, you can:

  • Add users with /addtextuser @user
  • Add roles with /addtextrole @role
  • Channel is automatically deleted after inactivity (based on admin settings)

Premium AI Features

TidyCord offers advanced AI-powered features for premium servers.

AI Chat Assistant Premium

Interact with an AI assistant powered by OpenAI's model using the /chat command.

Usage

Type /chat followed by your question or message

Features

  • Sends your prompt to AI with server context for relevant responses
  • Provides responses as ephemeral messages visible only to you
  • Multiple message chunks for longer responses
  • Security filters prevent misuse or harmful content

Examples

  • /chat How do I set up private channels? - For bot help
  • /chat What's the capital of France? - For general knowledge
  • /chat Help me with Python syntax - For coding assistance
  • /chat Write a welcome message for my server - For creative content

Rate Limits: 10 requests per 2 minutes per user

AI-Powered Custom Templates Coming Soon

Create custom server templates using natural language descriptions.

Features

  • Describe your ideal server structure in natural language
  • AI creates custom categories, channels, and roles
  • Interactive conversation to refine your server
  • Tailored to your community's unique needs
  • Perfect for specialized communities

Automatic Features and Systems

TidyCord includes several automatic systems that work without manual intervention.

Auto-Cleanup System

  • Voice Channels: Automatically deleted when empty (configurable timer)
  • Text Channels: Removed after a period of inactivity (configurable timer)
  • Timer Reset: Activity in channels resets the deletion timer

Server Templates

  • Pre-made Layouts: Gaming, Community, Education & Business templates
  • Optimized Structure: Categories and channels organized for specific purposes
  • Quick Setup: Apply templates with a single command
  • Permission Configuration: Role-based permissions automatically set up

Permission Management

  • Automatic Overwrites: Channels are created with proper permission settings
  • Dynamic Updates: Permissions update in real-time when users/roles are added
  • Owner Recognition: System tracks channel ownership for permission commands

Security Features

TidyCord prioritizes security and privacy for your server.

Permission Verification

  • Channel Ownership: Checked for all management commands
  • Administrator Validation: Required for admin commands
  • Discord Integration: Works with Discord's native permission system

AI Content Safety

  • Pattern Matching: Regex filtering for potentially harmful content
  • Category Filtering: Content categorization for safety
  • Rate Limiting: Prevents abuse (10 requests per 2 minutes)
  • Error Handling: Graceful handling of invalid inputs

Privacy Controls

  • Private Channels: Only visible to owners and explicitly added users/roles
  • Granular Permissions: Fine-tuned access control
  • Ephemeral Messages: Sensitive responses only visible to the requesting user

Server Requirements

To function properly, TidyCord needs the following permissions:

  • Manage Channels - For creating and modifying channels
  • View Channels - For basic functionality
  • Send Messages - For command responses
  • Connect to Voice - For voice channel features
  • Manage Roles - For permission management
  • Embed Links - For rich embeds
  • Add Reactions - For interactive components

Recommended Setup

For the best experience, we recommend:

  • Placing the TidyCord role above any roles it needs to manage
  • Creating dedicated categories for voice and text channels
  • Setting appropriate timers based on your server's activity level
  • Regularly checking for updates and new features

Ready to transform your Discord server?

Join thousands of communities already using TidyCord

Add to Discord Now