Skip to main content

Photo Format Requirements

This document outlines the photo format requirements for uploading to various social media platforms via the API. For platforms where specific requirements are not listed, standard image formats like JPEG and PNG are generally accepted. However, for the most accurate and up-to-date information, please consult the official documentation of each respective platform.

Threads Photo Requirements​

  • Format: JPEG, PNG
  • File Size: 8 MB maximum
  • Aspect Ratio: Limit: 10:1 (e.g., can be from 1:10 to 10:1)
  • Width:
    • Minimum: 320px (images narrower than 320px will be scaled up to 320px)
    • Maximum: 1440px (images wider than 1440px will be scaled down to 1440px)
  • Color Space: sRGB (images with other color spaces will be converted to sRGB)
  • Items Per Post: Up to 20 media items per post (carousel). If you provide more than 20 items, they are automatically distributed across multiple posts.
  • Thread Media Layout: Use the threads_thread_media_layout parameter to control how media items are distributed across posts. For example, "5,5" splits 10 items into 2 posts of 5 each.

Instagram Photo Requirements​

  • Media Type: The API supports "IMAGE" for feed posts and "STORIES".
  • Formats: PNG, JPEG, GIF
  • File Size: 8 MB maximum
  • Width: 320–1440 px
  • Aspect Ratio: 4:5 to 1.91:1
  • Alt text: instagram_alt_text — up to 1,000 characters per image

TikTok Photo Requirements​

  • Format: JPG, JPEG or WebP
  • File Size: 20 MB maximum per image
  • Max Resolution: 1080p — the short side may not exceed 1080 px and the long side 1920 px (1080 x 1920 portrait, 1920 x 1080 landscape, 1080 x 1080 square). Larger images are downscaled automatically before upload (aspect ratio preserved) and the change is listed in the response's changes; a 1500 x 1500 or a 2160 x 3840 image used to be rejected by TikTok with "Unsupported image size".
  • Images Per Post: Up to 35 images per photo post (slideshow)
  • Title: Up to 90 characters. Description: up to 4,000 characters and 30 mentions
  • Rate limits: 6 posts per minute and 15 posts per day per TikTok account
  • Photo posts accept privacy_level and photo_cover_index; add background music with auto_add_music.

Facebook Photo Requirements​

  • Formats: JPEG, PNG, GIF, BMP, TIFF, WEBP
  • File Size: 4 MB maximum per photo (feed). Stories (facebook_media_type=STORIES): 10 MB
  • Caption resolution: facebook_description > description > title

X (Twitter) Photo Requirements​

  • Formats: JPEG, PNG, GIF, WEBP
  • Max File Size: 5 MB per static image (tweet_image). Animated GIF: up to 15 MB (tweet_gif)
  • Images Per Tweet: Up to 4 images per tweet. If you provide more than 4 images, they are automatically distributed across a thread (up to 4 images per tweet).
  • Thread Image Layout: Use the x_thread_image_layout parameter to control how images are distributed across tweets in the thread. For example, "4,4" puts 4 images in each of 2 tweets.
  • Alt text: x_alt_text — up to 1,000 characters per image

LinkedIn Photo Requirements​

  • Formats: JPEG, PNG, GIF
  • Max pixels: 36,152,320. Animated GIF: ≤ 250 frames
  • Alt text: linkedin_alt_text (defaults to title)

Pinterest Photo Requirements​

  • Max Image Size: 20 MB
  • Supported Formats: BMP, JPEG, PNG, TIFF, GIF, Animated GIF, WEBP
  • Recommended Size: 1000 x 1500 px
  • Aspect Ratio: 2:3
  • Minimum Size: 600 x 900 px
  • Maximum Size: 2000 x 3000 px
  • Content-Type: A valid media Content-Type such as image/jpeg, image/png, or image/webp returned by the hosting provider
  • Image Carousel:
    • Up to five carousel images
    • Images must be the same dimension

Reddit Photo Requirements​

Reddit posting is currently unavailable. Uploads with platform[]=reddit return HTTP 503 error_code: "reddit_unavailable".

Bluesky Photo Requirements​

  • Max Images: 4 per post by default. If you send more without gallery mode, Upload-Post publishes the first 4 and returns a warnings entry naming how many were dropped. bluesky_gallery=true publishes up to 20 images as app.bsky.embed.gallery.
  • Max File Size: 1 MB per image
  • Supported Formats: JPEG, PNG, GIF, WEBP
  • Alt Text: bluesky_alt_text (string, JSON array, or ||-separated)

Discord Photo Requirements​

  • Max Images: 10 per message (sent as attachments)
  • Supported Formats: JPG, PNG, GIF, WEBP (any image type Discord accepts)
  • Caption: Up to 2,000 characters, applied as the message content
  • Max File Size: Bounded by the upload limit of the target Discord server (the default Discord per-attachment limit applies)

Telegram Photo Requirements​

  • Max Images: 10 per album (sent via sendMediaGroup; a single photo is sent via sendPhoto)
  • Supported Formats: JPG, PNG, WEBP (any image type Telegram accepts)
  • Caption: Up to 1,024 characters, applied to the first item of the album

Note: The information for Instagram, TikTok, Facebook, X (Twitter), and LinkedIn photo requirements above is general. The provided source code focused primarily on video specifications and Threads image specifications. Always check the official platform guidelines for the latest and most precise requirements.