Instagram error 100: Too many @ tags on the media (2207040)
Last verified against Meta for Developers - Messenger Platform error codes
Cannot use more than {max-tag-count} tags per created media.What error 100 means
Code 100 with subcode 2207040 is the tag-count ceiling. Meta's recommended solution says the app user exceeded the maximum number of @ tags - 20 - and should use fewer. The message substitutes the current maximum for {max-tag-count}.
The limit concerns people tagged on the media. On the container request those arrive through user_tags, an array of objects each holding a public username and, for images, x and y coordinates between 0.0 and 1.0. The caption has its own matching cap of 20 @ mentions, so an app that both tags people on the image and mentions them in text should keep both counts in mind.
Nothing else about the post is wrong. The fix is a smaller tag list, and because the container was rejected, a new container request with the trimmed list. Bulk tools that auto-tag every collaborator, team member or customer in a photo are the usual way to exceed the limit.
What it looks like
{
"error": {
"type": "OAuthException",
"code": 100,
"error_subcode": 2207040,
"error_user_msg": "Cannot use more than 20 tags per created media.",
"fbtrace_id": "PqT6fMs1XkAv3Bg"
}
}Why it happens
- The user_tags array holds more than 20 entries.
- An automation tags every participant from a CRM or event list without capping the count.
- Duplicate usernames in user_tags inflate the total.
- The caption also carries more than 20 @ mentions.
How to fix Instagram error 100
- 1Count the entries in
user_tagsand reduce them to 20 or fewer. - 2Deduplicate usernames before building the array.
- 3Check the caption separately and keep @ mentions to 20 or fewer.
- 4Create a new container with the trimmed tag list.
How to stop it recurring
Cap tags in the composer UI, deduplicate on username, and re-check the count server-side right before the container request. If your product tags many people by design, let users choose which 20 matter rather than truncating silently. Caption-length and hashtag rules are covered by 36004/2207010.
Official reference: Meta for Developers - Messenger Platform error codes. See all Instagram error codes or the Instagram limits and quotas.
Related codes
Error 100 - quick answers
What does Instagram error 100 mean?
Code 100 with subcode 2207040 is the tag-count ceiling. Meta's recommended solution says the app user exceeded the maximum number of @ tags - 20 - and should use fewer. The message substitutes the current maximum for {max-tag-count} . The limit concerns people tagged on the media.
How do I fix Instagram error 100?
1. Count the entries in user_tags and reduce them to 20 or fewer. 2. Deduplicate usernames before building the array. 3. Check the caption separately and keep @ mentions to 20 or fewer. 4. Create a new container with the trimmed tag list.
Should I retry after error 100?
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.