In WordPress, alt text explains an image’s purpose to someone who cannot see it; a caption is visible text alongside the image. The Media Library title is another field again. A useful review starts with the image’s role on a particular page, then checks the actual published output. Filling every field with the same phrase is not a reliable content strategy.
A business website may use a photograph to show a product detail, introduce a team or simply balance a layout. Those uses need different treatment. Before writing anything, ask: what would a visitor miss if this image disappeared?
Choose the purpose before the wording
For an informative image, describe the information that matters in that context. An illustrative example is “Blue ceramic mug with a curved handle and speckled glaze” on a product page where those features help someone choose. “Our best products” does not communicate the same detail. The example is fictional, not a claim about a client project.
A decorative image adds atmosphere without information or functionality. An empty alt attribute can be appropriate for that use. Do not confuse a deliberate empty alternative with forgetting to review the image. W3C’s alt decision tree helps distinguish the cases; a purely decorative flourish should not acquire a long keyword list.
If the image itself is a link or control, its text alternative needs to explain the destination or action as appropriate. Describing “a magnifying glass” may be less useful than identifying the search function. Review the surrounding link text too, because the complete control matters. W3C provides separate guidance for functional images.
Use captions for information people should see
A caption can identify a place, explain what an illustration represents or give a relevant credit. It appears with the picture when the chosen block or template displays it. If a limitation or explanation is necessary for everyone to understand the page, keep it visible rather than hiding it only in alt text.
For example, a generated editorial illustration can be labelled as conceptual when that distinction matters. A caption is not evidence that a real client, office or test result was photographed. Avoid duplicating a long surrounding paragraph word for word in the alternative text; decide what each part contributes.
Check the placement, not just the Media Library
The WordPress Image block documentation distinguishes the alternative text on a particular block from the Media Library default used when inserting an image. Changing the library field does not prove that every existing placement has changed. WordPress’s Edit Media guide also explains that inserted images can have their own details.
Open the relevant page in its editor and inspect the actual image block or builder widget. Confirm the intended alternative, caption and link there. Then save, reload the normal public page and check its rendered image and visible caption. A featured image, gallery and page-builder image may follow different template controls; inspect each relevant placement rather than assuming one library change covers them all.
A practical handover check
For each important image, record the page, its purpose, proposed alternative, visible caption if needed, and any link destination. Check desktop and phone presentation. Confirm that the picture loads, the caption is readable and a linked image takes visitors to the expected destination. Use an appropriate accessibility review to examine the rendered alternative; appearance alone cannot establish it.
Questions website owners often ask
Should every image repeat my main keyword? No. Describe the relevant content or function naturally. A location or service term belongs only when it helps explain the actual image in context.
Is an image title enough? Do not assume it replaces alt text or becomes a visible caption. WordPress stores separate fields, and the block or template determines what visitors receive.
Does good alt text guarantee rankings or full accessibility? No. It is one part of useful, accessible content. It does not establish that headings, forms, keyboard operation or the rest of the site are correct.
If you are preparing a WordPress website or reviewing existing pages, gather the images and the pages where they appear. Our SEO and content service can help plan a page-level review with clear checks and an agreed scope.
