teal;dr
HOMEDOCS

Admin Commands

Configuration and management commands for server administrators.

⚠️ Administrator Only: All commands on this page require Discord administrator permissions or the "Manage Server" permission.

/settings

Configure bot behavior, manage channels, and control data retention. This is the primary admin command for bot configuration.

Syntax

/settings action: <action_type> [channel: #channel] [days: number] [confirm: yes]

Available Actions

Exclude Channel

Prevent the bot from indexing messages in a specific channel.

/settings action: Exclude Channel channel: #private-chat

Include Channel

Re-enable indexing for a previously excluded channel.

/settings action: Include Channel channel: #general

Set Retention Period

Configure how long messages are stored (7-90 days).

/settings action: Set Retention Period days: 60

View All Settings

Display current configuration for your server.

/settings action: View All Settings

Clear All Data

Permanently delete all indexed data for your server. Requires confirmation.

/settings action: Clear All Data confirm: yes

⚠️ This action is irreversible

/customize

Customize the bot's personality and response style to match your server's culture.

Syntax

/customize persona: <Professional|Friendly|Technical|Concise>

Professional

Formal, business-focused tone. Best for work servers and professional communities.

  • • Formal language
  • • Concise responses
  • • Business terminology

Friendly

Casual, conversational tone. Best for gaming and community servers.

  • • Casual language
  • • Warm responses
  • • Community-focused

Technical

Detailed, precise responses. Best for developer and technical communities.

  • • Technical terminology
  • • Detailed explanations
  • • Code-focused

Concise

Brief, to-the-point responses. Best for high-traffic servers.

  • • Short responses
  • • Key points only
  • • Minimal elaboration

Admin Best Practices

Privacy First

  • Exclude channels containing sensitive information (HR, moderation logs)
  • Review excluded channels list regularly
  • Inform members about bot indexing in server rules
  • Set appropriate retention periods for your use case

Performance Optimization

  • Exclude high-traffic bot channels to reduce noise
  • Use shorter retention periods for very active servers
  • Monitor cache statistics with /stats
  • Clear old data periodically if storage is a concern

User Experience

  • Choose a persona that matches your server culture
  • Announce bot features to your community
  • Create a #bot-commands channel for testing
  • Document your server's bot usage guidelines

Permission Requirements

To use admin commands, users must have one of the following:

  • Administrator permission in Discord
  • Manage Server permission
  • Server Owner role

The bot will verify permissions before executing any admin command and will return an error if the user lacks sufficient permissions.

← Utility CommandsBot Settings →