How to Mark Spoilers on Discord: Text, Images, Links
November 11, 2026 · 9 min read
How to Mark Spoilers on Discord: Text, Images, Files and Links
Here's how to mark spoilers on Discord: wrap text in two vertical bars on each side, like ||Snape kills Dumbledore||, or select it and click the eye icon. For an image, video or file, click the eye icon on the attachment before you send. This guide covers desktop, iPhone and Android, plus the cases where Discord shows the spoiler anyway.
How to Mark Spoilers on Discord in a Text Message
There are three ways to do spoiler text on Discord, and all of them produce the same grey box. Discord's Spoiler Tags help page documents each one.
- Select and click. On desktop or in the browser, highlight the words in the message box. A small formatting bar appears, and its eye icon marks the selection as a spoiler.
- Type the bars yourself. Put
||before and after the text. This works on every platform, including Android, where Discord's help page lists no menu option for it. - Use the slash command. Type
/spoilerand then your message. Discord hides the whole message.
On iPhone and iPad there's a fourth route. Select the text in the message box, tap the selection to open the context menu, then tap Mark as Spoiler. Discord wraps the selection in bars for you.
||The killer is the narrator.||
Discord shows a solid grey box the length of the sentence until someone clicks or taps it.
How Do You Mark Only Part of a Message as a Spoiler?
The bars hide exactly what sits between them, so you can keep the context readable and hide only the reveal. You can also use several spoilers in one message.
Finished the finale last night. ||Rhea survives|| and ||the ship was never real||.
> My theory: ||the captain is her brother||
- Episode 9: ||the time skip||
The first line shows the normal words with two separate grey boxes. The quote and the list item keep their usual formatting, with only the wrapped words hidden.
That's why we prefer typing the bars over /spoiler. A fully hidden message tells readers nothing, so they either skip it or click it blind. One more detail from Discord's known issues list for the chat box: typing /spoiler doesn't preview the hidden style before you send.
If you'd rather click a button than count bars, our Discord text formatter has a Spoiler button and a chat-style preview, and you copy the finished message into Discord. For bold, headers, quotes and the rest of the syntax, see the Discord markdown cheat sheet.
How Do I Hide a Picture in Discord on Desktop?
Images need the most care, because a picture gives a twist away at a glance. On desktop or in the browser, you mark an image, video or other file as a spoiler before you send it. Discord blurs it in the chat until someone clicks it.
- Click the + button next to the message box and pick your file, or drag the file into the chat.
- The file appears as a preview above the message box. Hover over it to show its small toolbar.
- Click the eye icon. The preview blurs, which means it's marked.
- Type a message if you want one, then press Enter.
In current desktop builds there's a second route through the same toolbar. The pencil icon opens an edit window for the attachment, which includes a Mark as spoiler checkbox. Tick it and save. In a multi-file message, you mark each attachment separately.
The eye icon covers the file, not the words you type with it. If your caption says what's in the picture, wrap that text in bars too, or it gives the twist away above the blurred image.
Marking Images and Videos as Spoilers on iPhone and Android
Some older guides call attachment spoilers a desktop-only feature, but the iPhone and Android apps can mark files too. Discord's help page doesn't spell out the mobile steps, and labels shift a little between app versions, but the flow in current builds looks like this:
- Tap the + button beside the message box and choose your photo or video.
- The file shows as a thumbnail above the message box. Tap the thumbnail to open its options.
- Turn on Mark as spoiler, then close the panel.
- Send the message. The thumbnail in the chat appears blurred.
For text on mobile, type the bars by hand on both platforms. iOS also offers the Mark as Spoiler item in the text selection menu, as described above. If an option looks missing, update the app first.
Hiding Links and Embed Previews Behind a Spoiler
To hide a link, put the bars around the full URL. Discord's help page says this works on desktop and mobile alike.
New trailer is out: ||https://www.youtube.com/watch?v=example||
Readers see the sentence and a grey box where the address would be. Clicking the box reveals the link.
There's one documented exception. Discord says server invite embeds can't be hidden with spoiler tags, so the invite card shows even when the invite link sits inside bars. If the server name itself is the spoiler, describe it in words and send the invite later.
Why Isn't My Discord Spoiler Working?
Usually it's one of these:
- It's inside code. Discord states that spoiler bars inside a code block aren't hidden. Inline code in single backticks behaves the same way, so the bars show as typed. The
ansiblocks used for Discord text color are code blocks too. - The bars don't match. You need exactly two bars on each side. A missing bar leaves the text and the bars visible.
- It's a server invite. The invite embed always shows, as covered above.
- The caption gave it away. Spoilering an image doesn't hide the text sent with it.
- The reader turned spoilers off. Someone with Show spoiler content set to Always sees everything. So do moderators who chose the moderator option, in servers where they have Manage Messages.
- You used Reddit's marker. Discord doesn't treat
>!text!<as a spoiler. That syntax belongs to Reddit, as our Reddit formatting guide explains. For each platform's marker side by side, see our Markdown spoiler syntax comparison. - The file was already sent. Discord's help page only describes marking attachments before you send. If your app shows no spoiler option when you edit the message, delete it and re-send with the eye icon on.
Text is easier to fix. Edit the message, add the bars and save, and the spoiler applies to everyone who hasn't read it yet. That's the honest limitation of spoiler tags: they protect future readers, never the people who saw the original.
Bots get one more option. Discord's API changelog for June 24, 2026 says apps mark an attachment as a spoiler with is_spoiler: true, and can now change it on existing attachments by editing the message. The older SPOILER_ file name prefix still works, though Discord now calls it legacy.
The code rule has a handy side effect. To show someone the syntax without triggering it, put it in backticks: ||like this|| stays visible as typed.
Revealing, Re-hiding and Turning Off Spoilers for Yourself
Click a grey box on desktop, or tap it on mobile, to reveal it. To hide it again, Discord's help page gives one method: leave the channel and come back, and every spoiler you opened there is hidden again.
You can also change how spoilers appear for you. Discord's help page puts this setting, labelled Show spoiler content in the app, under User Settings, Text & Images. The section name can differ in newer builds. It has three choices:
| Option | What you see |
|---|---|
| On click | Every spoiler stays hidden until you click it (the default behaviour) |
| On servers I moderate | Spoilers show automatically where you have a role with Manage Messages |
| Always | No spoilers are hidden for you anywhere |
Per Discord, you can only change this on the desktop app or in the browser. Your choice affects only your own view, not anyone else's.
Spoiler Channels: Hiding a Whole Conversation
When an entire discussion is a spoiler, such as a channel for a new season, tagging every message gets tedious. A spoiler channel hides everything in it until each member opts in. Per the Spoiler Channels FAQ, text, voice, forum and announcement channels all qualify.
To set one up on desktop or in a browser:
- Click the Edit Channel gear icon next to the channel name.
- On the Overview tab, find Content Visibility.
- Turn on Spoiler Channel and click Save Changes.
The first time a member opens the channel, Discord shows a notice with the channel name and topic. They can continue or go back, and they won't see the notice again after opting in. Write a clear channel topic, because it's the only hint they get.
Spoiler channels aren't age-restricted channels. They don't trigger age verification, and Discord says sexually explicit content still needs the age-restricted label.
That's how to mark spoilers on Discord for every kind of message. Use bars or the eye icon for text, the attachment eye icon or mobile toggle for files, and bars around URLs. Save spoiler channels for whole discussions. Our editor doesn't render Discord spoilers, since the bars aren't standard Markdown. Draft it in the Discord text formatter instead, check the preview, then paste it into Discord.