Discord lets apps edit attachment descriptions and spoilers
What changed
On June 24, 2026 Discord let apps edit the description and is_spoiler parameters on existing attachments when editing messages, and split the attachment request object out in the docs. Attachments can be marked as spoilers with is_spoiler: true, and apps can read the IS_SPOILER attachment flag. The legacy SPOILER_ filename prefix still marks a spoiler, but not all spoilered attachments have the prefix.
What it means
Apps can change the alt text and spoiler setting of a file already posted, without deleting and re-posting the message.
Who is affected
Bots and scheduling tools that post images or files to Discord and want to fix alt text or spoilers later.
What to do by 24 Jun 2026
Optional. Send description and is_spoiler in the attachment request objects when editing a message, and read the IS_SPOILER attachment flag instead of relying on the SPOILER_ filename prefix.
What this means for you
Alt text is a short description of a picture for people who can't see it. A spoiler hides a picture until someone taps it. Tools can now fix both on a Discord post after it is published, instead of deleting the post and starting again.
The details
- Editable on existing attachments:
description(alt text) andis_spoiler, via the attachment request objects in Edit Message. - Setting a spoiler:
is_spoiler: truein the attachment request object. - Reading a spoiler: check the
IS_SPOILERattachment flag. "The legacySPOILER_filename prefix will continue to mark attachments as a spoiler, but not all spoilered attachments have the prefix." - Docs: the attachment request object is now documented separately from the attachment object, to show which fields apps can set.
What to do next
- Business owners: Nothing.
- Marketers and agencies: Alt text on Discord images can now be corrected after posting, if your tool supports it.
- Developers: Use
is_spoilerinstead of renaming files toSPOILER_, and detect spoilers with theIS_SPOILERflag.
Primary sources
- Discord Developer change log: Attachment Editing and is_spoiler Param (June 24, 2026)
- Discord Developer docs: Attachment request structure
Get an email when a new API change is added
Follow new entries with the RSS feed. Each platform also has its own feed, for example X or Meta.