AI Alt Text for Social Media Images: Draft, Check, Post

Let AI draft alt text for your social images, then fix the five things it gets wrong. Alt text limits per network, and how to add it when you schedule.

A social post image with an alt text box below it: an AI draft crossed out and a shorter corrected description with a checkmark

Guide · By PostBoost team · · Markdown

Short answer: let AI write the first draft, then check it before you post. A vision model describes the subject, the action, the setting and most of the text in an image in seconds. It also misreads small text, can't know who is in the photo and doesn't know why the image is in your post, so read every draft against the image and fix five things (below). Keep it to one sentence where you can, and add it to the image itself before you schedule. The free alt text generator writes a draft for any image, and PostBoost's composer has a Generate with AI button on every image.

What good alt text does on social media

Alt text is the description a screen reader reads aloud instead of showing the image. On social media the image usually is the message: the launch graphic, the chart, the quote card, the product photo. Without alt text, a screen reader user hears the caption and then nothing, or Meta's automatic guess.

The W3C's images tutorial asks for "at least a short description conveying the essential information", and its tips page adds three rules that matter most for posts: be concise, put the most important information first, and leave out words like "image" or "picture", because the screen reader already says it's an image.

That makes alt text different from a caption. The caption says what you want to say about the image. The alt text says what is in it, so someone who can't see it gets the same thing everyone else does.

The five things AI alt text gets wrong

Here is a typical case. You post a launch graphic for a webinar: a blue banner, a photo of your head of product, and the words "Live Q&A: what's new in v3, Thursday 4 p.m. UTC". An AI draft, from a model that can't know who is in the photo or what the post is for, often looks like this:

A smiling woman in a blue shirt next to text about a live event on a blue background.

Everything in it is true, and it misses the point. After the five checks:

Webinar banner: "Live Q&A: what's new in v3, Thursday 4 p.m. UTC", with a photo of our head of product.

(The example is made up; the pattern is what to look for.) The corrected version leads with what the image is, quotes the text exactly and drops the shirt colour, which tells a listener nothing. The five checks:

  1. Words in the image, copied exactly. If an image contains text, that text is usually the message. AI summarises it ("text about a live event") or misreads small print and numbers. Copy dates, prices, times and headlines word for word.
  2. Names, products and places. A model can describe a person but not know who they are, and it shouldn't guess. Add the name yourself when it matters to the post, or leave the person undescribed beyond what is visible.
  3. The number on a chart. "A bar chart with blue bars" tells nobody anything. Give the takeaway: "Bar chart: signups grew from 120 in May to 410 in September."
  4. Why the image is in this post. The same photo needs different alt text in a hiring post and in a product launch. Tell the AI what the post is about, or rewrite the first few words yourself.
  5. Guesses and filler. Delete "image of", feelings and ages the image doesn't show, and words like "possibly". Meta's own automatic alt text starts every description with "May be" because, in Meta's words, "there is a margin for error". Yours shouldn't need to.

How long should alt text be?

Usually one sentence. There is no screen reader that stops reading at 125 characters: Eric Eggert, who worked at the W3C's accessibility initiative, found that no screen reader cuts alt text off; one of them, JAWS, reads long alt text in chunks, which is the likely source of the myth. WebAIM says "typically, only a few words are necessary, though rarely a short sentence or two may be appropriate", and LinkedIn's API documentation recommends under 120 characters.

Longer is right when the image carries more: a chart with several numbers, a screenshot of steps, a slide full of text. Then write the key information, not every word. The free generator has two lengths for this reason: Short (up to 125 characters) and Detailed (up to 250).

Alt text limits on each network

Every major network takes far more than you need. What matters for scheduling is whether the network's publishing API accepts alt text at all, because that is how PostBoost and every other scheduler posts.

Network Alt text limit Through a scheduler (PostBoost)
X 1,000 characters Yes
Instagram 1,000 characters Single photos and carousel photos; not Reels or Stories
Threads 1,000 characters Yes
Facebook Page not published Yes
LinkedIn 4,086 characters (API); under 120 recommended Yes
Bluesky 2,000 characters Yes
Mastodon set by each server (1,500 in the docs' example) Yes
Pinterest 500 characters Yes
TikTok, YouTube, Google Business Profile No alt text field through PostBoost

The X, Instagram, Threads and Pinterest limits come from their API documentation, LinkedIn's from its Images API, Bluesky's from the app's source code and Mastodon's from the instance settings in its docs. In PostBoost, alt text is for images: videos have no Edit alt text option. Instagram only added alt text to its publishing API in March 2025, and its reference still says "Reels and stories are not supported". For a Reel, a Story or a TikTok, say what matters in the caption or on-screen text instead.

Add AI alt text when you schedule in PostBoost

In PostBoost, alt text belongs to the image, not to the post. You write it once and every network that publishes the image gets it.

  1. Create a post, select your accounts and add your images.
  2. If an image has no alt text, the composer shows a suggestion: "1 image has no alt text, which …" followed by the networks that read it out, with an Add alt text button. You can also open the image's ⋮ menu and choose Edit alt text.
  3. In the Edit alt text dialog, click Generate with AI to fill in a draft (JPG, PNG, WebP or GIF images), then run the five checks and edit it.
  4. Click Save. An ALT badge appears on the image; click it to read the text back.

Generating alt text uses your workspace's AI credits, like the other AI features. The same Edit alt text option is in each image's menu in the media library, so a logo or product photo you reuse keeps its description. Because the text travels with the image, check that it still fits when you reuse it in a different post. More on the editor's other checks is on the post editor page, and the AI features page covers captions and images.

Alt text from the API or an AI agent

The same steps work from code. Upload the image, ask PostBoost to describe it, then correct it:

curl -X POST "https://postboost.co/app/api/$WORKSPACE_UUID/ai/image-alt-text" \
  -H "Authorization: Bearer $POSTBOOST_API_TOKEN" \
  -H 'Content-Type: application/json' \
  -d "{\"media_uuid\":\"$MEDIA_UUID\"}"

The response returns alt_text and credits_used (1 per call), and the text is saved on the media item. To fix it, send PUT /{workspaceUuid}/media/{mediaUuid} with {"alt_text": "..."}; the API accepts up to 500 characters, which fits every network in the table. If you already have the description, pass alt_text when you upload (POST /{workspaceUuid}/media/base64). Fields and examples are in the API reference: image-alt-text, update-media and upload-media-base-64.

An AI agent connected to PostBoost does the same with the imageAltText and updateMedia tools on the full MCP server (https://postboost.co/mcp/postboost), or passes alt_text to upload-media on the connector. Tell it to show you the alt text before it schedules: the five checks apply to an agent's draft too. The guide to letting an AI agent post safely covers the review step.

For an image that isn't in PostBoost yet, the alt text generator takes an upload (up to 1 MB without an account, 5 MB with a free one) and an optional line about what the post is about, and returns one alt text plus a shorter alternative, each with its character count. It doesn't keep your image. With an API token it is also POST /app/api/tools/alt-text-generator and the generate-alt-text tool on the free tools MCP server (https://postboost.co/mcp/tools).

A quick checklist before you post

  • The text in the image is in the alt text, word for word.
  • No guessed names, ages, feelings or "may be".
  • A chart or screenshot gives its key number or step.
  • The first words say what matters for this post.
  • No "image of" or "picture of".
  • One sentence unless the image carries more.
  • Reels, Stories and TikToks: the important part is in the caption instead.

Images sized right matter as much as described right: the social media image sizes tool crops a photo to any network's size in your browser, and the Instagram post size guide explains why scheduled posts need 4:5. New to PostBoost? Create a free account.

Do this in PostBoost

Free tools for this guide

FAQ

Can AI write alt text for social media images?

Yes, and it is a good first draft: vision models describe the subject, the action, the setting and most text in an image in a few seconds. Read it before you post. AI misreads small text, can't know who a person is or why the image is in your post, and sometimes adds guesses.

How long should alt text be on social media?

As short as it can be while saying what matters, usually one sentence. There is no screen reader cut-off at 125 characters; that number is a myth. LinkedIn's API docs recommend under 120 characters, and images with data or a lot of text need more. The network limits are higher: 1,000 characters on X, Instagram and Threads, 2,000 on Bluesky, 500 on Pinterest.

Should alt text start with "image of"?

No. Screen readers already announce that there is an image, so "image of" or "picture of" only adds words. Start with the subject. Do say "screenshot", "chart" or "illustration" when the type of image matters.

Does Instagram alt text work on Reels and Stories?

Not when you schedule. Instagram's publishing API takes alt text only for single images and images in a carousel; its documentation says Reels and stories are not supported. In the Instagram app you can add alt text under Accessibility when you post, and edit it later.

Is automatic alt text from Instagram or Facebook good enough?

It is a fallback, not a description. Meta's automatic alt text lists objects it recognises and starts every description with "May be" because it can be wrong. It does not know your product, the text on your graphic or why you posted the image. Write your own.

Do I need alt text on every image?

On every image that carries information, yes. A purely decorative image, one that adds nothing to the post, can have empty alt text so screen readers skip it. On social media almost every image carries the message, so most need a description.

Sources

Related guides

Try PostBoost free

API, webhooks and MCP on every plan, including Free. No credit card required.