Skip to main content

​
Overview

The Customization system allows authorized users to personalize the bot’s appearance on a per-server basis. You can set a unique server avatar, banner, bio, and display name — all of which are scoped to the server they are applied in and do not affect the bot globally.

​
Access Control

Only one person can use customization commands:
  • Server Owner — Full access to all customization features
All other users can view the help pages but cannot execute any customization commands.

​
Commands

Opens the customization help panel showing all available subcommands and their usage.
~customize
Aliases: custom, customizemember
Permissions: Anyone (help pages) / Server Owner (subcommands)
Change the bot’s server-specific avatar. Supports direct image attachments or any publicly accessible image URL.
The image must be a valid jpg, png, gif, or webp file and must not exceed 10MB.
~customize avatar <url or attachment>
Permissions: Server Owner only
Change the bot’s server-specific profile banner. Supports direct image attachments or any publicly accessible image URL.
The image must be a valid jpg, png, gif, or webp file and must not exceed 10MB.
~customize banner <url or attachment>
Permissions: Server Owner only
Set a custom about me / bio for the bot in this server. The bot’s website is always appended automatically at the end of the bio.
Your custom text may be up to 190 characters. The website line is appended automatically and does not count toward your limit.
~customize bio <text>
Permissions: Server Owner only
Change the bot’s display name (nickname) in this server. Use reset as the value to remove the nickname and restore the bot’s default name.
~customize name <new name>
~customize name reset
Permissions: Server Owner only
Limit: 32 characters maximum
Resets all customizations for this server at once — removes the server avatar, banner, bio, and nickname.
This action cannot be undone. All per-server customizations will be permanently removed.
~customize reset
Permissions: Server Owner only

​
Customization Options

Each option is scoped to the server it is set in and does not affect the bot’s global appearance.

Avatar

Set a unique profile picture for the bot in this server

Banner

Set a custom profile banner visible on the bot’s member profile

Bio

Set a custom about me displayed on the bot’s profile, with the website always appended

Display Name

Give the bot a custom nickname visible throughout the server

​
Image Support

Both the avatar and banner commands support flexible image input:
Attach an image directly to your message when running the command. Supported formats: jpg, jpeg, png, gif, webp.
Images must not exceed 10MB. Unsupported formats or unreachable URLs will return an error.

​
Bio Behavior

When setting a bio, the bot’s website is always appended to whatever text you provide: 
Your custom text here
Website: https://celestia-bot-chi.vercel.app/
If no text is provided, only the website line is set. Your custom text is limited to 190 characters — the website line does not count toward this limit.

​
Reset Behavior

The customize reset command attempts to clear all four customizations simultaneously. If some fields succeed and others fail, the bot will report exactly which were reset and which failed, rather than showing a generic error.
A partial reset can occur if the bot lacks certain permissions in the server. Ensure the bot has the Change Nickname permission for nickname resets.

​
Help Panel

Running customize or customize help opens an interactive paginated help panel built with Discord Components V2. The panel includes:
  • A description of each subcommand
  • Usage and example syntax with your server’s prefix
  • Whether you have access to run the commands
Only the user who ran the command can interact with the help panel buttons. The panel expires after 2 minutes of inactivity.

​
Best Practices

  • Use server-specific avatars and banners that match your server’s theme or branding.
  • Keep bios concise — the website line is always appended automatically.
  • Use customize reset before transferring server ownership to restore defaults.
  • Test image URLs in your browser before using them — the bot cannot fetch private or login-protected images.