Instagram media_publish config_issue CAPTION_NOT_ATTACHED

A media_publish call can succeed with the caption dropped. The response then carries config_issue CAPTION_NOT_ATTACHED. What it means and a burned-in fallback.

4 min readSume
All posts

config_issue: CAPTION_NOT_ATTACHED means the media published without its caption. The changelog says the publish still succeeds, the field is omitted when there is nothing to report, and the issue arises most often when the caption fails an integrity check. Treat it as a warning to check, not an error to retry blindly.

Instagram details are from the Instagram platform changelog, dated Sep 28, 2026, read 2026-09-30.

What values can config_issue return?

Non-blocking publish issues from the Meta changelog dated 2026-09-28, read 2026-09-30.
ValueMeaning
CAPTION_NOT_ATTACHEDThe media published without its caption
USER_TAGGING_FAILUREThe media published without its user tags
(field absent)Nothing to report

Why does a caption get dropped?

The page names a failed integrity check as the most common cause and does not list the checks. Review the caption text for what a platform might reject, and compare the post afterward instead of assuming it matches your request.

How do I keep key text on screen anyway?

Text burned into the video is part of the file, so it does not depend on the caption field. Sume video captions accept cues with text, start and end; a silent clip fails as caption_no_speech unless you pass authored overlay cues. See Video captions. Burned text does not replace the post caption; it only keeps a message in the picture.

How do I check what was published?

Extract a still from your own output and look at it before posting. Frame extraction is unbilled per the Video frames docs. For the AI-disclosure parameter on the same publish flow, see is_ai_generated on Reels.

Sources

Related posts

More in Developers

All Developers posts

Written by Sume