Skip to content

Threads

Threads supports text, images, videos, and albums, plus reply chains that publish several posts in a row.

Post types

TypeAPI valueWhat it publishes
TexttextA text-only post.
ImageimageOne image with a caption.
VideovideoOne video with a caption.
AlbumalbumA carousel of 2 to 20 items with a caption. Images and videos can be mixed.

Media requirements

Images

  • Formats: JPEG, PNG.
  • File size: up to 8 MB per image.

Videos

  • Formats: MP4, MOV with H.264 video and AAC audio.
  • File size: up to 1 GB.
  • Duration: up to 5 minutes.
  • Width: up to 1920 px.

Text limits

  • Caption (description): up to 500 characters, including hashtags and @mentions. Emojis count by their UTF-8 byte length, so one emoji can use more than one character.
  • Alt text (medias[].alt): up to 1,000 characters.

Extra options

Option in the dashboardAPI fieldApplies toWhat it does
TopictopicAll typesAdds one topic tag to the post, up to 50 characters. Periods (.) and ampersands (&) aren't allowed.
RepliesrepliesAll typesPublishes a chain of posts under your post, each with its own type, text, and media.

Replies are available only when every account in the schedule is Threads or X. Each reply has its own type, description, topic, and medias.