Profile architecture

Write accessible image descriptions for portfolio samples

Write portfolio image descriptions that explain the evidence an image contributes while keeping privacy and context intact.

Reading-list saves stay in this browser. No account required.

Contents of this guide
THE SHORT ANSWER

Describe an image according to its purpose in the case study. Convey the essential information or function, avoid repeating nearby text unnecessarily and provide fuller explanation for complex evidence. Review descriptions for privacy and accuracy, and distinguish decorative images from those a reader needs to understand the work.

Identify what the image contributes

Ask why the image appears on the page. It may show an information structure, illustrate a material choice or link to a detailed case. A decorative visual has a different purpose from a diagram carrying essential evidence. Write the point in ordinary language before deciding on the description. If you cannot identify useful information beyond visual atmosphere, consider whether the image needs a descriptive alternative or whether an empty alternative is appropriate for its purely decorative role.

Review the surrounding text. A caption may explain the project status, while the image reveals a specific structure or comparison. The alternative should contribute the information needed by someone who cannot inspect the visual, rather than repeat the entire caption mechanically. Avoid descriptions based only on appearance, such as “beautiful dashboard,” when the professional point concerns how categories are arranged. Keep the description tied to the case’s actual evidence and your contribution instead of adding promotional claims.

Choose the appropriate level of explanation

For a simple informative image, a concise description can communicate the main point. For a complex chart or annotated workflow, provide an adjacent text explanation or accessible data presentation with enough detail to understand it. A long string of visual details in one short-description field can be difficult to use. Decide which information is essential to the reader’s task and where it belongs in the page structure. The aim is equivalent understanding of the relevant evidence, not a catalogue of every pixel.

If the image contains text central to the argument, make that text available as actual readable content rather than expecting a screenshot description to carry an entire document. When an image acts as a link, its accessible name should explain the destination or action. Check that captions and surrounding links do not create confusing repetition. A portfolio can often communicate the decision more clearly by presenting a short excerpt as text and using the image only as supporting context.

Review status, attribution and privacy

Keep the description consistent with the image’s status. A reconstructed screen should not be described as a live client system, and a proposed outline should remain a proposal. Include relevant distinctions in the surrounding text when they matter to interpretation. Check for sensitive details: removing a name from an image is ineffective if the alternative text still identifies the person or organization unnecessarily. Review the asset, caption, description and linked full-size version as one publication unit.

Read the page without looking at its images and ask whether the professional argument still makes sense. Then inspect the actual description in the implemented page, because a content entry does not prove that the template exposes it correctly. Avoid assuming that automatically generated descriptions understand the project’s purpose. Review them against the task and evidence. Revisit descriptions when images change, especially when a replacement uses different synthetic content or demonstrates another part of the work.

ILLUSTRATIVE WORKED EXAMPLE

Fictional example: describing an outline comparison

A fictional content designer, Osei, uses an independent example comparing two troubleshooting outlines. His first image description says “before and after diagram.” He rewrites the surrounding explanation to state the actual change: the proposed version groups instructions by task and keeps unresolved technical questions in a separate review list. A concise image description points to that structure without claiming that users performed better.

Osei marks the diagram as synthetic and makes the important headings available in ordinary page text. He checks that a private name removed from an earlier draft does not remain in the description. The fictional example illustrates purpose-based description rather than establishing that one text alternative is correct for every use of a similar diagram.

A checklist for your next step

  • Name the image’s purpose.
  • Coordinate description with nearby text.
  • Provide fuller complex-image explanation.
  • Check privacy and project status.
  • Review the implemented alternative.

Common questions

Should every image have a detailed description?

No. The appropriate alternative depends on purpose. Decorative images may need an empty alternative, while complex evidence may need fuller adjacent explanation.

Can I reuse the same description everywhere?

Only when the image serves the same purpose in each context. A linked thumbnail and a detailed case image may need different wording.

Further reading

These primary resources provide related background. They do not validate the illustrative example or endorse AliveProfile.

AI-assisted drafting and automated technical checks. Examples are illustrative; no independent expert review or real-world outcome validation is claimed. Read our editorial policy.

MOVE FROM READING TO A CLEAR NEXT STEP

Give your expertise a useful next step.

Create a private draft in this browser, review your own facts, then copy or download it. The workbench does not publish a profile, verify credentials or run an AI service.

Open the profile workbench