Skip to content
Schedule Social Media

Press Esc to close.

New feature Discord Severity: low

Discord lets apps edit attachment descriptions and spoilers

Announced24 Jun 2026
Effective24 Jun 2026
StatusIn effect

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) and is_spoiler, via the attachment request objects in Edit Message.
  • Setting a spoiler: is_spoiler: true in the attachment request object.
  • Reading a spoiler: check the IS_SPOILER attachment flag. "The legacy SPOILER_ 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_spoiler instead of renaming files to SPOILER_, and detect spoilers with the IS_SPOILER flag.

Primary sources

Checked against the source 7 Nov 2026

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.