[{"data":1,"prerenderedAt":472},["ShallowReactive",2],{"guide-vanity-roles":3},{"id":4,"title":5,"author":6,"body":7,"category":458,"createdAt":459,"description":460,"disabled":461,"extension":462,"image":459,"imageAlt":459,"meta":463,"navigation":464,"order":465,"path":466,"readTime":467,"seo":468,"stem":469,"updatedAt":470,"__hash__":471},"guides\u002Fguides\u002Fvanity-roles.md","Vanity Roles","Discortics Team",{"type":8,"value":9,"toc":443},"minimark",[10,26,29,34,139,143,187,191,194,219,223,286,290,293,381,385,413,417,422,425,429,436,440],[11,12,13,16,17,21,22,25],"p",{},[14,15,5],"strong",{}," lets you reward members who support your server by adding your server invite link or a custom phrase (like ",[18,19,20],"code",{},"discortics.com"," or ",[18,23,24],{},".gg\u002Fmyserver",") to their Discord status.",[11,27,28],{},"When a member adds the text to their custom status, Discortics automatically gives them your chosen roles. When they remove it from their status, Discortics takes the roles back.",[30,31,33],"h2",{"id":32},"set-up-vanity-roles","Set up Vanity Roles",[35,36,37,103],"guide-setup-tabs",{},[38,39,41],"template",{"v-slot:dashboard":40},"",[42,43,48],"guide-setup",{":open":44,"description":45,"screenshot":46,"title":47},"true","Configure reward roles, status keyword, log channels, and announcement messages.","[insert screenshot here]","Set up from the Dashboard",[49,50,51,59,70,77,83,86,93,100],"ol",{},[52,53,54,55,58],"li",{},"Make sure your server has an active ",[14,56,57],{},"Custom"," bot.",[52,60,61,62,65,66,69],{},"In Discord ",[14,63,64],{},"Server Settings → Roles",", move the Discortics role ",[14,67,68],{},"above"," the roles you want it to give.",[52,71,72,73,76],{},"Open ",[14,74,75],{},"Dashboard → Settings",".",[52,78,79,80,82],{},"Expand ",[14,81,5],{}," and turn on the toggle switch.",[52,84,85],{},"Choose the roles to award.",[52,87,88,89,92],{},"(Optional) Enter a ",[14,90,91],{},"Status Text \u002F Watch Keyword"," to look for. If left blank, Discortics looks for your server's vanity invite code.",[52,94,95,96,99],{},"(Optional) Select a ",[14,97,98],{},"Log Channel"," for reward and removal logs.",[52,101,102],{},"Use the save bar to apply the change.",[38,104,105],{"v-slot:commands":40},[42,106,109],{":open":44,"description":107,"screenshot":46,"title":108},"Use the interactive vanity settings panel in Discord.","Set up in Discord",[49,110,111,117,124,130,136],{},[52,112,113,114,76],{},"Run ",[18,115,116],{},"\u002Fsettings vanity",[52,118,119,120,123],{},"Use ",[14,121,122],{},"Roles"," to select reward roles.",[52,125,119,126,129],{},[14,127,128],{},"Keyword"," to set a custom watch phrase or leave blank for server vanity.",[52,131,119,132,135],{},[14,133,134],{},"Channel"," to pick the log channel.",[52,137,138],{},"Confirm that the status button shows Vanity Roles as enabled.",[30,140,142],{"id":141},"before-you-begin","Before you begin",[144,145,146,155,162,173],"ul",{},[52,147,148,151,152,154],{},[14,149,150],{},"Custom Bot Required",": Tracking member custom statuses requires Discord's Presences feature, which is available exclusively on ",[14,153,57],{}," bots.",[52,156,157,158,161],{},"You need ",[14,159,160],{},"Manage Server"," to configure Vanity Roles.",[52,163,164,165,168,169,172],{},"Discortics needs ",[14,166,167],{},"Manage Roles"," and its role must be ",[14,170,171],{},"higher"," than the reward roles in the role list.",[52,174,164,175,178,179,182,183,186],{},[14,176,177],{},"View Channel",", ",[14,180,181],{},"Send Messages",", and ",[14,184,185],{},"Embed Links"," in the log channel.",[30,188,190],{"id":189},"how-status-matching-works","How status matching works",[11,192,193],{},"Discortics checks a member's custom status whenever they update it:",[144,195,196,202],{},[52,197,198,201],{},[14,199,200],{},"Server Vanity Link (Default)",": If you leave the keyword box blank, Discortics looks for your server's vanity invite code.",[52,203,204,207,208,210,211,214,215,218],{},[14,205,206],{},"Custom Keyword",": If you enter text in the ",[14,209,91],{}," box, Discortics looks for that phrase instead (case-insensitive, e.g. ",[18,212,213],{},"myserver.gg"," matches ",[18,216,217],{},"MyServer.GG",").",[30,220,222],{"id":221},"bot-tier-limits","Bot tier limits",[224,225,226,245],"table",{},[227,228,229],"thead",{},[230,231,232,236,240,243],"tr",{},[233,234,235],"th",{},"Feature",[233,237,239],{"align":238},"right","Free",[233,241,242],{"align":238},"Prime",[233,244,57],{"align":238},[246,247,248,262,275],"tbody",{},[230,249,250,254,257,259],{},[251,252,253],"td",{},"Vanity Roles per server",[251,255,256],{"align":238},"0",[251,258,256],{"align":238},[251,260,261],{"align":238},"25",[230,263,264,267,270,272],{},[251,265,266],{},"Custom status keyword",[251,268,269],{"align":238},"❌",[251,271,269],{"align":238},[251,273,274],{"align":238},"✅",[230,276,277,280,282,284],{},[251,278,279],{},"Custom announcement messages",[251,281,269],{"align":238},[251,283,269],{"align":238},[251,285,274],{"align":238},[30,287,289],{"id":288},"message-variables","Message variables",[11,291,292],{},"You can insert these placeholders into your announcement templates and Discortics will replace them automatically:",[224,294,295,305],{},[227,296,297],{},[230,298,299,302],{},[233,300,301],{},"Variable",[233,303,304],{},"What it shows",[246,306,307,321,331,341,351,361,371],{},[230,308,309,314],{},[251,310,311],{},[18,312,313],{},"{{user.mention}}",[251,315,316,317,320],{},"Mentions the member (e.g. ",[18,318,319],{},"@member",")",[230,322,323,328],{},[251,324,325],{},[18,326,327],{},"{{user.name}}",[251,329,330],{},"Member's username",[230,332,333,338],{},[251,334,335],{},[18,336,337],{},"{{user.avatarURL}}",[251,339,340],{},"Member's profile picture URL",[230,342,343,348],{},[251,344,345],{},[18,346,347],{},"{{server.name}}",[251,349,350],{},"Your server's name",[230,352,353,358],{},[251,354,355],{},[18,356,357],{},"{{server.memberCount}}",[251,359,360],{},"Total number of members in your server",[230,362,363,368],{},[251,364,365],{},[18,366,367],{},"{{vanity.statusText}}",[251,369,370],{},"The keyword or link being tracked",[230,372,373,378],{},[251,374,375],{},[18,376,377],{},"{{vanity.status}}",[251,379,380],{},"The full status text on the member's profile",[30,382,384],{"id":383},"command-reference","Command reference",[224,386,387,400],{},[227,388,389],{},[230,390,391,394,397],{},[233,392,393],{},"Command",[233,395,396],{},"Purpose",[233,398,399],{},"Required user permission",[246,401,402],{},[230,403,404,408,411],{},[251,405,406],{},[18,407,116],{},[251,409,410],{},"Configure vanity reward roles, keyword, and logs",[251,412,160],{},[30,414,416],{"id":415},"frequently-asked-questions","Frequently asked questions",[418,419,421],"h3",{"id":420},"why-does-vanity-roles-require-a-custom-bot","Why does Vanity Roles require a Custom bot?",[11,423,424],{},"Tracking Discord user presence updates across large servers requires dedicated bot resources and privileged Discord intents available only with a dedicated Custom bot instance.",[418,426,428],{"id":427},"can-i-match-multiple-keywords","Can I match multiple keywords?",[11,430,431,432,435],{},"Set the watch text to a shared phrase or domain (e.g. ",[18,433,434],{},"myserver","). Discortics checks if the member's custom status contains the text anywhere in their status message.",[418,437,439],{"id":438},"what-happens-when-a-member-removes-the-status-text","What happens when a member removes the status text?",[11,441,442],{},"Discortics automatically removes the configured vanity roles and posts an optional log in the configured log channel.",{"title":40,"searchDepth":444,"depth":444,"links":445},2,[446,447,448,449,450,451,452],{"id":32,"depth":444,"text":33},{"id":141,"depth":444,"text":142},{"id":189,"depth":444,"text":190},{"id":221,"depth":444,"text":222},{"id":288,"depth":444,"text":289},{"id":383,"depth":444,"text":384},{"id":415,"depth":444,"text":416,"children":453},[454,456,457],{"id":420,"depth":455,"text":421},3,{"id":427,"depth":455,"text":428},{"id":438,"depth":455,"text":439},"Quick setup",null,"Automatically reward members with special roles when they put your server link or keyword in their Discord status.",false,"md",{},true,8,"\u002Fguides\u002Fvanity-roles","3 min read",{"title":5,"description":460},"guides\u002Fvanity-roles","2026-09-01","c0v-Q3WAoaHgFtCFztwSnyr409P2_lOsowL3eC2gdl0",1788304621732]