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

# Branding & prefix

> Brand configures the footer, response emojis, and server visual profile used by supported Headless surfaces. Server settings do not change the bot's global identity.

## Who can change each setting

The `.brand` group requires Administrator; `server-logo` and `server-banner` require Manage Server. Global logo and banner commands are reserved for the Headless owner and are not server customization.

## Commands

> **Complete command reference**
>
> * **`.brand`** — **Description:** Shows available branding settings. · **Access:** Administrator
> * **`.brand footer <text>`** — **Description:** Saves the server embed footer; it is truncated to 50 characters. · **Access:** Administrator
> * **`.brand emoji-success <emoji>`** — **Description:** Sets the success emoji. Aliases: `emoji-ok`, `eok`. · **Access:** Administrator
> * **`.brand emoji-error <emoji>`** — **Description:** Sets the error emoji. Aliases: `emoji-err`, `eerr`. · **Access:** Administrator
> * **`.brand emoji-warn <emoji>`** — **Description:** Sets the warning emoji. Aliases: `emoji-warning`, `ewarn`. · **Access:** Administrator
> * **`.brand emoji-mod <emoji>`** — **Description:** Sets the moderation emoji. Alias: `emod`. · **Access:** Administrator
> * **`.brand emoji-log <emoji>`** — **Description:** Sets the logs emoji. Alias: `elog`. · **Access:** Administrator
> * **`.brand server-logo [URL|attachment]`** — **Description:** Applies a bot avatar specific to this server. · **Access:** Manage Server
> * **`.brand server-banner [URL|attachment]`** — **Description:** Applies a bot banner specific to this server. · **Access:** Manage Server
> * **`.brand logo [URL|attachment]`** — **Description:** Changes the bot's global logo/avatar. · **Access:** Headless owner only
> * **`.brand banner [URL|attachment]`** — **Description:** Changes the bot's global banner. · **Access:** Headless owner only
> * **`.brand reset`** — **Description:** Removes saved server emoji, footer, and media overrides. · **Access:** Administrator
> * **`.prefix`** — **Description:** Shows the server's current prefix. · **Access:** Server members
> * **`.prefix set <new>`** — **Description:** Changes the prefix; up to five characters are accepted. · **Access:** Administrator
> * **`.prefix reset`** — **Description:** Restores the default `.` prefix. · **Access:** Administrator

> [!NOTE]
>
> A `/prefix` slash command is also available with the default permission set to Administrator. Text-prefix examples use `.` as the global prefix; a server may have configured another value.

## Accepted inputs

Server images can use a valid public URL or an attachment. Footer text is limited to 50 characters. Emojis must be valid for Discord to display them.

### `.brand footer`

```headless-command Syntax theme={null}
.brand footer <text>
```

```headless-command Example theme={null}
.brand footer Community
```

### `.brand emoji-error`

```headless-command Syntax theme={null}
.brand emoji-error <emoji>
```

```headless-command Example theme={null}
.brand emoji-error ❌
```

### `.brand emoji-warn`

```headless-command Syntax theme={null}
.brand emoji-warn <emoji>
```

```headless-command Example theme={null}
.brand emoji-warn ⚠️
```

### `.brand server-logo`

```headless-command Syntax theme={null}
.brand server-logo [source]
```

```headless-command Example theme={null}
.brand server-logo https://example.com/logo.png
```

### `.brand server-banner`

```headless-command Syntax theme={null}
.brand server-banner [source]
```

```headless-command Example theme={null}
.brand server-banner https://example.com/banner.png
```

### `.brand reset`

```headless-command Syntax theme={null}
.brand reset
```

```headless-command Example theme={null}
.brand reset
```

> [!WARNING]
>
> `.brand reset` clears saved server branding and restores defaults; it does not change the bot's global avatar/banner. Use only public media you are allowed to display.

## Applying changes

Changes affect future responses. An already-published panel may need to be regenerated in its module to reflect new styling.

> **Server profile vs. global bot identity**
>
> `server-logo` and `server-banner` apply media to the profile Headless uses in one server and require Manage Server. `.brand logo` and `.brand banner` change the global profile and are reserved for the Headless owner. Do not use the global commands to customize just one server.

> **Image inputs and errors**
>
> Server media accepts a public URL or an image/GIF attachment. The runtime validates and downloads the file before requesting the Discord change; an API rejection is reported as an error, not success. Footer text is limited to 50 characters.

> **What reset restores**
>
> `.brand reset` removes only the saved server emoji, footer, logo, and banner overrides. It does not call Discord to revert an avatar or banner that was already applied; manage an already-applied profile change through the Discord options available to you.

## Quick guide

> **What to change**
>
> Tune the footer and success, error, warning, moderation, and logs emojis to match your community's tone.

> **When to use it**
>
> Use server-level settings for communities with their own identity, special events, or internal terminology.

> **Keep it clear**
>
> Use a short footer, recognizable emojis, and tell members when you change the prefix.

## Steps

**1. Choose a server style**

Set success, error, warning, moderation, and log emojis.

**2. Set footer or profile media**

Configure footer, server logo, or server banner without placing secrets in public URLs.

**3. Review existing messages**

Test a new response and regenerate persistent panels that do not refresh automatically.

## Related pages

* [Emoji tools](/docs/en/community/emoji.md)
* [Welcome messages](/docs/en/server/welcome.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.