How to Add a Spoiler on Discord: Text, Images, and Links
Discord's spoiler tag lets you hide content behind a clickable blur — useful for hiding plot details, surprise announcements, sensitive topics, or anything your server members might want to opt into rather than see automatically. Here's exactly how it works across every platform and content type.
What a Spoiler Tag Actually Does
When you mark something as a spoiler on Discord, it appears as a dark grey or black block to anyone reading the message. The content stays hidden until a reader deliberately clicks or taps on it. This applies to text, images, attachments, and links.
Spoilers work the same way across desktop, browser, and mobile — though the method for applying them differs slightly depending on your platform.
How to Add a Spoiler Tag to Text
Method 1: Markdown Syntax (Works Everywhere)
The most reliable way to add a spoiler is using Discord's double vertical bar syntax:
||Your hidden text goes here|| Type two pipe characters (||) before and after any text you want to hide. This works on desktop, browser, and mobile — anywhere you can type in Discord.
Example:
The killer was ||the butler||. That renders the words "the butler" as a hidden spoiler block.
You can wrap a single word, a full sentence, or an entire paragraph — just make sure both sets of || are on the same line for short content. Multi-line spoilers are supported by wrapping the entire block.
Method 2: Right-Click Menu on Desktop
On Discord's desktop or browser app:
- Type your message in the text box
- Highlight the text you want to hide
- A small formatting toolbar appears above the selection
- Click the eye icon (labeled "Mark as Spoiler")
- Discord automatically wraps the selected text in
||tags
This is the visual approach — useful if you don't want to remember the syntax.
Method 3: Mobile Tap Menu
On iOS or Android:
- Type your text in the message box
- Long-press to highlight the word or phrase
- Tap the three-dot menu (
...) or "More" option in the text toolbar - Select "Mark as Spoiler"
The pipe characters appear automatically in the input field.
How to Add a Spoiler to an Image or File 🖼️
Text syntax doesn't apply to attachments, so the process is different.
On Desktop (Windows/Mac/Linux)
- Click the plus (+) icon next to the message box to attach a file
- Select your image or file
- Before sending, check the "Mark as Spoiler" checkbox in the upload preview window
- Send as normal
The image will appear blurred to viewers until clicked.
On Mobile
- Tap the plus (+) or attachment icon
- Select your image
- In the preview screen, tap the image thumbnail
- Toggle the "Mark as Spoiler" option
- Send
Note: If you drag and drop a file directly into the chat on desktop, the same upload preview dialog appears where you can check the spoiler box before confirming.
Spoiler Syntax for Links
If you want to hide a URL inside a spoiler, wrap it the same way as text:
||https://example.com|| However, Discord embeds (the link previews that auto-generate) may still load depending on server settings. To hide both the link text and suppress the embed, you can combine the spoiler tag with Discord's embed suppression by wrapping the URL in < > first:
||<https://example.com>|| This hides the text and prevents the preview from loading.
Variables That Affect How Spoilers Behave
Not every Discord setup handles spoilers identically. A few factors shape the experience:
| Variable | How It Affects Spoilers |
|---|---|
| Client version | Older or third-party clients may not render spoiler blocks correctly |
| Accessibility settings | Some screen readers announce spoiler content without requiring a click |
| Server vs. DMs | Spoilers work in both, but server admins can't disable the feature selectively |
| Explicit content filters | Server-level filters may still flag spoiler-tagged images before they're viewed |
| Mobile OS version | Older Android/iOS app versions may lack the tap-to-spoiler UI option |
Common Mistakes and Edge Cases
Forgetting to close the tag — If you type ||text without a closing ||, Discord treats it as plain text. Both sets of pipes must be present.
Spoilers inside code blocks — Markdown spoiler syntax doesn't render inside backtick code blocks (` or triple backticks). The || will display literally rather than creating a spoiler.
Partial word wrapping — You can wrap part of a word, but visually it looks awkward. Most users wrap full words or phrases for readability.
Nested spoilers — Discord doesn't support spoilers nested inside other spoilers. Only the outermost || pair takes effect.
How Spoiler Visibility Works for the Reader
When someone receives a spoiler-tagged message:
- On desktop/browser, a single click reveals the content
- On mobile, a single tap reveals it
- The reveal is local only — it doesn't notify the sender or other users
- Refreshing the page or app will re-hide the spoiler 🔄
Some users configure Discord's "Show Spoiler Content" setting (found under Settings → Text & Images) to always display spoilers automatically without needing to click — which matters if you're writing for an audience that may have that toggle enabled.
Whether you're managing a gaming server, a film discussion community, or just keeping surprises intact in a group chat, the method you reach for — markdown syntax, right-click menu, or the mobile toolbar — depends on your device, how you type, and how often you're applying spoilers. Each approach gets to the same result, but the friction varies enough that your usual workflow and platform will likely point you toward one naturally.