Skip to content
Publishing

What each network accepts when you publish by API

Character limits, media rules, required fields and crops for every network, so you know what will be accepted before you schedule rather than after it fails.

The Picifer team10 min read

Branded Picifer card with the title What each network accepts when you publish by API.

Key takeaways

  • Every network accepts a different shape of post, and the differences are enforced by its API, not by taste. A post that breaks one of them does not go out looking slightly wrong, it fails.
  • The four rules that break most posts are the character limit, whether media is required, how many images and videos are allowed, and whether they can be mixed.
  • Several networks will not accept a post without an extra field: a Pinterest board, a YouTube title, a LinkedIn document title, a Hashnode tag, a Google Business event date.
  • Character limits are not all counted the same way. X counts every link as 23 characters, Bluesky counts graphemes, and Farcaster counts bytes rather than characters.
  • Check the rules before you write, not after. A composer that validates against the exact post type you chose catches the problem while you can still fix it.
On this page
  1. Why “it fits” is four separate questions
  2. The limits, network by network
  3. Post types narrow the rules again
  4. Required fields: the quiet failures
  5. Crops: what the media editor should offer
  6. How the counting differs
  7. A pre-flight checklist
  8. Why this is worth encoding rather than remembering

A post that fails to publish rarely fails for an interesting reason. It fails because a caption was eleven characters too long, or because an Instagram post was scheduled without an image, or because a Pinterest pin was saved without a board. None of those are judgment calls. They are rules the network enforces at the moment of publishing, and a post that breaks one does not go out looking slightly wrong. It does not go out at all.

This guide is a map of those rules: how much text each network takes, whether it needs media, how many images and videos it accepts, whether they can be mixed, and which extra fields it refuses to publish without. It is written from the rules a publishing tool has to encode, which is the same thing a person has to keep in their head if they publish by hand.

Why “it fits” is four separate questions

When someone asks whether a post will work on a network, they are usually asking one question. The network is asking four.

Does the text fit? Every network has a limit, and the limits are not close to each other. The gap between X and a Facebook Page post is more than two hundred times.

Does it have what the network needs? Some networks are built around media and refuse a post without it. Others accept text happily.

Is the media allowed? How many images, how many videos, whether the two can sit in the same post, how long a video may run, and sometimes how short.

Are the extra fields filled in? A pin needs a board. A video needs a title. A document carousel needs a document title. These are not optional preferences, they are required parameters.

Get all four right and the post publishes. Miss one and it does not.

The limits, network by network

The table below is the short version: the text limit, whether media is required, and the media allowance for the network’s main way of posting. Individual post types narrow these further, which the next section covers.

NetworkText limitMediaWorth knowing
Instagram2,200 characters, up to 30 hashtagsRequired. Up to 20 items in a carousel, images and video mixedLinks in captions are not clickable. A Story carries no caption at all
Facebook63,206 charactersOptional. 10 images or 1 video, not bothA Reel and a Story are separate post types with their own limits
X280 charactersOptional. 4 images or 1 video up to 140 secondsEvery link counts as 23 characters however long it is
LinkedIn3,000 charactersOptional. 20 images or 1 video, not bothA PDF becomes the swipeable document carousel
TikTok2,200 charactersRequired. 1 video up to 10 minutes, or up to 35 stillsNo first comment and no link preview
YouTubeDescription 5,000, title 100A video is requiredA Short is the same upload, square or taller and 3 minutes at most
Threads500 charactersOptional. Up to 20 in a carousel, images and video mixedAt most 5 links in one post, and a carousel needs at least 2 items
PinterestDescription 500, title 100Required. Up to 5 images, or 1 video of 4 seconds to 15 minutesEvery pin needs a board, and alt text is its own field
Bluesky300 graphemesOptional. 4 images or 1 video up to 3 minutesCounted by grapheme, so an emoji costs one, not two
Mastodon500 characters by defaultOptional. 4 images or 1 videoEvery server sets its own limit, so the real number is the server’s
Google Business Profile1,500 charactersOptional. One photo, no videoThree kinds of post: an update, an event and an offer
Telegram4,096 as text, 1,024 as a captionOptional. An album holds 2 to 10 photos and videosThe caption limit drops to 1,024 as soon as the post carries media
Discord2,000 charactersOptional. Up to 10 filesA rich embed is a titled card with its own color
Tumblr4,096 per text blockOptional. Up to 30 imagesFive post types, and tags matter more than hashtags
Farcaster1,024 bytes of textOptional, embedded by linkBytes, not characters, so emoji and accents cost more than one each
WordPressA full articleThe first image becomes the featured imageA title is required, and a post can be published or left as a draft
GhostA full articleThe first image becomes the feature imageA post can be public, members only or paid members only
DEVA full article, title 128The first image becomes the coverUp to 4 tags, and they have to exist on DEV already
HashnodeA full articleThe first image becomes the coverAt least one tag is required, up to five
Text limits and media rules for each network's main post type. Post types such as Reels, Stories, polls and document carousels narrow these further.

Two things in that table catch people out more than anything else.

Telegram’s limit changes with the post. A plain message takes 4,096 characters. Attach a photo or a video and the caption limit drops to 1,024, because it is a different call to a different endpoint. Writing 2,000 characters and then adding a picture is enough to break it.

Mastodon’s limit is not Mastodon’s. 500 characters is the usual default, but each server sets its own, and some allow several thousand. The only honest answer is the number the server reports, which is why a tool should read it rather than assume.

Post types narrow the rules again

Most networks have more than one way of posting, and the ways are genuinely different objects rather than flags on one. This is where a single “network limit” stops being useful.

  • Instagram has a feed post (one image or a carousel of up to 20), a Reel (always a video, 3 seconds to 15 minutes, vertical) and a Story (one image or a video up to 60 seconds, and no caption at all).
  • Facebook has a Page post, a Reel (3 to 90 seconds) and a Story (capped at 60 seconds even though a Reel allows 90, and the photo or video must not already have been published).
  • X has a post, a thread of up to 25 parts, a poll (two to four choices of 25 characters, and no media at all) and a long post of up to 25,000 characters, which needs a paid account on the connected profile.
  • LinkedIn has a post, a document carousel (a PDF people swipe through, with its own required title) and a poll whose question is a separate field from the post text.
  • Google Business Profile has an update, an event and an offer. The event will not publish without a name and both a start and an end, and the offer needs a name and a date range.
  • Telegram has five: text, photo, video, album and poll, each a different endpoint with a different limit.
  • Tumblr has text, photo, video, link and quote.

So the useful question is never “what are Instagram’s rules”. It is “what are the rules for the kind of Instagram post I am about to make”. Our guide to social media post types by network goes through each type and when to reach for it.

Required fields: the quiet failures

Character limits are easy to see coming. Required fields are not, because nothing about the text looks wrong.

NetworkWhat it insists on
PinterestA board. A pin cannot exist outside one, and a board section has to belong to the board you chose
YouTubeA video title, and an answer to whether the video is made for kids
LinkedIn (document)A document title, shown above the carousel
LinkedIn (poll)A poll question, which is separate from the post text
Google Business (event)An event name, a start and an end, all four of date and time at each end
Google Business (offer)An offer name and a valid-from and valid-until date
DiscordThe channel the message goes to
TumblrWhich blog on the account the post belongs to
Telegram (poll)The answers, up to twelve of a hundred characters each
WordPress, Ghost, DEV, HashnodeA title. Hashnode also needs at least one tag, DEV allows up to four and they must already exist
Fields that have to be filled in before a network will accept the post. A tool that collects them in the composer turns a publish failure into a form validation message.

A publishing tool should ask for these in the composer, at the moment you pick the network, and refuse to schedule without them. Picifer does: each network declares its own fields and its post types declare theirs, and the composer shows exactly the fields the chosen combination needs. A Pinterest pin loads your real boards in a select rather than asking you to find a board id.

Crops: what the media editor should offer

Aspect ratios are not enforced the way a character limit is, but a post cropped to the wrong shape is cropped again by the network, usually across someone’s face. Each post type has a small set of crops that work.

  • Vertical 9:16 for Instagram Reels and Stories, Facebook Reels and Stories, TikTok video, and YouTube Shorts.
  • Square 1:1 is the safest all-rounder, accepted almost everywhere.
  • Portrait 4:5 for an Instagram or Threads feed post, which takes more height in the feed than a square.
  • Landscape 16:9 for YouTube, X, Bluesky, Mastodon, Discord and Telegram.
  • Landscape 1.91:1 for a Facebook link post and an Instagram landscape feed post.
  • Portrait 2:3 for a Pinterest pin, which is the shape the feed is built around.
  • Landscape 4:3 for a Google Business Profile photo.

If you only keep two crops of each image, keep square and vertical 9:16. Between them they cover most of what you will publish. Our free image sizes reference lists the dimensions per network, and the post preview tool shows how a caption and crop will actually look.

How the counting differs

Three networks count text in a way that will surprise you if you assume characters.

X counts every link as 23 characters. A 140-character URL and a 20-character URL cost exactly the same. That is good news for long tracking links and bad news for anyone who assumed a short link bought them space. Our guide to character limits and how each network counts works through the arithmetic.

Bluesky counts graphemes. A grapheme is one visible character, so an emoji made of several code points still costs one. Counting code units instead would make a post look longer than Bluesky thinks it is.

Farcaster counts bytes of UTF-8. Plain English text costs one byte per character, so the 1,024 limit feels like 1,024 characters. Add emoji or accented letters and each one costs two to four, so the real limit drops. If you write in a non-Latin script there, the limit is far lower than it looks.

Use a counter that counts the way the network does, not the way a text editor does. The free character counter handles the weighting per network.

A pre-flight checklist

Before a post is scheduled, every one of these should have an answer.

  1. Pick the post type, not just the network

    Decide whether this is a feed post, a Reel, a Story, a thread, a poll, an event or an article. Everything else follows from that choice, and picking it last is how a vertical video ends up scheduled as a square feed post.

  2. Count the text the way the network counts it

    Check against the limit for the type you chose, with links weighted where the network weights them. The limit on a Telegram caption is not the limit on a Telegram message.

  3. Check the media against the type

    Enough images, not too many, a video inside the minimum and maximum length, and images and video not mixed where the network forbids it.

  4. Fill in the fields the network demands

    A board, a title, a document title, a poll question, event dates, a channel, a blog, a tag. If the composer does not ask, the network will.

  5. Crop for the type

    Vertical for Reels, Stories and Shorts. Square or portrait for feeds. Landscape where the feed is landscape.

  6. Look at a preview

    Read the first two lines as a stranger would. Most of what is wrong with a post is visible in the preview and invisible in the editor.

Why this is worth encoding rather than remembering

There are nineteen networks in that table, most of them with two or more post types, each type with its own limits and its own required fields. Nobody holds that in their head reliably, and the cost of getting it wrong is not a warning, it is a post that silently did not happen on the morning it mattered.

That is the argument for letting the tool carry it. In Picifer the rules live beside the product rather than in a document: each network declares its limits, post types and crops, the composer validates against the combination you chose, and the preview shows the result per network before anything is scheduled. When a network changes a limit, the rule changes in one place.

If you are building the plan those posts fit into, our guide to a social media content calendar covers the weekly routine, and why scheduled posts fail covers the failures that happen after a post looked perfectly valid.

Questions people ask

Why did my scheduled post fail to publish?
Most failures come from a rule the network enforces and the post broke: too many characters, a missing image on a network that requires one, images and video mixed in a post that cannot take both, a video that is too long or too short, or a required field left empty. The error a network returns usually names the rule, and a tool that validates before scheduling will flag it days earlier.
Do all networks have the same character limit?
No, and the range is enormous. A short post on Bluesky is capped at 300 characters, X at 280, Threads and Mastodon at 500, Instagram and TikTok at 2,200, Google Business Profile at 1,500, LinkedIn at 3,000 and a Facebook Page post at 63,206. Long-form networks such as WordPress, Ghost, DEV and Hashnode take whole articles.
Which networks require an image or video?
Instagram, TikTok and Pinterest will not accept a post without media, and YouTube needs a video specifically. Facebook, X, LinkedIn, Threads, Bluesky, Mastodon, Telegram, Discord, Google Business Profile and the blogging networks all accept text on its own, though most posts do better with an image.
Can I post the same text to every network at once?
You can send one idea everywhere, but not one block of text unchanged. Anything over 280 characters will not fit X, anything over 300 will not fit Bluesky, and a caption written for Instagram will read as a pasted paragraph on LinkedIn. Keep a main version and a tailored version per network.
What is a post type, and why does it matter?
A post type is one specific way of posting to a network: an Instagram feed post, Reel or Story; an X post, thread, poll or long post; a Google Business update, event or offer. Each one has its own rules, so a Reel is not validated against the loosest Instagram rule. Choosing the type up front is what makes the rules accurate.
Where do these limits come from?
From each network's own developer documentation, which is also what the publishing code is written against. Limits change when networks change them, so treat any list, including this one, as something to check rather than memorize, and prefer a tool that encodes the rules and warns you in the composer.
All guides

Put this into practice with Picifer

Picifer plans, writes in your brand voice, schedules to every network and shows you what works. Start free and plan your first week today.

  1. Connect your channels
  2. Teach it your voice
  3. Approve your week

14-day free trial · No card required · Cancel anytime

Start free, no card needed