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

# Customization

> Change mira's avatar, banner, bio, display name, and response style in your server.

mira's profile can be changed per server, so it can look however you want without affecting
anyone else's. Avatar, banner, bio, display name, and the emojis and colours used in responses
are all yours to set.

## Use the dashboard

Avatars and banners are far easier to handle on the dashboard, where you can upload an image,
crop it, and rotate it before saving instead of hunting for a link that fits.

<Card title="Open the dashboard" icon="external-link" href="https://dash.mira.party/">
  Upload, crop, and rotate images without touching a command.
</Card>

<Frame caption="Customizing mira's profile from the dashboard">
  <img src="https://mintcdn.com/juno/6WF5DyrcaLVQMlnE/images/dashboard-customization.png?fit=max&auto=format&n=6WF5DyrcaLVQMlnE&q=85&s=f27aa00f6080c22400488c731bce31aa" alt="The customization page on the mira dashboard" className="rounded-xl bg-gradient-to-b from-[#5865F2]/25 to-transparent p-6" width="1920" height="912" data-path="images/dashboard-customization.png" />
</Frame>

<Info>
  Some things aren't on the dashboard yet. The **bio**, the **display name font, colour, and
  effect**, and the **response emojis and colours** are commands only.
</Info>

## Avatar and banner

```text Syntax theme={null}
customize avatar
customize banner
```

You don't have to paste a link. mira looks for an image in a few places, in this order:

* An image attached to the message you're sending
* An image in a message you're replying to
* The most recent image posted in the channel

So a bare `customize avatar` right after someone posts the image you want will pick it up.
Links work too, as long as Discord accepts the format.

```text Remove them theme={null}
customize avatar remove
customize banner remove
```

<Warning>
  Discord rate limits profile changes **hard**. If the avatar or display name doesn't update
  straight away, nothing has gone wrong. The request is queued and applied as soon as Discord
  allows it.
</Warning>

## Display name

```text Syntax theme={null}
customize display <name> [--font <font>] [--effect <effect>]
```

```text Example theme={null}
customize display hi --font gg sans --effect toon
```

### Fonts

`GG Sans` (Default), `Tempo`, `Sakura`, `Jellybean`, `Modern`, `Medieval`, `8Bit`, and `Vampyre`

### Effects

`Solid` (Default), `Gradient`, `Neon`, `Toon`, and `Pop`.

<Warning>
  Inside a server, Discord only renders the **font**. The effect won't show in the member list
  or in chat, and mira's role colour is used instead. Open mira's profile to see the full style.
  This is Discord's behaviour, not something mira can change.
</Warning>

```text Reset it theme={null}
customize display reset
```

## Bio

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

Not available on the dashboard. Discord's own length limits apply to both the bio and the
display name, so mira will tell you if what you've written is too long.

## Responses

Every reply mira sends falls into one of four types, and each can have its own emoji and
colour.

```text Syntax theme={null}
customize response <type> [emoji] [color]
```

| Type      | Used for                   |
| --------- | -------------------------- |
| `default` | Neutral messages           |
| `approve` | Something worked           |
| `warn`    | Errors and warnings        |
| `loading` | Anything still in progress |

```text Examples theme={null}
customize response approve ✅ #57F287
customize response warn #ED4245
```

Run a type on its own with nothing after it to clear both its emoji and its colour.

```text Reset every type at once theme={null}
customize response reset
```

## Mentions

mira doesn't ping you when it replies. Turn it on if you'd rather be mentioned.

```text Syntax theme={null}
customize ping <status>
```

```text Example theme={null}
customize ping on
```

See [booleans](/reference/syntax/arguments#booleans) for accepted values.

## Starting over

```text theme={null}
customize reset
```

Resets the whole profile back to default. mira asks you to confirm first, since this clears the
avatar, banner, bio, display name, and response styling in one go.

## Commands

| Command                    | Description                                  |
| -------------------------- | -------------------------------------------- |
| `customize`                | Customize mira's profile in this server      |
| `customize avatar`         | Change the avatar                            |
| `customize avatar remove`  | Reset the avatar to default                  |
| `customize banner`         | Change the banner                            |
| `customize banner remove`  | Remove the banner                            |
| `customize bio`            | Change the bio                               |
| `customize display`        | Change the display name, font, and effect    |
| `customize display reset`  | Reset the display name to default            |
| `customize response`       | Set the emoji and colour for a response type |
| `customize response reset` | Reset every response type to default         |
| `customize ping`           | Toggle whether mira mentions you in replies  |
| `customize reset`          | Reset the entire profile. Asks to confirm    |