<@USER_ID><\/code>. Most Discord libraries make this even easier with properties like user.toString()<\/code> in Discord.js or member.mention<\/code> in discord.py. Always be careful with permissions, user input, and allowed mentions<\/em> so your bot does not spam or ping people unintentionally. For slash commands, the cleanest method is to accept a user option and include that selected user in the bot\u2019s reply.<\/p>\nHow Discord Mentions Work<\/h2>\n
Discord mentions are special text patterns that Discord converts into clickable, highlighted references. When you type @username<\/code> in the Discord app, Discord internally stores that as a mention using the user\u2019s unique ID. A user mention looks like this:<\/p>\n<@123456789012345678><\/code><\/pre>\nThe long number is the user\u2019s Discord user ID<\/strong>. Unlike usernames, user IDs do not change. That makes them the safest way for bots to refer to specific people. When your bot sends a message containing that mention format, Discord displays it as a normal mention and may notify the user, depending on their notification settings and the message\u2019s allowed mentions.<\/p>\nThere are several mention formats worth knowing:<\/p>\n
\n- User mention:<\/strong>
<@USER_ID><\/code><\/li>\n- Legacy nickname mention:<\/strong>
<@!USER_ID><\/code><\/li>\n- Role mention:<\/strong>
<@&ROLE_ID><\/code><\/li>\n- Channel mention:<\/strong>
<#CHANNEL_ID><\/code><\/li>\n<\/ul>\nFor modern bots, <@USER_ID><\/code> is usually the right format for mentioning users. Many libraries also provide a convenient mention property, which is safer and easier than manually building the string.<\/p>\n![\"\"](\"https:\/\/resizemyimg.com\/blog\/wp-content\/uploads\/2026\/06\/pink-and-black-hello-kitty-clip-art-discord-chat-bot-mention-user.jpg\")
\nMentioning a User with Discord.js<\/h2>\n
If you are building your bot with Discord.js<\/strong>, mentioning users is straightforward. Discord.js objects often convert to mention strings automatically. For example, if you have a User<\/code> or GuildMember<\/code> object, you can include it directly in a message template.<\/p>\nHere is a simple example using a slash command where the bot mentions the user who ran the command:<\/p>\n
await interaction.reply(`Hello ${interaction.user}!`);<\/code><\/pre>\nIn Discord.js, interaction.user<\/code> becomes a mention-like string when placed inside a template literal. You can also be more explicit:<\/p>\nconst userId = interaction.user.id;\nawait interaction.reply(`Hello <@${userId}>!`);<\/code><\/pre>\nBoth approaches can work, but using the library\u2019s built-in user object is usually cleaner. If you want your bot to mention another user selected from a slash command option, you can do something like this:<\/p>\n
const target = interaction.options.getUser('user');\n\nawait interaction.reply(`Hey ${target}, ${interaction.user} wanted to get your attention!`);<\/code><\/pre>\nThis is one of the most common patterns: the command user selects a target, and the bot mentions that target in the response.<\/p>\n
Creating a Slash Command with a User Option<\/h2>\n
A good user mention command should avoid asking people to type raw IDs. Instead, let Discord handle user selection through slash command options. This provides a friendlier interface and reduces mistakes.<\/p>\n
In Discord.js v14, a command definition might look like this:<\/p>\n
const { SlashCommandBuilder } = require('discord.js');\n\nmodule.exports = {\n data: new SlashCommandBuilder()\n .setName('poke')\n .setDescription('Mention a user with a friendly poke')\n .addUserOption(option =>\n option\n .setName('user')\n .setDescription('The user to mention')\n .setRequired(true)\n ),\n\n async execute(interaction) {\n const target = interaction.options.getUser('user');\n\n await interaction.reply(`\ud83d\udc4b ${target}, you have been poked by ${interaction.user}!`);\n }\n};<\/code><\/pre>\nThis creates a \/poke<\/code> command where users can choose someone from the server. The bot then replies with a message that mentions both the target and the person who used the command.<\/p>\nThis approach is especially useful because Discord validates the selected user for you. You do not have to parse usernames, handle typos, or search through server members manually.<\/p>\n
Mentioning Users with discord.py<\/h2>\n
If you prefer Python, discord.py<\/strong> offers a similarly simple way to mention users. Most user and member objects have a .mention<\/code> property.<\/p>\nFor a traditional prefix command, you might write:<\/p>\n
from discord.ext import commands\nimport discord\n\nbot = commands.Bot(command_prefix=\"!\", intents=discord.Intents.default())\n\n@bot.command()\nasync def hello(ctx, member: discord.Member):\n await ctx.send(f\"Hello {member.mention}, {ctx.author.mention} says hi!\")<\/code><\/pre>\nWith this command, a user can type something like:<\/p>\n
!hello @Alex<\/code><\/pre>\nThe bot responds by mentioning Alex and the command author. The important part is member.mention<\/code>, which gives you the correct mention string automatically.<\/p>\nFor slash commands in discord.py, the code can look different depending on whether you are using the built-in app commands system or an extension. A simplified example using app_commands<\/code> looks like this:<\/p>\nfrom discord import app_commands\nimport discord\n\nclass MyClient(discord.Client):\n def __init__(self):\n super().__init__(intents=discord.Intents.default())\n self.tree = app_commands.CommandTree(self)\n\nclient = MyClient()\n\n@client.tree.command(name=\"wave\", description=\"Wave at a user\")\n@app_commands.describe(member=\"The user to mention\")\nasync def wave(interaction: discord.Interaction, member: discord.Member):\n await interaction.response.send_message(\n f\"\ud83d\udc4b Hello {member.mention}, {interaction.user.mention} is waving at you!\"\n )<\/code><\/pre>\nAs with Discord.js, the best practice is to accept a real user or member option instead of plain text.<\/p>\n![\"\"](\"https:\/\/resizemyimg.com\/blog\/wp-content\/uploads\/2026\/06\/black-laptop-computer-turned-on-displaying-blue-screen-programming-discord-bot-python-javascript.jpg\")
\n
User Mentions vs Member Mentions<\/h2>\n
In Discord development, the difference between a User<\/strong> and a Member<\/strong> matters. A user is a global Discord account. A member is that user inside a specific server, including server-specific details such as nickname, roles, join date, and permissions.<\/p>\nIf your bot only needs to mention someone, a user object is usually enough. But if your bot needs to check roles, moderation status, or server permissions before mentioning them, you probably need a member object.<\/p>\n
For example, a moderation bot might only allow staff members to use a command that mentions a user. In that case, the bot should examine the command author\u2019s guild member permissions before sending the message.<\/p>\n
Using Allowed Mentions Safely<\/h2>\n
One of the most important concepts when making bots mention users is allowed mentions<\/strong>. Discord allows developers to control which mentions are actually parsed and pinged. This is crucial when your bot repeats user-generated content.<\/p>\nImagine someone types this into a command:<\/p>\n
\/say hello @everyone<\/code><\/pre>\nIf your bot blindly repeats that message, it might ping the entire server. That can annoy members, violate server rules, and get your bot removed. Allowed mentions help prevent this.<\/p>\n
In Discord.js, you can restrict mentions like this:<\/p>\n
await interaction.reply({\n content: `Message for ${target}`,\n allowedMentions: {\n users: [target.id],\n roles: [],\n parse: []\n }\n});<\/code><\/pre>\nThis tells Discord that only the specific target user should be mentioned. It prevents accidental parsing of other mentions in the message.<\/p>\n
In discord.py, you can use discord.AllowedMentions<\/code>:<\/p>\nawait ctx.send(\n f\"Message for {member.mention}\",\n allowed_mentions=discord.AllowedMentions(users=True, roles=False, everyone=False)\n)<\/code><\/pre>\nIf your bot sends content provided by users, you should almost always think about allowed mentions. It is a small detail that can prevent big problems.<\/p>\n
Getting a User ID<\/h2>\n
Sometimes you may need to manually build a mention from a user ID. To get a user ID from Discord, enable Developer Mode<\/strong> in your Discord settings. Then right-click a user and choose Copy User ID<\/strong>.<\/p>\nOnce you have the ID, you can create a mention like this:<\/p>\n
<@123456789012345678><\/code><\/pre>\nHowever, manually storing user IDs should be done thoughtfully. If your bot saves IDs in a database for reminders, points, warnings, or subscriptions, make sure you store only what you need and respect user privacy. User IDs are not secret passwords, but they are still persistent identifiers.<\/p>\n
Common Reasons Mentions Do Not Work<\/h2>\n
If your bot sends the mention text but it does not ping or display correctly, there are several possible causes:<\/p>\n
\n- The ID is wrong:<\/strong> A single incorrect digit means Discord cannot identify the user.<\/li>\n
- The format is incorrect:<\/strong> Use
<@USER_ID><\/code>, not just @USER_ID<\/code>.<\/li>\n- Allowed mentions are disabled:<\/strong> Your code may be preventing mentions from being parsed.<\/li>\n
- The bot lacks permission to send messages:<\/strong> It must be able to post in the channel.<\/li>\n
- The reply is ephemeral:<\/strong> Ephemeral slash command replies are only visible to the command user.<\/li>\n
- The user cannot see the channel:<\/strong> A ping is not very useful if the target cannot access the conversation.<\/li>\n<\/ul>\n
Also remember that users can customize notification settings. Even if the mention is valid, the user may not receive a push notification if they have muted the server or adjusted their notification preferences.<\/p>\n![\"\"](\"https:\/\/resizemyimg.com\/blog\/wp-content\/uploads\/2026\/06\/app-cleaner-and-uninstaller-options-on-dark-background-discord-settings-permissions-notifications.jpg\")
\n
Making Mentions Feel Natural<\/h2>\n
A bot that constantly pings people can become irritating quickly. The best Discord bots use mentions with purpose. Instead of mentioning users in every message, mention them when attention is genuinely needed.<\/p>\n
For example, this is useful:<\/p>\n
\u2705 <@123456789012345678>, your support ticket has been updated.<\/code><\/pre>\nThis is probably too noisy:<\/p>\n
<@123456789012345678> you used a command!\n<@123456789012345678> processing command!\n<@123456789012345678> command complete!<\/code><\/pre>\nA good rule is to mention users for actionable<\/em> messages. If the user needs to respond, review something, claim a prize, or handle a task, a mention makes sense. If the message is just informational, consider using plain text or an embed without a ping.<\/p>\nUsing Embeds with Mentions<\/h2>\n
Many bots use embeds because they look cleaner than plain text messages. You can include mentions in embed descriptions and fields, but be aware that mention behavior can vary depending on where the mention appears and how allowed mentions are configured.<\/p>\n
In Discord.js, you might write:<\/p>\n
const { EmbedBuilder } = require('discord.js');\n\nconst embed = new EmbedBuilder()\n .setTitle('Task Assigned')\n .setDescription(`${target} has been assigned a new task.`)\n .setColor(0x5865F2);\n\nawait interaction.reply({\n content: `${target}`,\n embeds: ,\n allowedMentions: { users: [target.id] }\n});<\/code><\/pre>\nPutting the mention in content<\/code> as well as the embed is a common technique when you want to ensure the user is actually notified. The embed then provides the richer details.<\/p>\nBest Practices for Mention Commands<\/h2>\n
Before adding mention features to your bot, consider these practical guidelines:<\/p>\n
\n- Use user options:<\/strong> Let Discord\u2019s interface handle user selection.<\/li>\n
- Limit mass mentions:<\/strong> Avoid allowing regular users to make the bot ping large groups.<\/li>\n
- Validate permissions:<\/strong> Check whether the command author is allowed to mention someone for that purpose.<\/li>\n
- Use allowed mentions:<\/strong> Prevent accidental
@everyone<\/code>, role, or unwanted user pings.<\/li>\n- Respect context:<\/strong> Do not mention users in channels they cannot access.<\/li>\n
- Avoid spam:<\/strong> Add cooldowns to commands that ping people.<\/li>\n<\/ol>\n