> ## 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.

# Customization

> Personalize your bot appearance per server — avatar, banner, bio, display name, and name style

## 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, display name, and name style — 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

<AccordionGroup>
  <Accordion title="customize" icon="palette">
    Opens the customization help panel showing all available subcommands and their usage.

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

      ```bash Example theme={null}
      ~customize
      ~customize help
      ```
    </CodeGroup>

    **Aliases:** `custom`, `customizemember`\
    **Permissions:** Anyone (help pages) / Server Owner (subcommands)
  </Accordion>

  <Accordion title="customize avatar" icon="image">
    Change the bot's server-specific avatar. Supports direct image attachments or any publicly accessible image URL.

    <Warning>
      The image must be a valid jpg, png, gif, or webp file and must not exceed **10MB**.
    </Warning>

    <CodeGroup>
      ```bash Syntax theme={null}
      ~customize avatar <url or attachment>
      ```

      ```bash Example theme={null}
      ~customize avatar https://example.com/image.png
      ~customize avatar  (with an image attached)
      ```
    </CodeGroup>

    **Permissions:** Server Owner only
  </Accordion>

  <Accordion title="customize banner" icon="panorama">
    Change the bot's server-specific profile banner. Supports direct image attachments or any publicly accessible image URL.

    <Warning>
      The image must be a valid jpg, png, gif, or webp file and must not exceed **10MB**.
    </Warning>

    <CodeGroup>
      ```bash Syntax theme={null}
      ~customize banner <url or attachment>
      ```

      ```bash Example theme={null}
      ~customize banner https://example.com/banner.png
      ~customize banner  (with an image attached)
      ```
    </CodeGroup>

    **Permissions:** Server Owner only
  </Accordion>

  <Accordion title="customize bio" icon="pen">
    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.

    <Note>
      Your custom text may be up to **190 characters**. The website line is appended automatically and does not count toward your limit.
    </Note>

    <CodeGroup>
      ```bash Syntax theme={null}
      ~customize bio <text>
      ```

      ```bash Example theme={null}
      ~customize bio Your friendly server companion!
      ```
    </CodeGroup>

    **Permissions:** Server Owner only
  </Accordion>

  <Accordion title="customize name" icon="signature">
    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.

    <CodeGroup>
      ```bash Syntax theme={null}
      ~customize name <new name>
      ~customize name reset
      ```

      ```bash Example theme={null}
      ~customize name Celestia
      ~customize name reset
      ```
    </CodeGroup>

    **Permissions:** Server Owner only\
    **Limit:** 32 characters maximum
  </Accordion>

  <Accordion title="customize namestyle" icon="wand-magic-sparkles">
    Set a stylized font, effect, and color for the bot's display name in this server using an interactive picker. Use `reset` to remove the name style.

    <Note>
      The picker walks you through three steps: choose a **font**, choose an **effect**, then enter a **hex color** (or two for Gradient). The Gradient effect requires both a primary and a secondary color.
    </Note>

    <CodeGroup>
      ```bash Syntax theme={null}
      ~customize namestyle
      ~customize namestyle reset
      ```

      ```bash Example theme={null}
      ~customize namestyle
      ~customize namestyle reset
      ```
    </CodeGroup>

    **Permissions:** Server Owner only

    **Available Fonts:**

    | Font      | ID |
    | --------- | -- |
    | Sakura    | 3  |
    | Jellybean | 4  |
    | Modern    | 6  |
    | Medieval  | 7  |
    | 8bit      | 8  |
    | Vampyre   | 10 |
    | gg Sans   | 11 |
    | Tempo     | 12 |

    **Available Effects:**

    | Effect   | ID |
    | -------- | -- |
    | Solid    | 1  |
    | Gradient | 2  |
    | Neon     | 3  |
    | Toon     | 4  |
    | Pop      | 5  |
  </Accordion>

  <Accordion title="customize reset" icon="rotate-left">
    Resets all customizations for this server at once — removes the server avatar, banner, bio, and nickname.

    <Warning>
      This action cannot be undone. All per-server customizations will be permanently removed.
    </Warning>

    <CodeGroup>
      ```bash Syntax theme={null}
      ~customize reset
      ```

      ```bash Example theme={null}
      ~customize reset
      ```
    </CodeGroup>

    **Permissions:** Server Owner only
  </Accordion>
</AccordionGroup>

***

## Customization Options

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

<CardGroup cols={2}>
  <Card title="Avatar" icon="image">
    Set a unique profile picture for the bot in this server
  </Card>

  <Card title="Banner" icon="panorama">
    Set a custom profile banner visible on the bot's member profile
  </Card>

  <Card title="Bio" icon="pen">
    Set a custom about me displayed on the bot's profile, with the website always appended
  </Card>

  <Card title="Display Name" icon="signature">
    Give the bot a custom nickname visible throughout the server
  </Card>

  <Card title="Name Style" icon="wand-magic-sparkles">
    Apply a stylized font, effect, and color to the bot's display name in this server
  </Card>
</CardGroup>

***

## Image Support

Both the avatar and banner commands support flexible image input:

<Tabs>
  <Tab title="Attachment">
    Attach an image directly to your message when running the command. Supported formats: `jpg`, `jpeg`, `png`, `gif`, `webp`.
  </Tab>

  <Tab title="URL">
    Paste any publicly accessible direct image URL as the first argument. The bot will fetch and convert the image automatically.
  </Tab>
</Tabs>

<Note>
  Images must not exceed **10MB**. Unsupported formats or unreachable URLs will return an error.
</Note>

***

## 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.rest
```

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.

***

## Name Style Behavior

The `customize namestyle` command opens an interactive step-by-step picker:

1. **Font** — Choose from 8 available fonts (Sakura, Jellybean, Modern, Medieval, 8bit, Vampyre, gg Sans, Tempo).
2. **Effect** — Choose from 5 effects (Solid, Gradient, Neon, Toon, Pop).
3. **Color** — Enter a hex color code (e.g. `#ff4d4d`). If you selected **Gradient**, you will be prompted for both a primary and a secondary color.

<Note>
  The color input modal will time out after **60 seconds** of inactivity. If it times out, run the command again.
</Note>

To remove the name style at any time, run `customize namestyle reset`.

***

## 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.

<Info>
  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.
</Info>

***

## 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.