Vanity Tracking

Monitor and respond to vanity URL usage in your server

Overview

Vanity tracking monitors when members use your custom vanity URL in status. When detected, the bot can automatically send custom messages, embeds, give roles, and log the activity. Perfect for tracking referrals, monitoring vanity usage, and rewarding members who promote your server.

Requires Aurelia Bot

Vanity tracking is handled by Aurelia, an extension bot of Celestia. Aurelia can only be invited to servers where Celestia is present and vanity features are unlocked.

Invite Aurelia

Aurelia is built to manage vanity systems independently for improved stability and performance.

---

Setup Requirements

1. Have Celestia in Your Server

   Celestia must already be in your server with vanity features unlocked.

2. Invite Aurelia

   Invite Aurelia using the link above. It can only join servers where Celestia is present.

3. Configure Vanity Tracking

   Use /vanity commands to set up your tracking preferences.

---

Commands

/vanity set

Set the vanity URL to track.

Syntax

/vanity set url:<vanity_code>

Parameters:

• url — Your vanity URL code (without discord.gg/)

What It Does:

• Monitors statuses for this vanity URL
• Triggers configured actions when detected
• Case-insensitive matching

Permissions: Manage Server

/vanity message

Set a custom message to send when vanity is detected.

Syntax

/vanity message text:<message> channel:<#channel>

Parameters:

• text — Custom message (supports variables)
• channel — Channel to send the message in

Available Variables:

• {user.mention} — Mentions the user who posted the vanity
• {vanity} — The vanity URL that was detected
• All standard variables from the Variables guide

Permissions: Manage Server

/vanity embed

Send a saved embed when vanity is detected.

Syntax

/vanity embed name:<embed_name> channel:<#channel>

Parameters:

• name — Name of your saved embed (from /embed builder)
• channel — Channel to send the embed in

Note: The embed must be saved to your account first using /embed builder

Permissions: Manage Server

/vanity webhook

Send an embed through a webhook when vanity is detected.

Syntax

/vanity webhook webhook_url:<url> embed_name:<name> [username:<name>] [avatar_url:<url>]

Parameters:

• webhook_url — Discord webhook URL
• embed_name — Name of your saved embed
• username — Optional: Custom webhook username
• avatar_url — Optional: Custom webhook avatar

Use Cases:

• Send to specific channels without bot message
• Custom branding with webhook username/avatar
• Professional appearance

Permissions: Manage Server

/vanity log

Set a channel to log all vanity detections.

Syntax

/vanity log channel:<#channel>

Parameters:

• channel — Channel to send logs to

What It Logs:

• Who repped the vanity
• When it was repped

Permissions: Manage Server

/vanity role

Give a role when vanity is detected.

Syntax

/vanity role role:<@role>

Parameters:

• role — Role to assign

What It Does:

• Automatically gives the role to users who rep the vanity
• Perfect for tracking promoters
• Rewarding members who share the server

Requirements:

• Bot must have Manage Roles permission
• Role must be lower than bot’s highest role
• Role cannot be managed by integrations

Permissions: Manage Server

/vanity view

View current vanity tracking configuration.

Syntax

/vanity view

What It Shows:

• Currently tracked vanity URL
• Configured message/embed settings
• Webhook configuration (if set)
• Log channel (if set)
• Role assignment (if set)

Permissions: Manage Server

/vanity reset

Reset all vanity tracking settings.

Syntax

/vanity reset

What It Does:

• Clears vanity URL tracking
• Removes all configured actions
• Deletes all settings
• Cannot be undone

This removes all vanity configuration for your server.

Permissions: Manage Server

---

How It Works

1. Set Your Vanity URL

   Configure which vanity URL to track:

   /vanity set url:myserver
   
2. Configure Actions

   Choose what happens when vanity is detected:

   # Send a message
   /vanity message text:Thanks {user.mention}! channel:#promotions
   
   # Give a role
   /vanity role role:@Promoter
   
   # Log activity
   /vanity log channel:#logs
   

---

Configuration Options

You can combine multiple actions:

Message

Send a custom thank you message with variables

Embed

Send a saved embed to a specific channel

Webhook

Send embed through webhook with custom branding

Role

Automatically assign a role to the user

Log

Log all vanity detections to a channel

---

Permission Requirements

Aurelia Permissions

The bot needs:

• Read Messages
• Send Messages
• Embed Links
• Manage Roles (for role assignment)
• Manage Webhooks (for webhook feature)

User Permissions

Command Requirements:

• Manage Server — All vanity commands

---

Usage Examples

Basic Setup

# Set vanity URL
/vanity set url:myserver

# Send message when detected
/vanity message text:Thanks {user.mention} for sharing! channel:#general

# View configuration
/vanity view

With Role Reward

# Set vanity
/vanity set url:community

# Give promoter role
/vanity role role:@Promoter

# Send thank you
/vanity message text:Thanks for promoting! You've been given the Promoter role. channel:#promotions

With Logging

# Set vanity
/vanity set url:myserver

# Configure logging
/vanity log channel:#mod-logs

# Send embed
/vanity embed name:vanity-detected channel:#promotions

Professional Webhook

# Set vanity
/vanity set url:official

# Configure webhook
/vanity webhook webhook_url:https://discord.com/api/webhooks/... embed_name:promo-alert username:Promotion Tracker avatar_url:https://...

# Add logging
/vanity log channel:#stats

Complete Setup

# Set vanity
/vanity set url:epicserver

# Message + role
/vanity message text:Thanks {user.mention} for sharing {vanity}! channel:#thanks
/vanity role role:@Ambassador

# Logging
/vanity log channel:#vanity-logs

# Check config
/vanity view

---

Common Use Cases

Referral tracking

/vanity set url:myserver
/vanity role role:@Referrer
/vanity log channel:#referral-logs

Track who’s sharing your server and reward them.

Promotion rewards

/vanity set url:community
/vanity role role:@Promoter
/vanity message text:Thanks {user.mention}! You earned the Promoter role! channel:#rewards

Automatically reward members who promote your server.

Analytics & logging

/vanity set url:myserver
/vanity log channel:#analytics
/vanity embed name:vanity-stats channel:#stats

Track vanity usage for analytics.

Professional branding

/vanity set url:official
/vanity webhook webhook_url:https://... embed_name:branded-alert username:Server Bot avatar_url:https://...

Use webhooks for custom branding.

---

Tips & Best Practices

Setup Tips

• Test with a test channel first
• Use variables in messages for personalization
• Create professional embeds for vanity alerts
• Set up logging to track usage
• Consider role rewards for promotion incentives

Message Variables

Use these in your custom messages:

• {user.mention} — Tag the user
• {vanity} — Show which vanity was detected
• {guild.name} — Server name
• {channel} — Channel where it was posted

Important Notes

• Aurelia must be in your server (requires Celestia)
• Vanity features must be unlocked in Celestia
• Only one vanity URL can be tracked per server
• Embeds must be saved to your account first
• Webhook embeds and regular embeds are mutually exclusive

---

Troubleshooting

Vanity Not Being Detected

1. Verify Aurelia bot is in your server
2. Check vanity URL is set correctly with /vanity view
3. Ensure Aurelia has Read Messages permission
4. Test by posting the vanity URL yourself
5. Vanity matching is case-insensitive

Role Not Being Assigned

1. Check bot has Manage Roles permission
2. Verify bot’s role is higher than the role being assigned
3. Ensure role isn’t managed by an integration
4. Check /vanity view shows correct role

Embed Not Sending

1. Verify embed exists with /embed list
2. Check you’re the owner of the embed
3. Ensure Aurelia has Send Messages + Embed Links permissions
4. Try using /vanity message instead as a test

Webhook Not Working

1. Verify webhook URL is valid
2. Check webhook hasn’t been deleted
3. Ensure embed is saved to your account
4. Test webhook in Discord’s webhook settings

---

Aurelia vs Celestia

Celestia

Main bot with all core features:

• Moderation
• VoiceMaster
• Giveaways
• Embeds
• And more

Aurelia

Extension bot for vanity:

• Vanity tracking only
• Requires Celestia
• Better performance
• Dedicated stability

---

Related Features

Embed Builder

Create embeds for vanity alerts

Variables

Use dynamic variables in messages

Auto Responders

Automated message responses

Role Management

Create roles for vanity rewards