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.
The four kinds of link in a Discord message
| 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.
Masked link rules
- No space between
]and(.[text] (url)shows the brackets. - The URL needs its scheme.
[text](example.com)is not a link. Writehttps://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.
Why your link is not clickable
| 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 |
Links in bot and webhook messages
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
- Discord text formatting cheat sheet: every option on one page
- Discord Text Formatter: write a message with links and preview it
- Discord Spoiler Text Generator: hide text or links behind a click
- How to strikethrough on Discord, code blocks, small and big text