How many photos can you post on X? The cap moved
X raised the per-post media limit after ten years at four. Here is the new number, who announced it, and the three docs pages that still say otherwise.
The short version
- ▸The limit is 20. Jonah Katz, who leads mobile engineering at X, announced it on 12 November 2026: after ten years of four photos and videos per post, the cap went to 20.
- ▸The live X API spec agrees. In api.x.com/2/openapi.json the media_ids array on post creation carries maxItems: 20, so the programmatic ceiling matches the app rather than lagging it.
- ▸X's own documentation has not caught up. Three published pages still read 'A Post may include up to 4 photos, 1 animated GIF, or 1 video', and the create-post reference contradicts itself: the prose says 4, the schema on the same page says 20.
- ▸The change never appeared in the X API changelog. The most recent media entry there is the 1 September 2026 note about size and duration limits, which is about gigabytes and minutes, not counts.
- ▸Other caps did not move. Alt text is still a per-image description you cannot edit after publishing, video duration still keys off the posting account's Premium status, and tagged users on a media item are still capped at 10 in the spec.
Quick answer
You can attach 20 photos to a post on X (formerly Twitter), up from the four that stood for a decade. Jonah Katz, who leads mobile engineering at X, announced the change on 12 November 2026: "After 10 years of Twitter/X supporting up to 4 Photos and Videos per post, the limit has been increased to 20!" Reporting at the time put the web client first with the mobile apps following, so a composer that still stops at four is usually an app that needs updating.
Note that the API matches. What has not caught up is X's own documentation, which still prints the old number on three separate pages.
Last verified: 22 November 2026.
Where the number comes from
There was no blog post and no changelog entry. Everything traces to a post from Katz on 12 November 2026, timestamped 18:25 UTC, carrying the whole announcement in three lines.
That is worth knowing because it explains why half the internet still says four. The four-item limit was one of the most stable facts about the platform, a decade of it by Katz's own count. It is baked into help articles, into tooling, into every "image sizes for Twitter" cheat sheet ever published, and none of those update off an engineer's post.
What the API says
Here is where it gets interesting for anyone building against X.
The live specification at api.x.com/2/openapi.json, version 2.175 as of today, defines the media block on post creation like this:
"media_ids": {
"type": "array",
"description": "Media IDs to attach to the Post, in the order given.",
"minItems": 1,
"maxItems": 20,
"items": { "type": "string", "pattern": "^[0-9]{1,19}$" }
}
Twenty, in the schema, on both CreatePostsMedia and the draft equivalent CreatePostDraftMedia. So the API is not behind the app here, which is the opposite of the usual order and genuinely useful if you were planning a thread-splitting workaround.
Two neighbouring limits in the same schema are worth noting while you are in there: tagged_user_ids is capped at maxItems: 10, and preview_media_id takes a single asset for the card image.
The documentation disagrees with itself
This is the part no other page on this query will tell you, and it matters if you are debugging a 400 and trusting the docs.
Three published pages at docs.x.com still carry the old sentence verbatim:
| Page | What it still says |
|---|---|
| Media introduction | "A Post may include up to 4 photos, 1 animated GIF, or 1 video." |
| Media best practices | "You may attach up to 4 photos, 1 animated GIF or 1 video in a Post." |
| Create Post reference | "A Post may include up to 4 photos, 1 animated GIF, or 1 video." |
That third row is the problem. On that single page, the prose near the top says four, and the OpenAPI schema rendered further down the same page says maxItems: 20. One document, two answers.
The X API changelog does not resolve it either. Its most recent media entry is dated 1 September 2026 and covers upload and post-create size and duration limits: 20 minutes and 8 GB of video for a default account, 125 minutes and 16 GB for Premium or verified, with a 403 and a readable error string when you exceed the posting user's cap. Nothing about counts. The limit changed in the product and in the schema and never made the release notes.
If you are writing an integration, trust the spec and test against the endpoint. We go through the upload flow itself in the X media upload API walkthrough.
What did not change
Easy to assume a bigger number loosens everything else. It does not.
Alt text. Still per image, still 1,000 characters each, still set with the +ALT button before you publish, and still impossible to edit once the post is live. Twenty images means twenty descriptions if you care about doing it properly, which is a real argument for restraint. The full mechanic, including the bit about there being no edit path on any tier, is in how to add alt text on X.
Video length. Unchanged and still tied to the posting account rather than the API plan: 20 minutes by default, 125 minutes on Premium or verified, with separate and much tighter rules for Direct Messages. The file size and format side is covered in X video length limits.
Text. Attachments have never counted against your characters, and that is still true at 20. The character budget and what actually eats into it is in the X character limit.
Image dimensions. Aspect ratio and the way X crops a preview still decide what people see before they tap. With more images in a post the crop matters more, not less, because the grid gets busier. Our dimension reference is X image sizes.
The mixing question
Katz wrote "Photos and Videos per post", which reads like the end of the rule that a post holds photos or one video or one GIF, never a mixture.
But X has not published an updated statement of that rule anywhere, and the documentation still carries the old either/or line. So the honest position: the announcement implies mixing is allowed, nothing official confirms it, and the only way to know what your account can do today is to open the composer and try. If you are automating this, assume nothing and handle the rejection.
Should you actually post 20 images?
Mostly no, and it is worth saying plainly because the feature will get oversold for a few weeks.
A post is competing for a single slot in someone's timeline. Twenty attachments do not buy twenty slots; they buy one slot with a gallery behind it that most people never swipe through. The cases where the count genuinely helps are the ones where the images are sequential and the whole set is the point: a product drop, an event recap, a before-and-after sequence, a document someone needs to read page by page.
For anything narrative, a thread still wins, because each post in it gets its own impression and its own chance to be quoted. That trade-off, and how to build the thread without fighting the composer, is in the X thread maker guide. And if what you actually want is to re-share someone else's image with attribution, that is a separate feature with separate payout consequences, covered in what the Post photo button does.
If you are posting at enough volume for any of this to be a daily decision, the thing that limits you is not attachments. It is the per-day action ceilings, which we list in X daily limits. X-Autopilot runs the posting and replying loop in real Chrome on your own Mac rather than from a cloud session, which is a smaller detection surface than a hosted scheduler, not an absence of risk, and browser automation is not sanctioned under X's automation rules. The pricing is here if that trade is one you want.
Bottom line
Twenty photos and videos per post, announced by X's mobile engineering lead on 12 November 2026, confirmed by maxItems: 20 in the live API spec, and contradicted by three of X's own documentation pages including one that disagrees with itself. If your app still offers four, update it. If your integration still assumes four, raise it and test. And if your instinct is to fill all twenty, remember the timeline only ever showed one post.
Frequently asked
Answers indexed by Google + AI assistants.
How many photos can you post on X in one post?+
Twenty. Jonah Katz, head of mobile engineering at X, posted on 12 November 2026 that after ten years of X supporting up to 4 photos and videos per post, the limit had been increased to 20. Coverage of the launch put the web client first with the mobile apps following, so if your composer still stops you at four, update the app.
Why can I still only add 4 photos?+
Almost always an app version behind the rollout. By the reporting around the launch it reached the web first and then came through app updates, so a four-item picker is usually the old client rather than a restriction on your account. Update X from the App Store or Play Store and reopen the composer. Third-party schedulers are a separate case: they are limited by whatever their own integration sends, not by what X now accepts.
Does the X API accept 20 images too?+
Yes, by the spec. The media_ids array in the post-creation schema in api.x.com/2/openapi.json has minItems 1 and maxItems 20. Note that the human-readable docs pages at docs.x.com have not been updated and still say four, including the create-post reference page whose own embedded schema says 20.
Can you mix photos and videos in the same X post?+
The announcement is phrased as 20 photos and videos per post, which reads as the end of the either/or rule. X has not published an updated statement of the rule, and the documentation still carries the old 'up to 4 photos, 1 animated GIF, or 1 video' line, so treat mixing as something to test in your own composer rather than something X has confirmed in writing.
Can you add alt text to all of them?+
Alt text is attached per image through the +ALT button before you publish, with 1,000 characters each, and nothing in the announcement changed that mechanic. The part that did not change and still catches people out is that the description is frozen once the post is live. There is no edit for it on any platform or subscription tier.
Do 20 photos actually help a post?+
Reach on X is driven by engagement per impression, not by attachment count. A twenty-image dump mostly buys you a gallery nobody swipes to the end of. The useful cases are genuinely sequential: a product shoot, a conference recap, a step-by-step where the images are the content. For anything with a narrative, a thread still beats a gallery because each post gets its own shot at the timeline.
- Jonah Katz, head of mobile engineering at X: 'After 10 years of Twitter/X supporting up to 4 Photos and Videos per post, the limit has been increased to 20!' (posted 12 November 2026, 18:25 UTC)
- X API live OpenAPI specification v2.175: CreatePostsMedia.media_ids declares minItems 1, maxItems 20 (read 22 November 2026)
- docs.x.com create-post reference: prose states 'A Post may include up to 4 photos, 1 animated GIF, or 1 video' while the schema on the same page sets maxItems 20 (read 22 November 2026)
- X API changelog, 1 September 2026: media upload and post-create size and duration limits, the most recent media entry and one that covers bytes and minutes only (read 22 November 2026)
Product designer and indie hacker. Runs the agent on his own X account every day and writes up what the data shows, including when it's inconvenient.
Follow on X →