Alt text, short for alternative text, is a written description of an image that screen readers read aloud for people who are blind or have low vision. It also appears when an image fails to load, and it helps search engines understand what a picture shows. For anyone who creates content, whether a social media post, a blog, a portfolio or an NGO report, writing good alt text is a small habit that makes your work usable by more people.
This guide explains what alt text is for, where to add it, how to write it well for different kinds of images, the common mistakes to avoid and a set of illustrative examples you can adapt.
Why alt text matters
Screen reader users hear the alt text in place of the image. If it is missing, they may hear nothing, or only a file name such as “IMG_4021.jpg”. If it is vague, such as “image” or “photo”, they miss the information everyone else can see.
International accessibility standards treat this as a basic requirement. The Web Content Accessibility Guidelines include a success criterion on non-text content, which asks that images and other non-text content have a text alternative that serves the equivalent purpose. In India, the Guidelines for Indian Government Websites also cover accessibility for public websites. Even when you are not legally required to follow these standards, they are a useful benchmark for good practice.
Where to add alt text
- Websites and blogs: in WordPress, select an image in the editor or Media Library and fill in the Alt Text field. Other website builders have a similar field.
- Instagram: you can write custom alt text when you post and edit it later. Instagram explains how in its help article on editing the alternative text for a post.
- Facebook: Facebook can generate automatic alt text, described in its help page on automatic alt text, but automatic descriptions are often general, so it is worth checking and replacing them.
- Documents and presentations: word processors and slide software let you right-click an image and add alt text, which matters when you share reports as PDFs.
How to write alt text that helps
Start with the purpose
Ask why the image is there. The same photo may need different alt text in different places. A photo of a woman filming with a phone could be described for its subject in a career guide, but for its technique in a tutorial about holding a phone steady. The W3C alt decision tree is a simple tool for working out what an image needs.
Be specific and concise
- Describe what matters: who or what is shown, the action, and any important detail.
- Keep it short. One or two clear sentences is usually enough. Many guides, including WebAIM’s guide to alternative text, recommend being succinct.
- Do not start with “image of” or “picture of”. Screen readers already announce that it is an image. Saying “Photograph of” or “Illustration of” is fine when the medium itself matters.
- Put the most important information first.
Include text that appears in the image
If an image contains words, such as a poster, a quote card or a screenshot, the alt text should include those words, because a screen reader cannot read text inside a picture.
Handle different image types
- Informative images: describe the information, briefly.
- Decorative images: dividers and background patterns that add nothing should be marked as decorative so screen readers skip them. In HTML this means an empty alt attribute. The W3C page on decorative images explains when this applies.
- Functional images: if an image is a link or button, describe what it does, such as “Download the brochure”, not what it looks like.
- Complex images: charts, maps and infographics need a short alt text plus a longer description nearby, such as a summary paragraph or data table. See the W3C guidance on complex images. Our guide on how to create infographics covers design for these.
Describe people respectfully
Describe what is visible and relevant, such as clothing, expression or action, without guessing at someone’s identity, religion, caste or disability. If you are naming someone, make sure you have the right to identify them.
Common mistakes to avoid
- Leaving alt text blank on an informative image.
- Using the file name or the same words as the caption.
- Stuffing keywords for search. It makes the description useless and can harm trust.
- Writing a paragraph for a simple image.
- Forgetting text inside images, such as event details on a poster.
- Using only an image for important information, such as a phone number or date, without the same information in text.
Illustrative examples
These examples are illustrative and describe imagined images.
- Workshop photo for a blog post: “Six women sit around a table editing video on laptops while a trainer points at one screen.”
- Event poster on Instagram: “Poster in purple and yellow: Photography walk, Sunday 10 am, Sector 18 market. Register through the link in bio.”
- Product photo: “Black cotton tee with a white printed logo, laid flat on a wooden surface.”
- Bar chart in a report: “Bar chart showing the number of workshop sessions held each quarter, rising from Q1 to Q4. Full figures in the table below.”
- Decorative line between sections: marked as decorative, with no alt text.
- Logo linking to the home page: “Karuna Media home page.”
Alt text checklist
- Does the alt text say what the image means in this context?
- Is it one or two clear sentences, with the key information first?
- Does it include any words shown inside the image?
- Have I avoided “image of” and keyword stuffing?
- Are decorative images marked so screen readers skip them?
- Do charts and infographics have a longer description nearby?
Alt text works best alongside other accessibility habits, such as captions for video. Our guides on how to add subtitles to videos and how to write Instagram captions cover those next steps.
Build your digital media skills
Accessible content is part of professional communication in journalism, marketing and nonprofit work. If you would like structured training in media and digital skills, explore our programmes and apply here. You can also donate to support media training for women.
The Giving Movement by Karuna Media · #TheGivingMovement
Wear the cause: tees, a tote and a mug that fund media training for women
Tee (Black) ₹699 · Tee (White) ₹649 · Tote ₹449 · Mug ₹399. Printed on demand and shipped across India. 100% of the profit funds media training for underprivileged women.
Buy now on Razorpay Prefer to donate? Go to our donate pageMerch is a purchase, not a donation, and is not eligible for 80G. To make a donation, use our donate page.
