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:
- 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.
- 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.
- 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."
- 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.
- 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 |
| 1,000 characters | Single photos and carousel photos; not Reels or Stories | |
| Threads | 1,000 characters | Yes |
| Facebook Page | not published | Yes |
| 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 |
| 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.
- Create a post, select your accounts and add your images.
- 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.
- 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.
- 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
Feature
AI create
Get caption ideas in the editor, turn an article or video into a draft for every account, and keep the tone in line with a saved brand voice.
Feature
Post editor
Write once, adjust per account, preview it the way each network shows it and pick the format: Reel, Story, thread, offer, board or privacy.
Free tools for this guide
Free tool
Alt text generator
Upload an image and get alt text for your social posts: a short or detailed description plus a shorter version. Free, and we don't keep your image.
Free tool
Social media image sizes, with a free resizer
Image sizes for Instagram, Facebook, LinkedIn, X, TikTok, YouTube, Pinterest and more, each with its source. Crop and resize your image in the browser.
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
- W3C WAI: Images tutorial (a short description conveying the essential information)
- W3C WAI: Images tutorial, tips (concise, important information first, no "image of")
- WebAIM: Alternative text
- Eric Eggert: There is no character limit for alt text, myth debunked (19 February 2022)
- X developer docs: Create media metadata (alt_text, maxLength 1000)
- Meta for Developers: Instagram IG User Media (alt_text, images only, up to 1000 characters)
- Meta for Developers blog: alt_text for Instagram Feed images (24 March 2025)
- Instagram Help: Edit the alternative text for a post on Instagram
- Meta for Developers: Threads publishing reference (alt_text up to 1,000 characters)
- Meta for Developers: Page photos (alt_text_custom)
- Facebook Help: Automatic alternative text
- Meta AI blog: How Facebook is using AI to improve photo descriptions (19 January 2021)
- Microsoft Learn: LinkedIn Images API (altText up to 4,086 characters, under 120 recommended)
- LinkedIn Help: Add alternative text to images
- Bluesky social-app source: MAX_ALT_TEXT = 2000
- Mastodon docs: Instance entity (description_limit, set per server)
- Pinterest API v5 OpenAPI description (alt_text maxLength 500)