The best X video size, without black bars
Black bars appear when your video's shape doesn't match the player, or when they're baked into the file. Here's what X's own pages say, where they disagree, and how wide cards like 1500 × 500 fit in.
On this page
- Why black bars happen
- What X's own pages say (and where they disagree)
- Choosing a shape
- How to test a video size on X
- Export settings that avoid trouble
- How SayWords handles this
- Quick reference: which size should I use?
- FAQ
Lifetime licence from $4.99, paid once.
Claim my licence- Safe everywhere: 16:9 (1280 × 720), 1:1 (720 × 720), 9:16 (720 × 1280), H.264 MP4, AAC audio, 30 fps.
- X's API docs and its web help page list different aspect-ratio and size limits.
- Very wide shapes like 3:1 and 2.5:1 sit outside the web range quoted from X's help centre, so test before you rely on them.
Why black bars happen
Letterboxing (bars above and below) and pillarboxing (bars at the sides) happen for one of two reasons.
- The bars are in the file. You exported a 16:9 frame with a 4:3 clip inside it, or added padding to "fit" a shape. Every player will show those bars, because they're part of the picture.
- The shape doesn't match the player. If the video's aspect ratio isn't one the player displays natively, it may scale, crop or pad it, or the upload may be refused.
The fix is the same for both: decide the shape first, then export at exactly that pixel size with no padding.
What X's own pages say (and where they disagree)
X spreads its video guidance across its developer docs and its help centre, and they don't agree. The developer docs describe uploads through the API; the help centre describes uploads on the web.
| Spec | Developer docs (API) | Help centre (web), as quoted |
|---|---|---|
| Recommended sizes | 1280 × 720, 720 × 1280, 720 × 720 | Not stated in the quotes we read |
| Dimensions | 32 × 32 to 1280 × 1024 | 32 × 32 to 1920 × 1200 (1200 × 1900 upright) |
| Aspect ratio | 1:3 to 3:1 | 1:2.39 to 2.39:1 |
| Frame rate | 60 fps or less; 30 or 60 recommended | Up to 40 fps |
| Codec | H.264 High Profile, AAC-LC, YUV 4:2:0 | Not stated in the quotes we read |
| Bitrate | At least 5,000 kbps recommended | Up to 25 Mbps |
Sources, read 10 Nov 2026: X developer docs: media best practices · help-centre values as quoted by Clapr (Sep 2026) and Flaghand (checked Oct 2026); we could not load X's help page directly · Clip Short, X video size (Oct 2026). Check X's own pages for the final word.
One more wrinkle, noted by Clip Short: the API's 1280 × 1024 dimension limit doesn't even fit X's own recommended 720 × 1280 portrait size. When official pages contradict each other, the app is the final test.
Choosing a shape
16:9 (1280 × 720 or 1920 × 1080)
The safe default for screen recordings and demos. 1280 × 720 fits every limit above and plays full width, but it's relatively short on a phone screen.
1:1 (720 × 720 or 1080 × 1080)
Takes more vertical space in the feed than 16:9 and looks the same on desktop and phone. Good for talking-head clips.
9:16 (720 × 1280 or 1080 × 1920)
Fills a phone screen and suits full-screen viewing. In a reply thread, it's tall enough to push other replies off screen.
Wide cards: 3:1 (1500 × 500) and 2.5:1 (1280 × 512)
Very wide shapes behave like a banner. They take up little vertical space and can sit in a thread like an inline card, which suits replies where you want to add to the conversation without taking it over. But they're at or beyond the edges of X's published limits:
| Size | Ratio | API aspect 1:3–3:1 | API max 1280 × 1024 | Web aspect ≤ 2.39:1 (quoted) |
|---|---|---|---|---|
| 1280 × 720 | 16:9 | Inside | Inside | Inside |
| 1280 × 512 | 2.5:1 | Inside | Inside | Wider |
| 1500 × 500 | 3:1 | At the edge | Wider (1500 px) | Wider |
That doesn't mean wide clips can't work; published limits and real-world behaviour don't always match. It means you should test wide shapes on the web composer and the mobile apps before you build a habit around them.
How to test a video size on X
- Export a short test clip at the exact size, with no padding.
- Upload it on x.com in a browser and note whether it's accepted, cropped or letterboxed in the preview.
- Post it from a test account if you have one, or post and delete.
- Check the timeline on the web, on iOS and on Android. Note how it appears inline and full screen.
- Write down the result with the date. X changes things.
Export settings that avoid trouble
- MP4 container, H.264 video (High Profile), AAC-LC audio, mono or stereo.
- Exact target pixel size, no black padding added.
- 30 fps: within both the web and API limits, and plenty for talking or animated clips.
- Square pixels (1:1 pixel aspect ratio), YUV 4:2:0, progressive scan.
- Captions inside the middle of the frame, away from the player controls at the bottom.
Making a reply rather than a post? The full workflow is in how to make a video reply on X.
How SayWords handles this
SayWords exports animated cartoon replies at 1500 × 500 (3:1) or 1280 × 512 (2.5:1) as H.264 MP4, so the frame is exactly that shape with no padding added. Based on the limits above, 1280 × 512 is the more conservative of the two, but both are wider than the web range quoted from X's help centre, so test where you post. More on the product: video replies for X.
Quick reference: which size should I use?
| Goal | Size to try first |
|---|---|
| Safest possible upload | 1280 × 720 (16:9) |
| More presence on a phone feed | 720 × 720 (1:1) or 720 × 1280 (9:16) |
| Compact inline card in a reply thread | Wide shapes such as 2.5:1 or 3:1, after testing |
If a wide clip is refused or letterboxed in your tests, the fallback is simple: use a shape inside both published ranges, such as 16:9.
Questions
What aspect ratios does X accept?
Why does my video have black bars on X?
Is 1500x500 a valid X video size?
What about 1280x512?
What is the recommended X video size?
Pay once. Reply with your face and voice.
SayWords is a small macOS companion: type up to 280 characters, pick a pose, drag the MP4 into X, Slack or Discord. Lifetime licence from a one-time $4.99.
- Lifetime access, one person
- All 50+ animations and three caption styles
- Every palette, pattern and typeface
- 3:1 and 2.5:1 H.264 MP4 export