
A photo used as the only content of a download link needs an accessible name that explains the download action. A description such as ‘portrait against a blue wall’ may describe the picture accurately while leaving its link purpose unclear. W3C's functional-image guidance distinguishes an image that initiates an action from an image that supplies information.
Key Takeaways
- Judge the whole link, including its visible text and image, before changing its name.
- Tell users what the link does and identify the relevant photograph.
- Verify the action and the delivered file separately.
Inspect the complete download control
Open the gallery item as the client will encounter it. Note whether the image is the entire link, whether a visible filename is inside the same link, or whether a separate Download button already carries the action. These arrangements require different naming choices. Adding ‘download’ to every nearby image can create repetition without fixing the actual control.
The W3C images tutorial bases alternatives on purpose and context. The same portrait could be an informative portfolio illustration on one page and a functional download control on another. Reusing one description in both places may omit the second page's task.
Identify the action and the selected item
For a proposed client gallery, ‘Download approved portrait 07, full-size JPEG’ is a useful name only if that is the real item and result. Do not promise full size, a file type or approval status that the destination does not establish. A link opening a preview should describe that preview rather than claim to download the original.
Where a visible text label already communicates the action inside the link, avoid having an image alternative repeat the same wording without a purpose. Review what the combined control actually exposes. Changing the photograph's metadata does not necessarily change the accessible name of the webpage link. The delivered page must be checked.
Test navigation before file delivery
A proposed acceptance pass starts by navigating through the gallery links without relying on the picture. Can the reviewer distinguish this portrait's download from the next one? Does the announced purpose match what activating it does? Record the page, item identifier and observed name if it does not.
Then download an authorized test item and inspect its filename, dimensions and format. A clear link name does not prove that the server supplied the intended file. Conversely, a correct JPEG does not resolve an unnamed action. Accept the handoff when both the control's meaning and the actual file match the agreed gallery contract.
Keep the control check separate from image description
Use the guide to alternative text for the photograph's informational role; a download control additionally needs its action understood. If the gallery includes detailed technical data, preserve that through the structured-description workflow, rather than packing it into every download name. During the same rehearsal, inspect selection in forced-color modes so the client can identify the intended item before activating it. These are separate acceptance observations, not proof supplied by a meaningful alt attribute alone.
Related tasks
- Should I Use My Generation Prompt as Alt Text for an AI Image?
- How Do I Explain a Diagram When One-Line Alt Text Is Not Enough?
- Why Does My Selected Photo Lose Its Border in Windows High Contrast?
Sources and scope
- Functional Images, W3C WAI: A functional image's text alternative conveys its action or destination.
- Images Tutorial, W3C WAI: The image's purpose and context determine the appropriate text alternative.
Documentation-based guidance reviewed October 31, 2026. The gallery example and acceptance checks are proposed; no live gallery or screen-reader test was performed.
Prepared by Imagild Editorial, the company editorial team responsible for these guides. AI assisted research and drafting. This is documentation-based guidance with proposed examples, not a claim of hands-on testing or an independent product review. Report a correction.
Cover: AI-generated conceptual editorial illustration; not a real application screenshot, observed output or before-and-after test.