Twitter Alt Text: Write Image Descriptions That Work

Good alt text helps people using screen readers understand the important information in an image on Twitter, now called X. Describe what matters in the context of your post, rather than listing every visible detail or repeating the caption. You’ll need access to the post composer and, ideally, a clear idea of what the image is meant to communicate.

What You’ll Need

A photo, graphic, screenshot, or other image you plan to post.
The post’s context: why you’re sharing the image and what readers should take from it.
Access to Twitter/X on the web or in its mobile app. Controls and labels can vary slightly by version.
A moment to review the description for accuracy, clarity, and unnecessary detail.

Step-by-Step

Work out what the image is doing. Before writing, ask what a reader would miss if they could not see the image. Is it a photo documenting an event, a chart supporting a claim, a meme, a product picture, or a screenshot showing an error? The answer determines what deserves space in the description. For example, a photo accompanying “We finally opened the doors” may need to identify the people or scene and the opening-day banner, not describe every object in the room.
Check the surrounding post. Read the text you’ll publish with the image. Alt text should add useful visual information, not mechanically repeat the post. If your post says, “The blue line rises sharply after June,” describe the chart’s axes, the blue line’s trend, and any relevant values or labels that are visible. If the post already names the person in a photo, you may not need to repeat the name unless it helps make the image description clear.
Open the image’s alt-text control. Start a post and attach the image. Before publishing, open the image’s editing or accessibility controls and choose the option labeled “ALT,” “Add description,” or similar. On many versions of the app, an ALT badge appears on the image; selecting it opens a description field. On the website, look for an alt-text or description control associated with the attached image. If the label or location differs, check the image’s menu or accessibility settings rather than assuming the post text is a substitute.
Write the key information first. Use plain language and lead with what matters. A useful pattern is: “What it is, who or what is shown, and the significant action, detail, or result.” For a photo, that might be: “A golden retriever in a red harness waits beside a trail sign marked ‘Summit, 2 miles.’” For a chart, explain its subject and the important pattern. For a screenshot, identify the app or screen and the message or control the post discusses.
Include details that change the meaning. Mention relevant text, colors, positions, expressions, or visual relationships when they help someone understand the point. Transcribe short, important text accurately. If the image contains a long passage, describe its purpose and summarize the key information rather than trying to squeeze every word into a cramped description. For complex charts or infographics, add the full data or explanation in the post or a linked accessible document when possible.
Keep the wording concise, but not at the expense of meaning. There is no magic sentence length that makes alt text good. A simple image may need one short sentence; a detailed diagram may need more. Remove decorative flourishes, guesses, and details unrelated to the post. Don’t begin with “Image of” just to announce that it is an image; screen readers generally identify image content already. Do name the kind of image when it clarifies the description, such as “A map shows…”
Use uncertainty honestly. Don’t infer someone’s identity, feelings, or background from appearance alone. Say “a person in a green coat” rather than assigning a name or a personal characteristic you cannot verify. If a blurry image makes a sign unreadable, say that it is unreadable instead of inventing its wording. A straightforward description is more useful than a confident but inaccurate one.
Save the description and verify it. Confirm the text is attached to the correct image, especially in a post with several pictures. Save or close the description field as the interface requires, then check the composer for an ALT badge or other indication that a description was added. If practical, inspect the image’s accessibility information using the app’s controls or a screen reader before publishing.
Publish and review the post. Post the image and its text together. If you notice a typo or realize the description is wrong or missing, use the available post-editing controls if they support changing image descriptions. Otherwise, delete and repost only if that is appropriate for the situation; do not assume editing the visible caption also changes alt text.

Common Mistakes

Leaving the field blank: The post caption does not automatically explain what is shown in an image.
Repeating the caption word for word: Add visual facts instead, unless repetition is needed to make the description understandable on its own.
Writing a visual inventory: Listing every color, object, and background detail buries the point. Prioritize details that support the post.
Using vague labels: “A chart” or “a funny picture” does not explain the information or joke. Describe the relevant trend, text, or visual action.
Guessing: Don’t invent text hidden by blur, identify an unknown person, or state an interpretation as fact.
Putting essential information only in the image: Alt text helps, but longer explanations, detailed datasets, and important instructions may need to appear in accessible post text too.

Tips

Write for someone who has not seen the image, but give only the context needed to understand this post.
For a meme, describe both the relevant visual and any text needed to understand the joke; don’t assume the template is familiar.
For a screenshot, include the key message or error text and where it appears, while leaving out unrelated interface clutter.
For a photo, describe the action and meaningful setting before minor appearance details.
For multiple images, provide a separate description for each image and make their order or relationship clear when it matters.
Read the description aloud. If it sounds confusing, overloaded, or unlike a useful explanation, revise it.

Troubleshooting

You can’t find the alt-text option: Attach the image first, then look for an ALT badge, image-editing menu, or accessibility/description control. Update or restart the app if controls are missing, and try the web version or mobile app as an alternative. Menu names and placement can change.
The description doesn’t seem to save: Reopen the image’s description field before publishing and check that the text remains. If it disappears, enter it again and use the field’s save or close action. Avoid navigating away while a description is still being edited.
You posted without alt text: Check whether the post’s edit option lets you change the image description. If not, you may be able to add the missing context in a reply, but that is not the same as attaching alt text to the image. For an important post, consider reposting with a description included.
The description is too long or hard to follow: Keep the main subject and essential information, then move extensive data or a full transcription into accessible post text or a document. Break complex information into a clear summary rather than compressing it into one run-on sentence.
Several images are mixed up: Open each image’s description separately and confirm the content matches that image. Describe sequence or comparison where relevant, such as “first panel” and “second panel.”

Frequently Asked Questions

What is alt text on Twitter/X?
It is a text description attached to an image so people using assistive technology can understand relevant visual information.

Is alt text the same as the post caption?
No. The caption is the post’s visible text; alt text describes the attached image. Use each for information that belongs there.

How long should Twitter alt text be?
Long enough to communicate the image’s important meaning, but no longer than necessary. A simple photo may need one sentence; a complex graphic needs more detail.

Should I write “image of” at the beginning?
Usually not. Start with the subject or information. Mention “photo,” “chart,” or another format when it helps explain what follows.

Do I need alt text for every image?
Whenever an image carries information or meaning, provide a useful description. For purely decorative images, avoid inventing significance; follow the platform’s available accessibility controls.

Can alt text replace a transcript or data table?
Not for substantial content. Summarize the image in alt text and provide long text, detailed data, or a full transcript in an accessible format as well.

General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.

More in this bed

The whole Tech How-To bed →