All images must have a meaningful text alternative to meet WCAG 2.1 AA. A ‘meaningful text alternative’ is a text version of the image you have added to your social media post.
There are different ways to meet this requirement depending on what social media platform you are using.
How do I add a 'meaningful text alternative' to my social media post?
Every post with visual content must include a meaningful text alternative. Choose the method that works best for your post and your audience.
You can choose to use one technique, or multiple techniques. However, we recommend adding both alt text and an image description. This makes your content accessible to as many people as possible.
Here are three techniques to add a meaningful text alternative to your post.
Technique #1: Add Alt Text
Learn more about images and alt text.
Alt text is a text representation of an image that describes the content of the image. Alt text allows anyone who can’t view or access an image know what is going on in the picture.
Without alt text, folks who are using screen readers, folks with bad internet connection, and folks with low vision will miss out on important information and context that is included in photos.
Alt text should be brief. Aim for around 150 characters, or 1-2 sentences.
AI-Generated Alt Text
Some platforms add AI or auto-generated alt text to the images in your post. This alt text is, most likely, not accurate or complete. Make sure to review your post content for auto-generated alt text before posting.
Alt text is the best option for:
-
Any social media platform that lets content creators add alt text. Learn more about platform compatibility.
Examples of alt text on social media:
-
X: Image with Alt Text Description (@UCBerkeley on X) Note: On X, select the ‘ALT’ badge and the image description will appear.
-
Instagram: Collage with alt text descriptions (@CalAdmissions). On Instagram, alt text is only available using assistive technology. The alt text for the first image reads: “Two people stand with the UC Berkeley bear mascot (Oski) in front of a “Cal” sign at Memorial Stadium, smiling on a sunny day on campus.”
Technique #2: Include an Image Description
An image description is a text description that is added at the end of your social media post. An image description is available to all users, regardless of how they are accessing your content. Typically, an image description is much longer than alt text.
Image descriptions need to describe the purpose, context, and content of each image in your post. Be sure to include all important visual information and include any text that is in the image of your post.
Image descriptions are the best option for:
- Posts with multiple images.
- Complex images, like charts, graphs, or flow charts.
- Images that require more than 150 characters to describe them.
Image descriptions should be added:
- (Recommended) At the end of your post caption or
- In a pinned comment or
- In a subthread on your post.
Help users find your image description.
- Let users know where to find your image descriptions. Add the phrase 'Image descriptions available in the comments' or 'See subthread for image description' to your alt text or post caption.
- If possible, pin your comment so it is at the top of the comment feed. Make it as easy as possible for folks to find this information.
Note: If your image description exceeds the character limits for a post caption, consider adding this information to a comment or subthread.
Examples of image descriptions on social media:
Technique #3: Use Your Post Caption to Share Critical Information
If the information in your image is needed for folks to engage with your program, add this information directly to the main body of your post caption.
Place important details about your image to the top of your post caption. These details could include things like event name, location, date, time, and important links. This helps people find the information they need more easily.
Post captions are the best option for images of:
- Event Flyers
- Schedules
- Program Resources
Examples of text alternative in a post caption:
Event Flyer with details in the post caption (@berkeleyvcei on Instagram)
Does my platform support alt text?
Last updated: March 19, 2026
Always check your alt text before publishing a post.
Some platforms do not allow you to edit alt text after your post is published. It is important to add and review the alt text before posting images or GIFs.
- Manual alt text: If a platform allows ‘manual’ alt text, this means that you can add your own alt text to your images. We recommend always adding your own alt text if possible. This makes sure that you are able to describe with users exactly what the image you are showing is, and why it is important.
- Auto-generated alt text: If a platform allows ‘auto-generated’ alt text, this means that the platform adds its own alt text without your input. This alt text must be reviewed by a human and updated if it is inaccurate or incomplete. Learn more about AI Guidelines for Communicators.
Alt text support for specific platforms.
|
Social Media Platform and Post Type |
Alt Text Manual Entry (Recommended) |
Auto-Generated Alt Text (Requires human-review) |
|---|---|---|
|
Instagram Post |
Supported, edits allowed |
Available |
|
Instagram Story |
Not supported |
Not available |
|
Facebook Post |
Supported |
Available |
|
Facebook Story |
Supported, edits not allowed |
Available |
|
TikTok Image |
Supported, edits allowed |
Not available |
|
X Image or GIF |
Supported, edits not allowed |
Not available |
|
Threads |
Supported, edits not allowed |
Available, edits not allowed. |
|
BlueSky |
Supported, edits not allowed |
Not available |
|
LinkedIn Image or GIF |
Supported, edits allowed |
Available |
Social Media Image FAQ
Should I add alt text or an image description to my post?
We recommend adding both alt text and an image description to your post, if the platform you are using allows it. Alt text and images descriptions typically serve different purposes and support different audience members.
Should my alt text and my image description be identical?
No, we don’t recommend making your alt text and your image description identical. This can be repetitive for users.
Your alt text should be a brief description of your image, and your image description should include more content and important information.
Can images be marked as ‘decorative’ on social media?
No, most social media platforms do not provide the option to mark images as decorative.
If your image is decorative, add very brief alt text or an image description. This lets users know they are not missing any information or context.
If you have added all of the information in the image to your post caption or image description, add alt text that provides a brief description of the image's purpose and the location of the full description.
Example: Image of an Event Flyer
Event Flyer (@berkeleymse on Instagram)
In this example, all of the information in the event flyer has been added to the post caption. The content owner has added alt text that says: 'MSE seminar flyer. See caption for seminar title, location and time.'
Am I required to add my image description to my post caption? Can I add it to a comment or subthread instead?
We recommend adding your image description to your post caption so it is in a predictable location.
You may add your image description to a comment or a subthread, if needed. However, the post caption should let users know where to find the full image description. Add the phrase "Image descriptions available in the comments" or "See subthread for image description" to your post caption.
Examples
- Comment example: Image Descriptions in Comments (@NasaHubble on Instagram)
- Subthread example: Video Description in Subthread (@BerkeleyInspire on X)
What if my alt text exceeds the character limit?
If your alt text is very long and exceeds the platform’s character limit, consider adding this information as an image description instead.
Alt text should be brief. Aim for around 150 characters, or 1-2 sentences.
What do I do if my image description is very long?
If your image description is very long, it might exceed the character limit for your post caption. If this happens, we recommend adding your image description in a different location, like a comment or a subthread.
Let users know where to find this information by adding a note like: ‘See [alternative location] for image description’.
For example, Instagram has a 2,200 character limit for post captions. If your image description exceeds the character limit of your post caption, the image descriptions could be added in a comment, which also has a 2,200 character limit. If your image description exceeds the character limits for comments, consider breaking up the information into multiple comments.
Example: Image Description Exceeds Character Limit (@NasaWebb on Instagram)