A staff portrait does not need the same text alternative everywhere it appears. Its role depends on the page: it may add information, repeat a nearby introduction or act as the only content of a link. Review that context before copying a description from the media library. A useful alternative communicates the image’s information or function without making the reader hear the biography twice.
Begin with the job of this image on this page
Consider a web editor receiving a new set of corporate portraits. The files will appear in a staff directory, on individual biographies and in a homepage panel linking to selected people. It is convenient to enter one description while uploading each file and allow the content system to reuse it. Convenience, however, does not establish what the photograph contributes in each place.
For a Toronto organization receiving Indigo Visual’s corporate headshots, image delivery is the point at which the web editor’s publication work begins. The editor needs to see how the portraits will be combined with names, roles and links. The photographer’s filename can identify a supplied asset, but it should not silently become the finished page’s accessible wording.
The W3C Web Accessibility Initiative’s guidance on informative images says the alternative should convey the image’s meaning or content. That does not require a literal inventory of everything visible. Decide what the reader needs from the photograph in this particular context, and keep that meaning distinct from information already supplied in text.
Ask why the image has been included. If the page uses a portrait to identify a person who is otherwise unnamed, that differs from a photograph placed beside an already complete name and introduction. If a photograph supports an article about a particular visual feature, that feature may matter there. The same portrait’s role is an editorial decision made in relation to the surrounding content.
A name beside the portrait may already carry the introduction
On a biography page, a visible heading may already give the person’s name, followed by their role and organization. The portrait could be supplementary to that introduction. The WAI guidance on decorative images includes images whose information is already provided by surrounding text. In that situation, a deliberate empty alt value may be appropriate so the image does not add redundant output.
That is different from leaving the alt attribute out. The same guidance notes that omission can cause some screen readers to announce a filename instead. An empty alternative is an intentional publication choice; a missing field may simply leave the system to expose something unhelpful. Check what the content system actually produces rather than assuming a blank-looking input always has the intended result.
Avoid automatically adding clothing, hair colour, a smile or a background location to every staff portrait description. Such details may be relevant in a particular piece of content, but their visibility alone does not establish their purpose. A biography introducing an operations manager should not acquire a long appearance description merely because the editor feels an alternative must contain as many words as possible.
Also avoid using the image field as a second biography. Job responsibilities, credentials and service claims should be reviewed and presented as actual page content. Putting extra assertions into a portrait’s alternative can create inconsistencies that colleagues miss when reviewing only the visible layout. If the introduction needs more information, fix the introduction where readers can encounter it as part of the page.
An image-only link needs a usable destination
Now move the same portrait into a homepage feature where the image alone links to the staff member’s biography. The reader needs to understand the link’s purpose. WAI’s guidance on functional images explains that the alternative for an image used as a link or control should convey the action or destination. A description such as “person wearing a blue shirt” would not explain where this link goes.
A concise destination such as the person’s biography can make sense for that particular link. Use the approved public name and the actual destination, rather than a camera filename or a generic instruction to click. Check that the link really reaches the named biography. Correct wording attached to the wrong destination still leaves a broken publication experience.
Distinguish that image-only arrangement from a single link containing both the portrait and visible text that already identifies the destination. If the person’s name and the image are inside the same link, repeating the same identification in both may add unnecessary duplication. Review the complete link with the developer or editor responsible for the component. Do not apply the image-only rule to every card that happens to contain a picture.
Separate links require a further look. A portrait and a name may appear visually as one card while the system makes them independent links. The publication team should understand that structure before deciding on the image’s wording. A visual screenshot cannot tell you everything about how the component will be encountered. The useful unit of review is the assembled element, including its text and interaction.
Review the assembled component rather than the media-library field
Put the draft page beside the editor’s intended reading. Does the name appear once or several times in succession? Does each link identify a destination? Has a supposedly decorative portrait turned into the only content of a clickable element after a layout change? These questions are easier to answer with the actual component than with a list of uploaded filenames.
Ask somebody familiar with accessibility testing to review the implementation using the site’s normal process. A well-chosen phrase is one part of the work, not proof that the whole page is accessible. Keep the review focused on the current layouts and record any component change that affects how the portrait is used. The same issue can recur if a redesigned card bypasses an earlier editorial decision.
When the portrait moves again, reconsider its job. A photograph that was supplementary on a fully labelled biography might later become a standalone link on an event page. Preserve the approved image while changing the alternative where its new purpose requires it. The important continuity is accurate communication with the reader, rather than identical wording attached to the file everywhere it travels.