# Discourse Spoiler-Alert
**URL:** https://meta.discourse.org/t/discourse-spoiler-alert/12650
**Category:** Plugin
**Tags:** official, spoiler-alert, included-in-core
**Created:** [February 12, 2014, 3:47am UTC](https://meta.discourse.org/t/discourse-spoiler-alert/12650 "2014-02-12T03:47:17Z")
**Posts on this page:** 13
**Page:** 1
### Author:  [@Discourse](https://meta.discourse.org/u/Discourse)
#### Post date: [February 12, 2014, 3:47am UTC](https://meta.discourse.org/t/discourse-spoiler-alert/12650/1 "2014-02-12T03:47:17Z")
| | | |
| --- | --- | --- |
| :discourse2: | **Summary** | **Discourse Spoiler Alert** provides the ability to hide content marked with a `[spoiler]` tag in posts. |
| š | **Install Guide** | **This plugin is bundled with Discourse core**. There is no need to install the plugin separately. |
> [@](#):
>
> :discourse2: As this is an #official plugin maintained by the Discourse team, #Support, #Contribute > Bug, #Contribute > UX, and #Contribute > Feature requests can be made in the respective categories here on Meta, and tagged with the appropriate plugin tag. Click on a link below to get one started. š
>
> [ā **Support**](https://meta.discourse.org/new-topic?category_id=6&body=%3E%20Before%20asking,%20did%20you%20search%20first%3F%20Press%20%F0%9F%94%8D%20at%20the%20upper%20right%20to%20search.&tags=spoiler-alert "Ask for support on configuring and using Discourse Spoiler Alert") [š **Bug**](https://meta.discourse.org/new-topic?category_id=1&tags=spoiler-alert "A bug report means something is broken, preventing normal/typical use of the plugin") [š **UX**](https://meta.discourse.org/new-topic?category_id=9&tags=spoiler-alert "Discussion about the user interface of Discourse Spoiler Alert, and how features are presented (including language and UI elements)") [š” **Feature**](https://meta.discourse.org/new-topic?category_id=2&tags=spoiler-alert "Discussion about how existing Discourse Spoiler Alert features can be improved or enhanced, and how proposed new features could work")
### Enabling Spoiler Alert
This plugin is default enabled once installed but can be disabled/enabled from its settings, accessed from your `admin/plugins` page:
### Features
Once enabled it adds a āBlur Spoilerā option to the ā menu in the composerās formatting bar. Simply highlight the text youād like to blur and select āblur spoilerā and it will wrap the selected text in the necessary `[spoiler]` tags:
#### Examples:
Inline:
```plaintext
[spoiler]This is a spoiler[/spoiler]
```
This is a spoiler
Multiline:
```plaintext
[spoiler]
I wanna be your vacuum cleaner
Breathing in your dust
I wanna be your Ford Cortina
I will never rust
If you like your coffee hot
Let me be your coffee pot
You call the shots
I wanna be yours
https://johncooperclarke.com/poems/i-wanna-be-yours
[/spoiler]
```
I wanna be your vacuum cleaner
Breathing in your dust
I wanna be your Ford Cortina
I will never rust
If you like your coffee hot
Let me be your coffee pot
You call the shots
I wanna be yours
[https://johncooperclarke.com/poems/i-wanna-be-yours](https://johncooperclarke.com/poems/i-wanna-be-yours)
Clicking on the blur will reveal the hidden text, and clicking again will re-blur it.
It also works for images:
(to re-blur an image that is large enough to generate a lightbox, you can click on the adjacent white space or refresh the page)
### Settings
| Name | Description |
| --- | --- |
| spoiler enabled | Enable the spoiler plugin. If you change this, you must rebake all posts with: ārake posts:rebakeā\[1\] |
> :discourse2: Hosted by us? This plugin is available on all of our hosting tiers [Spoiler Alert | Discourse - Civilized Discussion](https://www.discourse.org/plugins/spoiler.html)
* * *
1. :discourse2: If youāre a hosted customer of ours, please contact [team@discourse.org](mailto:team@discourse.org) if you have any questions about needing to ārebakeā due to a setting change
> Last edited by @tobiaseigen 2025-07-16T20:45:02Z
>
> > **Check document**
> >
> > Perform check on document:
---
### Author:  [@pfaffman](https://meta.discourse.org/u/pfaffman)
#### Post date: [October 24, 2023, 12:58pm UTC](https://meta.discourse.org/t/discourse-spoiler-alert/12650/109 "2023-10-24T12:58:57Z")
Moved to core:
[https://github.com/discourse/discourse/commit/89580ee379945c36283379d105517ba2f00ac6a7](https://github.com/discourse/discourse/commit/89580ee379945c36283379d105517ba2f00ac6a7)
---
### Author:  [@JammyDodger](https://meta.discourse.org/u/JammyDodger)
#### Post date: [October 24, 2023, 4:00pm UTC](https://meta.discourse.org/t/discourse-spoiler-alert/12650/110 "2023-10-24T16:00:27Z")
ā¹ **Discourse Spoiler Alert** has now been bundled with Discourse core, so this plugin will no longer need to be installed separately. š„³
If you self-host you should see some information on your dashboard about removing it from your `app.yml`.
> :discourse2: Hosted by us? This change will not affect you in any way. š You can continue to enjoy this plugin and not worry about a thing.
---
### Author:  [@ismailarilik](https://meta.discourse.org/u/ismailarilik)
#### Post date: [December 15, 2023, 9:10pm UTC](https://meta.discourse.org/t/discourse-spoiler-alert/12650/111 "2023-12-15T21:10:10Z")
I donāt understand why this plugin is enabled by default. Isnāt it only useful for movie forums?
---
### Author:  [@Jagster](https://meta.discourse.org/u/Jagster)
#### Post date: [December 15, 2023, 9:23pm UTC](https://meta.discourse.org/t/discourse-spoiler-alert/12650/112 "2023-12-15T21:23:14Z")
There are plenty of reason to hide text than movie spoilers. More than punchlines of jokes.
---
### Author:  [@Monikas](https://meta.discourse.org/u/Monikas)
#### Post date: [July 14, 2024, 5:01am UTC](https://meta.discourse.org/t/discourse-spoiler-alert/12650/113 "2024-07-14T05:01:52Z")
Is it possible to add a feature to show the spoiler content after clicking ālikeā on the post?
---
### Author:  [@ondrej](https://meta.discourse.org/u/ondrej)
#### Post date: [July 14, 2024, 6:16am UTC](https://meta.discourse.org/t/discourse-spoiler-alert/12650/114 "2024-07-14T06:16:29Z")
Youāre more than welcome to create a #Contribute > Feature #spoiler-alert topic š
---
### Author:  [@Monikas](https://meta.discourse.org/u/Monikas)
#### Post date: [July 14, 2024, 9:30am UTC](https://meta.discourse.org/t/discourse-spoiler-alert/12650/115 "2024-07-14T09:30:32Z")
š, Iām on my way.
---
### Author:  [@Mako-Poisoned](https://meta.discourse.org/u/Mako-Poisoned)
#### Post date: [March 7, 2025, 3:34am UTC](https://meta.discourse.org/t/discourse-spoiler-alert/12650/116 "2025-03-07T03:34:03Z")
Is there anyway to edit the contents of how the spoiler preview looks? The current implementation looks nice, but it doesnāt abstract enough as far as what itās spoiling.
Hereās an example from a thread I made, where users can upload their screenshots. If the screenshot is a spoiler, it needs to be tagged as such. As you can tell, the current implementation doesnāt really work in the context of spoiler tagging screenshots of critical moments in games, movies, etc.
Anyone who is familiar with the game I shared would immediately know what it is.
Image from my discourse board below.
Is there a way to adjust this?
**Edit:** Itās also come to my attention that if any user clicks the edit history of a post that contains spoilers, the edit history _will not_ spoiler tag the contents.
---
### Author:  [@NateDhaliwal](https://meta.discourse.org/u/NateDhaliwal)
#### Post date: [March 7, 2025, 4:41am UTC](https://meta.discourse.org/t/discourse-spoiler-alert/12650/117 "2025-03-07T04:41:36Z")
What are you planning to make it like? More blurry? A different color of the blur?
---
### Author:  [@Mako-Poisoned](https://meta.discourse.org/u/Mako-Poisoned)
#### Post date: [March 7, 2025, 4:42am UTC](https://meta.discourse.org/t/discourse-spoiler-alert/12650/118 "2025-03-07T04:42:25Z")
If I could, Iād either turn it completely black, or make it blurrier.
---
### Author:  [@Steven](https://meta.discourse.org/u/Steven)
#### Post date: [March 8, 2025, 4:58pm UTC](https://meta.discourse.org/t/discourse-spoiler-alert/12650/119 "2025-03-08T16:58:25Z")
Here is the default css for the blur part
```css
.spoiler-blurred img {
filter: blur(1em);
}
```
Change the 1em to something more important
```css
.spoiler-blurred img {
filter: blur(5em);
}
```
And if you want to blur more when the cursor is on the image, add these line and change the 0.5em (with a value less important than the one before)
```css
.spoiler-blurred {
.discourse-no-touch & {
&:hover, &:focus {
img {
filter: blur(0.5em);
}
}
}
}
```
---
### Author:  [@Luna\_Mora](https://meta.discourse.org/u/Luna_Mora)
#### Post date: [September 1, 2026, 6:08pm UTC](https://meta.discourse.org/t/discourse-spoiler-alert/12650/120 "2026-09-01T18:08:23Z")
Not sure if this is worth a separate bug report or not, but realized via a chat push notification that the spoiler text isnāt being redacted like it does for everything else ā `Chat::Message#push_notification_excerpt` truncates the raw markdown and will literally output the spoiler as `this is a chat notification [spoiler]and this is the spoiler[/spoiler]`, which kind of defeats the purpose of a spoiler tag, if it outputs the whole spoiler in the notification! š Seems like an oversight as it bypasses spoiler-alertās `:reduce_excerpt` completely for a chat message vs a forum post. It otherwise functions just fine in chat! itās the push notification thatās the problem.