Discord Hyperlinks: Masked Links, Hiding the Preview, and Why Yours Is Not Clickable

Write [text](https://example.com) to turn words into a link on Discord. How masked links work, how to stop or hide the preview card, how to spoiler a link, and the mistakes that leave the brackets showing.

To make words into a clickable link on Discord, put the words in square brackets and the URL in parentheses right after:

[Read the rules](https://example.com/rules)

The message shows Read the rules as a link and hides the address. Discord calls this a masked link, and it is documented in the Markdown Text 101 help article: "include the text you want displayed in brackets and then the URL in parentheses".

This is the same syntax as a standard Markdown link, so links copied from a README or from ChatGPT output work as they are.

What you type What readers see
https://example.com/rules The URL as a link, usually with a preview card under the message
[Read the rules](https://example.com/rules) "Read the rules" as a link
<https://example.com/rules> The URL as a link with no preview card
||https://example.com/rules|| A spoiler bar. The link and its preview stay hidden until clicked.

They combine. [Read the rules](<https://example.com/rules>) is a masked link without a preview card.

  • No space between ] and (. [text] (url) shows the brackets.
  • The URL needs its scheme. [text](example.com) is not a link. Write https://example.com.
  • The link text can be formatted. [**Sign up here**](https://example.com) gives a bold link. Put the formatting inside the brackets.
  • Use words for the link text, not another web address. Something like [https://google.com](https://example.com) is the classic phishing pattern. Community servers have a suspicious link filter (Discord describes it in Why was my message not delivered?), and moderators remove links that disguise where they go.

Controlling the preview card

When a link is shared in a message, Discord visits the page to fetch its title, description and image and builds the preview card from that. Discord's link previews article explains this is done by a bot called Discordbot, and only when a link is actually posted.

Goal How
No preview for one link Wrap the URL in angle brackets: <https://example.com>
Hide link and preview behind a click Wrap it in spoiler bars: ||https://example.com||
Never see previews yourself User Settings > Text & Images, then turn off the option to show embeds for links posted in chat

The angle brackets are not in the Markdown help article, but they are official: Discord's How do I disable auto-embed? article gives it as a tip ("wrap the link in < > tags") and also describes the settings switch. The setting only changes what you see. The angle brackets change what everyone sees.

One exception, from Discord's Spoiler Tags article: server invite embeds cannot be hidden with spoiler tags. The invite card still shows.

If you own the website and the card looks wrong, the card comes from your page's Open Graph tags (og:title, og:description, og:image). If no card appears at all, check that your firewall is not blocking Discordbot. Its requests carry a User-Agent containing Discordbot, and Discord publishes its IP ranges for allow lists.

What you see Cause Fix
[text](url) shown with brackets A space between ] and (, or the URL has no https:// Remove the space, add the scheme
Brackets shown, inside a grey box The link is in a code block or inline code Move it outside the backticks
The link stops halfway through the URL The URL contains a space or a closing parenthesis (common with Wikipedia links) Replace spaces with %20 and ) with %29
Works in chat, not in a bot message Not every embed field renders Markdown. Masked links work in embed descriptions and field values. Move the link into the description or a field
The message was not delivered or was removed The server's AutoMod rules or the suspicious link filter caught the link Ask the moderators which links are allowed

Masked links work in message content the same way for bots and webhooks. For embeds, the embed object in Discord's developer documentation has a url field next to title. Set that to make the title a link rather than trying to put [text](url) in the title.

A related format that is not a hyperlink but looks like one: mentions. <#CHANNEL_ID> links to a channel, <@USER_ID> mentions a user and </name:COMMAND_ID> links a slash command. These are listed under Message Formatting in the developer docs.

More Discord formatting