Discord Spoiler Text Generator
Discord spoilers hide text behind a bar until someone clicks or taps it. The syntax is two pipe characters on each side of the hidden text. This guide explains the three spoiler modes, the character cost of each one, and how to spoil an image instead of a message.
How Discord spoilers work
A Discord spoiler is text wrapped in double pipes: `||hidden text||`. The message shows a gray bar in place of the text. Clicking the bar reveals it on desktop, and tapping reveals it on mobile.
Spoilers work in regular message text and in places that accept Discord markdown, such as forum posts and most embed descriptions. They do not work inside code blocks, where the pipes stay literal. Embed titles are plain text, so spoilers there are not an option.
A spoiler is a visual hide, not a security feature. Anyone who clicks can read it, and some screen readers may announce the content even when it looks hidden. Do not use spoilers for passwords, private links, or anything that would cause harm if revealed.
Whole text, per word, or per letter
Whole text mode wraps the entire message in one pair of spoiler tags. It is the cleanest option for a sentence, a paragraph, or a punchline. One click reveals everything at once.
Per word mode wraps each word separately and leaves the spaces between them visible. The message looks like a row of small spoiler bars instead of one long bar. It takes more clicks to read, which can be useful for a guessing game or a slow reveal. It also adds four pipe characters around every word.
Per letter mode wraps every visible character. The result looks like a dense strip of tiny spoiler segments. It is the most dramatic option and the most expensive in character count. Long messages can pass the message limit quickly because each letter gets its own pair of pipes.
Worked examples
Start with a short message: `Game over`. Here is what each mode produces before you paste it into Discord.
Whole: ||Game over|| Words: ||Game|| ||over|| Letters: ||G||||a||||m||||e|| ||o||||v||||e||||r||
Reading the output
In whole text mode, the reader sees one bar and reveals the full phrase. In per word mode, the space stays visible, so the reader can see that there are two hidden words. In per letter mode, the spaces between words remain, but every letter is its own spoiler.
The per-letter output is valid Discord markdown in most clients, but adjacent spoiler tags can render differently as clients update their markdown parsers. If a letter mode result looks wrong, switch to per word. It is more predictable and easier to read.
Character limits and pipe overhead
Discord's standard message limit is 2,000 characters at the time of writing, and Nitro raises it to 4,000. Spoiler pipes count toward that limit. The counter above the output includes them, and the pipe count shows how much of the message is syntax rather than text.
Whole text mode adds four pipe characters in total. Per word mode adds four per word. Per letter mode adds four per visible character, so it can multiply the length of a message several times over. A paragraph that fits easily in a normal message may need to be shortened or split before per-letter mode will send.
If you hit the limit, remove punctuation, use whole text mode, or split the message into two spoilers. Adding a second message is usually cleaner than cramming a long reveal into one.
How to spoil an image on Discord
Text spoilers do not hide attachments. To spoil an image on desktop, attach it to a message and look for the Mark as spoiler option in the upload preview before you send. The exact placement of that control changes between Discord updates, so look for a spoiler or eye icon near the attachment.
On mobile, select the image, open the attachment preview, and use the spoiler option before sending. Again, the wording and icon placement vary by app version. The image should appear blurred or covered in the sent message, and other members can tap it to reveal.
If you upload through a bot or webhook, prefix the filename with `SPOILER_`. Discord treats that prefix as a request to spoil the attachment. The prefix is not visible in the message, but it stays part of the uploaded filename.
Do not try to spoil an image by typing `||` around a link. Discord does not blur the preview that way. Use the upload spoiler control or the filename prefix.
When spoilers help
Spoilers fit plot discussion, event results, giveaway answers, and content that members may not want to see without warning. They also work for punchlines and surprise announcements in chat.
Do not use spoilers to hide slurs, spam, or rule-breaking content. Moderators can reveal the text, and a spoiler does not make the content acceptable. If a message would break the rules in the open, it breaks them behind a spoiler too.
For content warnings, put a short visible label before the spoiler, such as `Episode 8 spoilers:` and then the hidden text. A reader deserves to know what they are about to reveal.
Troubleshooting
If the pipes show as plain text, check that you have two pipes on each side and that the message is not inside a code block. A missing pipe, an extra space, or a line break in the wrong place can break the syntax.
If a spoiler closes too early, the hidden text probably contains a pair of pipes. Discord reads the first closing pair it finds. Remove the pipes from the middle of the text or split the spoiler into two sections.
If nesting one spoiler inside another does not work, that is expected. Discord does not support nested spoilers in a reliable way. Keep each spoiler as a single layer.
If per-letter mode looks broken, try per-word mode. Adjacent spoiler tags are sensitive to client parsing, and per-word output is easier to read even when it works.
If a spoiler does not reveal on a tap, try clicking it with a mouse or opening the message in the desktop app. Mobile gesture handling can vary, especially in older app versions.
Accessibility and privacy
Spoilers can be awkward for screen reader users. Some readers announce hidden text without the visual bar, and others read the pipe characters aloud. If the hidden text is important, add a visible summary so the meaning does not depend on the reveal interaction.
Treat a spoiler as a courtesy, not a lock. Anyone can reveal it, and anyone can screenshot it. For genuinely private information, use a direct message or a private channel with the right permissions instead.
Explore more discord tools on Tolz.me.