Instagram error 36004: Caption is too long (2207010)
Last verified against Meta for Developers - Messenger Platform error codes
The submitted image's caption was {submitted-caption-length} characters long. The maximum number of characters permitted for a caption is {maximum-caption-length}. Please submit media with a shorter caption.What error 36004 means
Code 36004 with subcode 2207010 rejects the container because the caption exceeds Instagram's limits. Meta's recommended solution spells them out: a maximum of 2,200 characters, 30 hashtags and 20 @ tags. The error message itself reports the length it measured and the maximum allowed, so you can see exactly how far over you are.
Character counting is where most apps go wrong. A caption that is 2,150 characters in your database can exceed the limit once it is URL-encoded incorrectly, once emoji and other multi-unit characters are counted differently from your own length function, or once your template appends a signature or link block at publish time. Captions copied from other platforms also tend to carry long hashtag blocks that push past the 30-hashtag ceiling on their own.
Nothing about the media is wrong. Shorten the caption and create the container again; the failed attempt leaves nothing to reuse.
What it looks like
{
"error": {
"type": "OAuthException",
"code": 36004,
"error_subcode": 2207010,
"error_user_msg": "The submitted image's caption was 2412 characters long. The maximum number of characters permitted for a caption is 2200. Please submit media with a shorter caption.",
"fbtrace_id": "LmP3cXw9TfHq2Ud"
}
}Why it happens
- The caption text is over 2,200 characters after any template additions.
- The caption contains more than 30 hashtags.
- The caption mentions more than 20 accounts with @ tags.
- Double-encoding or escaped line breaks inflated the length that reached the API.
How to fix Instagram error 36004
- 1Read the measured and maximum lengths from the error message to see how much to cut.
- 2Count characters in your app the same way users perceive them, including emoji, and cap input at 2,200.
- 3Trim hashtags to 30 or fewer and @ mentions to 20 or fewer.
- 4Send the caption once-encoded in a JSON body or form field rather than hand-building query strings.
- 5Create a new container with the shortened caption.
How to stop it recurring
Enforce the three caption ceilings in your composer with live counters, and apply them again server-side after templates and signatures are appended. Count hashtags and mentions with the same parser Instagram users would expect. Too many @ tags in the separate user_tags parameter fails with 100/2207040.
Official reference: Meta for Developers - Messenger Platform error codes. See all Instagram error codes or the Instagram limits and quotas.
Related codes
- 100: Too many @ tags on the media (2207040)Cannot use more than {max-tag-count} tags per created media.
- 100: Unknown media type (2207023)The media type {media-type} is unknown.
- 36003: Image aspect ratio cannot be published (2207009)The submitted image with aspect ratio {submitted-ratio} cannot be published.…
Error 36004 - quick answers
What does Instagram error 36004 mean?
Code 36004 with subcode 2207010 rejects the container because the caption exceeds Instagram's limits. Meta's recommended solution spells them out: a maximum of 2,200 characters, 30 hashtags and 20 @ tags. The error message itself reports the length it measured and the maximum allowed, so you can see exactly how far over you are. Character counting is where most apps go wrong.
How do I fix Instagram error 36004?
1. Read the measured and maximum lengths from the error message to see how much to cut. 2. Count characters in your app the same way users perceive them, including emoji, and cap input at 2,200. 3. Trim hashtags to 30 or fewer and @ mentions to 20 or fewer. 4. Send the caption once-encoded in a JSON body or form field rather than hand-building query strings. 5. Create a new container with the shortened caption.
Should I retry after error 36004?
No. Retrying the same request produces the same error; the condition has to be fixed first. Treat it as a permanent failure for that message and surface it, rather than looping.
Stop debugging Instagram by hand
Connect the channel through Conferbot: tokens, webhooks and retries are handled, failures show as readable status.