How to share app screenshots on X

X is where many developers share what they’re building, from a first screen to a launch. A raw phone screenshot is the wrong shape for its timeline, though, and X doesn’t publish its exact crop rules. This guide sticks to what’s documented or widely confirmed, and shows how to make images that survive the timeline.

The size that shows in full: 16:9

X doesn’t document an official image size for posts. Size guides such as Metricool’s recommend 16:9, at 1600 × 900 or 1200 × 675 pixels, and 16:9 is the shape that shows in the timeline without cropping across X’s apps and the web.

Taller images can be cropped in the timeline preview. People can tap to see the whole image, but most won’t, so treat the preview as what they see. An iPhone screenshot is about 9:19.5, far taller than 16:9, which is why posting it raw usually shows a slice from the middle.

The fix is to put the screenshot on a 16:9 canvas instead:

Posts with two, three or four images

When you attach more than one image, X arranges them in a grid and crops each one to fit its cell:

ImagesLayout in the timeline
2Side by side
3One large image, with two smaller ones stacked beside it
4A 2 × 2 grid

The cells aren’t 16:9, and the exact crop varies by app and screen size, so you can’t design every image to fit perfectly. What works reliably:

Often, a single 16:9 image with two or three screens side by side looks cleaner than a grid of separate images, because you control the whole layout instead of the crop.

Add image descriptions

X lets you add a description, also called alt text, to each image. Screen readers read it aloud, and people can open it from the ALT badge on the image. According to X’s help page, you add it from the +ALT or Add description option on each attached image, and descriptions can be up to 1,000 characters. They can’t be added to videos.

For an app screenshot, describe what the screen shows and why it matters, not every pixel:

iPhone showing the Offline Transcription home screen: a list of audio files, one of them partway through transcribing with a progress bar.

X has its own guide to writing good image descriptions.

Image or short video?

Both have a place.

A good pattern for a feature is a framed still image in the post, with a screen recording in a reply for people who want to see it move.

Posting tips for developers

A quick workflow

  1. Capture the screen at full resolution, on the device or in the Simulator.
  2. Put it in a device frame on a 16:9 canvas with a calm background and padding. How to put a screenshot in an iPhone frame covers the options.
  3. Export a JPEG at 1600 × 900 or larger.
  4. Write one line about what changed, attach the image, and add an image description.

FeatureFrame does steps 2 and 3 in one window: drop in up to three screenshots, choose the 16:9 canvas, and it frames each one in its real device (or a Clay frame), lays them out in a row, and lets you copy the image with ⌘ C and paste it into your post, or export it with ⌘ E. For other platforms, see image sizes for sharing app screenshots and Instagram carousels. Get FeatureFrame on the Mac App Store.

More guides