Direkt zum Hauptinhalt

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
nach oben