Twitter/X

Image Requirements

Property	Requirement
Max Images	4 per post
Formats	JPEG, PNG, WebP, GIF
Max File Size	5 MB (images), 15 MB (GIFs)
Min Dimensions	4 × 4 px
Max Dimensions	8192 × 8192 px
Recommended	1200 × 675 px (16:9)

Aspect Ratios

Type	Ratio	Dimensions
Landscape	16:9	1200 × 675 px
Square	1:1	1200 × 1200 px
Portrait	4:5	1080 × 1350 px

GIF Support

Twitter/X has excellent GIF support:

Max file size: 15 MB
Max dimensions: 1280 × 1080 px
Animated GIFs play automatically in timeline
Only 1 GIF per post (counts as all 4 image slots)

{
  "content": "Check out this animation!",
  "mediaItems": [
    { "url": "https://example.com/animation.gif" }
  ],
  "platforms": [
    { "platform": "twitter", "accountId": "acc_123" }
  ]
}

Video Requirements

Property	Requirement
Max Videos	1 per post
Formats	MP4, MOV
Max File Size	512 MB
Max Duration	2 minutes 20 seconds (140 sec)
Min Duration	0.5 seconds
Max Dimensions	1920 × 1200 px
Min Dimensions	32 × 32 px
Frame Rate	40 fps max
Bitrate	25 Mbps max

Property	Recommended
Resolution	1280 × 720 px (720p)
Aspect Ratio	16:9 (landscape) or 1:1 (square)
Frame Rate	30 fps
Codec	H.264
Audio	AAC, 128 kbps

Threads (Multi-Tweet)

When creating threads, each tweet can have its own media:

{
  "platforms": [
    {
      "platform": "twitter",
      "accountId": "acc_123",
      "platformSpecificData": {
        "threadItems": [
          {
            "content": "1/ Starting a thread with an image",
            "mediaItems": [{ "url": "https://example.com/image1.jpg" }]
          },
          {
            "content": "2/ Second tweet with video",
            "mediaItems": [{ "url": "https://example.com/video.mp4" }]
          },
          {
            "content": "3/ Final tweet, text only"
          }
        ]
      }
    }
  ]
}