Reference

Every command cupid answers to

14 available for everyone, 8 for server staff. Explore commands below or browse the panel embed scripting guide.

22 of 22 commands

/application Everyone

Open your cupid application panel.
/find match Everyone

Ask cupid to match you with someone.
/cancel match Everyone

End your match or stop looking for one.
/user info Everyone

View your own cupid profile.
/user overview Everyone

Where your account stands: sections, pool, lookups left.
/user match Everyone

Check where your match stands.
/user reveal Everyone

Agree to swap real usernames with your match.
/search scope Everyone

Choose who you can find, and who can find you.
/partner profile Everyone

View your active match's cupid profile.
/partner birthday Everyone

View your active match's upcoming birthday.
/partner time Everyone

View your active match's current local time.
/report Everyone

Report a user by their cupid id.
/latency Everyone

Check whether cupid is responding.
/help Everyone

Show cupid commands and how matching works.
/setup application send Manage Server

Post the cupid application panel in this channel.
/setup application embed Manage Server

Replace this server's application panel with a custom embed.
/setup paired-logs channel Manage Server

Set the channel where match logs are posted.
/setup paired-logs embed Manage Server

Customise the match log embed with a script.
/setup paired-logs enable Manage Server

Enable posting match logs in this server.
/setup paired-logs disable Manage Server

Stop posting match logs in this server.
/setup search scope Manage Server

Set this server's default match pool (Global or Guild Only).
/setup overview Manage Server

This server's scope, panel status and applicant count.

Server Customization

Embed Scripting & Variables

Customize your server's application panel with /setup application embed or match log notifications with /setup paired-logs embed.

How Embed Scripts Work

Embed scripts are single-line templates starting with {embed} followed by directives in the format $v{directive: value}. Multi-parameter directives use && to separate values. To reset any panel or log embed back to default, submit an empty script.

Embed Directives

Syntax & Options

$v{color: #hex}: Sets the embed accent sidebar colour.
Example: $v{color: #e8a0bf}
$v{title: text}: The primary heading of the embed.
Example: $v{title: Cupid Matchmaking}
$v{description: text}: Main body text. Supports Discord Markdown, emojis, subtext (-# text), and links.
Example: $v{description: -# Answer questions to join the queue}
$v{author: name && icon && url}: Author header line. Icon image URL and click URL are optional.
Example: $v{author: {guild.name} Cupid && {guild.icon} && https://cupid.adore.rest}
$v{field: name && value && inline}: Adds an embed field. Inline accepts true or false (default false).
Example: $v{field: Status && Looking for matches && true}
$v{footer: text && icon}: Small footer text at the bottom. Footer icon URL is optional.
Example: $v{footer: Powered by cupid.adore.rest && {guild.icon}}
$v{thumbnail: url}: Corner thumbnail image URL.
Example: $v{thumbnail: {guild.icon}}
$v{image: url}: Large full-width banner image placed below the embed description.
Example: $v{image: https://example.com/banner.png}

Match Variables

/setup paired-logs embed

{cupid1.alias}: Cupid handle of the requester (e.g. cupid#0417)
{cupid1.mention}: Discord @mention of the requester (<@1234...>)
{cupid1.name}: Discord username of the requester
{cupid1.id}: Discord user ID of the requester
{cupid2.alias}: Cupid handle of the match partner (e.g. cupid#1183)
{cupid2.mention}: Discord @mention of the match partner
{cupid2.name}: Discord username of the match partner
{cupid2.id}: Discord user ID of the match partner
{match.type}: The event type (Pair, Reveal, Unmatch)

Server & User Variables

All Embeds

{guild.name}: Name of the current server
{guild.id}: Server ID
{guild.count}: Total member count in the server
{guild.icon}: URL of the server's icon
{guild.boost_count}: Number of Nitro boosts on the server
{guild.created_at}: Server creation date (UTC)
{user.name}: Username of the member running the command
{user.mention}: Mention of the member running the command
{user.id}: Discord user ID
{user.avatar}: URL of the user's avatar
{user.nick}: Server nickname (or display name)
{user.joined_at}: Date when the user joined the server
{user.join_position}: Ordinal join order (e.g. 42nd)

Ready-to-Use Templates

Copy and paste these scripts directly into your Discord embed modals.

Application Panel Script /setup application embed

{embed}$v{color: #e8a0bf}$v{author: {guild.name} Matchmaking && {guild.icon}}$v{title: Welcome to Cupid}$v{description: Click the button below to start your anonymous application.\n\n-# You will receive a private cupid# handle. Your real username stays hidden until both sides agree to reveal.}$v{field: 1. Apply && Answer profile questions && true}$v{field: 2. Match && Run /find match && true}$v{footer: Powered by cupid.adore.rest}

Match Announcement Log Script /setup paired-logs embed

{embed}$v{color: #e8a0bf}$v{title: New Match Formed!}$v{description: **{cupid1.alias}** has been matched with **{cupid2.alias}**!}$v{field: Event && {match.type} && true}$v{field: Server && {guild.name} && true}$v{footer: Cupid Match Logging && {guild.icon}}

Invite to Discord Read the FAQ