GuidemacOS · Lifetime from $4.99

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.

Illustration, not a real render · pose: Presenting on a chart · underline captions · 1500 × 500
On this page
  1. Why black bars happen
  2. What X's own pages say (and where they disagree)
  3. Choosing a shape
  4. How to test a video size on X
  5. Export settings that avoid trouble
  6. How SayWords handles this
  7. Quick reference: which size should I use?
  8. FAQ
SayWords for Mac

Lifetime licence from $4.99, paid once.

Claim my licence
In short
  • 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.

  1. 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.
  2. 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.

SpecDeveloper docs (API)Help centre (web), as quoted
Recommended sizes1280 × 720, 720 × 1280, 720 × 720Not stated in the quotes we read
Dimensions32 × 32 to 1280 × 102432 × 32 to 1920 × 1200 (1200 × 1900 upright)
Aspect ratio1:3 to 3:11:2.39 to 2.39:1
Frame rate60 fps or less; 30 or 60 recommendedUp to 40 fps
CodecH.264 High Profile, AAC-LC, YUV 4:2:0Not stated in the quotes we read
BitrateAt least 5,000 kbps recommendedUp 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:

SizeRatioAPI aspect 1:3–3:1API max 1280 × 1024Web aspect ≤ 2.39:1 (quoted)
1280 × 72016:9InsideInsideInside
1280 × 5122.5:1InsideInsideWider
1500 × 5003:1At the edgeWider (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

  1. Export a short test clip at the exact size, with no padding.
  2. Upload it on x.com in a browser and note whether it's accepted, cropped or letterboxed in the preview.
  3. Post it from a test account if you have one, or post and delete.
  4. Check the timeline on the web, on iOS and on Android. Note how it appears inline and full screen.
  5. 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?

GoalSize to try first
Safest possible upload1280 × 720 (16:9)
More presence on a phone feed720 × 720 (1:1) or 720 × 1280 (9:16)
Compact inline card in a reply threadWide 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.

OM to verifySayWords exports at the exact ratio with no padding, and it plays inline in the X feed on desktop and mobile.. SayWords is not affiliated with X.

Questions

What aspect ratios does X accept?
It depends on the upload path. X's developer docs (API uploads) say 1:3 to 3:1. X's help centre, as quoted by third-party guides, lists 1:2.39 to 2.39:1 for web uploads. 16:9, 1:1 and 9:16 fit both.
Why does my video have black bars on X?
Either the bars are baked into the file (padding added during export), or the video's shape isn't one the player shows full-frame. Export at the intended shape with no padding.
Is 1500x500 a valid X video size?
1500 × 500 is exactly 3:1. That is the edge of the API aspect-ratio range, but 1500 px is wider than the API's 1280 × 1024 dimension limit, and 3:1 is wider than the 2.39:1 web limit quoted from X's help centre. Test it before relying on it.
What about 1280x512?
1280 × 512 is 2.5:1. It fits the API's dimension and aspect-ratio limits, but is still wider than the 2.39:1 web range quoted from X's help centre. Test it on web and mobile.
What is the recommended X video size?
X's developer docs recommend 1280 × 720 (landscape), 720 × 1280 (portrait) and 720 × 720 (square).

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 licenceStarter
$4.99one-time
  • 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
Claim licence · $4.99
Small watermark · $13 for no watermark