How to Write Alt Text for Website Images
Write image alt text based on the purpose of each picture, with practical examples for product photos, portraits, linked images, and decorative details.
Write alt text that communicates the purpose of an image in its page context. Describe the relevant information in a useful photo, explain the destination or action of an image-only link, and use an empty alternative for purely decorative images. Put detailed explanations of charts or complex visuals in nearby text instead of forcing everything into one image description.
Build your own creator page with Webicly — free, no code.
The same picture can need different alt text on different pages. A photo of a ceramic mug might show a product finish, illustrate a workshop, or simply decorate a banner. Decide why you included it before trying to describe every visible detail.
Decide what the image contributes to this page
Look at the image alongside its heading, caption, and surrounding copy. Ask what a visitor would miss if the picture were unavailable. On a product page, that might be the shape of a handle or the pattern on a cover. On an about page, it may simply be the identity of the person pictured.
W3C provides an alt text decision tree that distinguishes informative, decorative, functional, and other image uses. Choose the role first, then write the alternative around that role.
Describe the useful detail rather than the whole scene
For an illustrative product example, "Blue ceramic mug with a wide handle and speckled glaze" is more useful than "Product photo." It gives a reader information they cannot get from the item name alone. If the page already identifies the product, focus on the additional detail this particular view provides.
For a service portfolio, "Restaurant menu photographed beside the finished printed menu" may explain the comparison. Avoid adding an imagined mood, result, or customer reaction that the picture does not establish. Alt text should help explain the image, not turn it into an unsupported testimonial.
Handle portraits and decorative pictures differently
A portrait beside an introduction can use a short description such as "Nina Patel, workshop host." You rarely need a long inventory of clothing, hair, and background objects unless those details serve the page. Check whether the nearby text already supplies the same identification.
A decorative flourish needs a different decision. If removing a background shape or divider would not remove information or function, an empty alternative may be appropriate. Do not invent a description merely to fill a field. The goal is useful information, not an announcement for every visual detail.
Explain the action of an image-only link
Imagine a resource cover that is the only clickable route to a checklist. An alternative such as "Download the event planning checklist" can explain what selecting the image does. "Green cover with white lettering" would describe the appearance but leave the destination unclear.
Consider the complete link before adding words. If the same link already includes visible text that names the resource, repeating that full label in the image alternative may be unnecessary. Test the combined result, especially when a template puts an image and a button beside each other.
Keep complex information available as real text
A chart showing several pricing scenarios needs more than a sentence listing colors. Explain the main point near the chart and provide the underlying figures or a suitable text equivalent. The image alternative can identify the chart and point to the fuller explanation.
Similarly, do not place the only appointment instructions or offer conditions inside a promotional graphic. A useful page still explains the essentials in text that visitors can read, enlarge, and search. Treat the graphic as support for that explanation, rather than the sole container for it.
Add the alternative without stuffing in search terms
Webicly image elements have an image description field in their properties. Write the alternative for the specific image, then review it with the surrounding content. If you replace the picture, revisit its description rather than keeping words written for the old file.
Google discusses descriptive alternatives and warns against keyword stuffing in its image SEO guidance. A string of service names is not a useful substitute for a picture. Keep promotional claims in the visible copy where you can explain and support them.
Check the page without relying on the images
Read the headings, body copy, links, and image alternatives as a sequence. Can someone understand the offer and take the intended next step? Ask a reviewer to describe any point where a picture seems to contain information the text never supplies.
Use the published page for the final check. Review repeated images, mobile crops, and any linked thumbnails. A well-written alternative does not fix a confusing link destination or a missing product detail elsewhere; it works alongside the rest of the page.
Frequently asked questions
Does every image need a long description?
No. The alternative should fit the purpose. Some informative images need a short description, decorative images can have an empty alternative, and complex visuals need a fuller explanation nearby.
Is a caption the same as alt text?
No. A caption is visible page content. Alt text provides an alternative for the image. Consider them together so they explain what matters without repeating unnecessary information.
Should I put my main keyword in every image description?
No. Describe the image in context. Repeating a search phrase across unrelated images makes the alternatives less useful and can misrepresent what the pictures show.
What should an image-only link describe?
Make its destination or action understandable. If visible text already labels the same link, check the combined label before repeating that wording in the image alternative.
Primary sources checked
These sources support the guidance and product details in this article.