# Server Branding — Detailed Guide

# Server Branding — Detailed Guide

> **Pro / Beta / Lifetime** — lightweight whitelabel alternative without an own bot token

## What happens technically?

Discord lets bots **override their profile per server** via the endpoint:

```
PATCH /guilds/{guild.id}/members/@me
{ "nick": "...", "avatar": "data:image/png;base64,...", "banner": "..." }
```

The bot stays the same (same application ID, same token), but **on this one server** it looks different.

## When to use vs. Whitelabel?

| Property | Server Branding | Whitelabel |
|----------|-----------------|------------|
| Own bot user | ❌ Quantix stays | ✅ Own bot |
| Own token needed | ❌ No | ✅ Yes |
| Kick Quantix? | ❌ No | ✅ Yes |
| Setup time | ~30 sec | ~5 min |
| Pro tier | ✅ | ✅ |

> **Both at once** is possible — decide per server.

## Configuration

Sidebar → **Premium → Server Branding**

### Fields

**Nickname** (max. 32 chars)
- Bot's display name on this server
- Discord member list shows this name
- @-mention still uses the global bot name

**Avatar URL** (PNG / JPG / GIF, ≤ 8 MB)
- Profile picture for this server only
- Discord fetches the image on **Apply**, not on save
- URL must be **publicly reachable**

**Banner URL** (PNG / JPG / GIF, ≤ 8 MB)
- Profile banner shown when someone opens the bot profile
- Recommended: 600 × 240 px

## Apply vs Save

Two steps:

1. **Auto-save** persists your input to the DB (every few seconds)
2. **"Apply" button** pushes the data to Discord — only then does the profile change

If images are too big or URLs invalid: **Discord error appears in the panel** with details.

## Reset

**"Reset" button** removes the per-server override:

```
PATCH /guilds/{guild.id}/members/@me
{ "nick": null, "avatar": null, "banner": null }
```

Bot falls back to the **global Quantix profile**. Useful when you:
- Switch to whitelabel
- Test branding and want to revert quickly
- Premium expires (auto-handled)

## Premium auto-cleanup

When your premium **expires**:
1. Branding config gets **frozen** (bot keeps showing the last profile)
2. After premium ends you can't change it, only reset
3. Renewal re-activates it automatically

## Common errors

**"Image larger than 8 MB"**
- Image too big. Compress locally (TinyPNG, Squoosh)

**"Image must be png, jpg, gif, or webp"**
- Wrong format. Convert to PNG/JPG

**"Image fetch failed (404)"**
- URL not reachable — usually requires authentication
- Discord CDN URLs (cdn.discordapp.com) often don't work (auth-required)
- Recommendation: use your own CDN (imgur.com, cloudinary, own domain)

**"Pro tier required"**
- Premium expired or not active
- Check status: Sidebar → **Premium → Premium Status**