Instagram caption limits: characters, hashtags and @ tags in the API
Instagram's API publishes a caption of up to 2,200 characters with a photo, Reel or carousel, with at most 20 @ tags. As of November 2026, Instagram's Help Center allows 5 hashtags on a post, while Meta's API reference still lists 30, so keep to 5. Accounts @mentioned are notified when the post is published, and a caption that is too long fails with code 36004, subcode 2207010.
easyCoexistence publishes a photo, carousel or Reel with its caption through publish_instagram_post, from Claude, ChatGPT or your own code, setting the caption once on a carousel, and list_social_posts reads each post's caption back.
Most characters a caption can hold through Instagram's API.
Most hashtags Instagram's Help Center now allows on a post, in the caption or the comments.
Most hashtags per caption in Meta's API reference, which still gives the older figure.
Most @ tags in one caption; going over returns code 100, subcode 2207040.
Error subcode, under code 36004, for a caption longer than Instagram allows.
media_publish can succeed with config_issue CAPTION_NOT_ATTACHED: the post is live without its caption.
What are the caption limits?
Three, all on the caption parameter of the media container. A caption can include hashtags, written as #tag, and usernames of Instagram accounts, written as @username, within these limits:
- Length: up to 2,200 characters.
- Hashtags: up to 5 on a post by Instagram's Help Center, counting those in the comments; Meta's API reference still lists 30.
- @ tags: up to 20, and each mentioned account is notified when the post is published.
Which posts take a caption?
Photos, Reels and carousels. On a carousel the caption goes on the carousel container, since the images and videos inside it do not support one, and Meta's reference describes no caption for Stories, so words meant for a Story belong in the image or video itself.
What happens when a caption breaks a limit?
The request fails with an error that names the problem. A caption that is too long returns code 36004, subcode 2207010, and Meta's fix for it restates the limits: at most 2,200 characters, 30 hashtags and 20 @ tags. More than 20 @ tags can also return code 100, subcode 2207040. Shorten the caption and send the request again.
When are mentioned accounts notified?
When the container is published, not when it is created. Accounts @mentioned in a caption receive a notification at that moment, so a container prepared ahead of time does not alert anyone until it goes live. Meta's limit of 20 @ tags per caption applies to these mentions.
Can a post go live without its caption?
Yes. media_publish can succeed with a config_issue field set to CAPTION_NOT_ATTACHED, meaning the media published without its caption. Meta calls this a partial success: the media ID is valid, so reconcile the post instead of publishing it again.
Can a caption be changed after publishing?
Meta's media reference documents one update for published media: turning comments on or off with POST /<IG_MEDIA_ID> and comment_enabled. It lists no way to edit a caption, so check the text, hashtags and @ tags before the container is created.
Common mistakes
- Checking only the length. A caption under 2,200 characters still breaks the limits with more than 5 hashtags, Instagram's current rule, or more than 20 @ tags.
- Captioning carousel items. Only the carousel container takes a caption.
- Writing a caption for a Story. The Stories container takes none, so put the words in the image or video.
- Publishing again after CAPTION_NOT_ATTACHED. The first post is already live, and a second publish creates a duplicate.
US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.
easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.
Frequently asked questions
What does error 2207040 mean on Instagram?
The caption has more than 20 @ tags, returned under code 100. Remove tags until 20 or fewer remain and send the request again.
Does Instagram's 5-hashtag limit include hashtags in comments?
Yes. Instagram's Help Center allows up to 5 hashtags on a post, counting those in the caption and in the comments.
Can I turn off comments on a published post through the API?
Yes. POST /<IG_MEDIA_ID> with comment_enabled set to false turns comments off and true turns them back on, the one update Meta's media reference documents for published media.
What does error 2207010 mean?
The caption is longer than Instagram allows. Shorten it to 2,200 characters or fewer and send the request again.
Keep reading
Connect your first channel in two minutes.
No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.
- 3 days free
- Cancel any time
- Official APIs only
- Monitored 24/7
Verified on