Alt text for portfolio images: a practical guide for freelancers
Alt text should communicate the purpose or relevant meaning of an image, not repeat a filename or describe every pixel.
Decide what job the image is doing
W3C’s alt-text decision tree starts with the image’s purpose. An informative image needs a text alternative that conveys its relevant meaning; a functional image needs to explain the action or destination; a purely decorative image can use an empty alternative so it does not add noise.
Do not begin with the file name or a generic phrase such as “image of”. Ask what a reader would miss if the image were not visible, and describe only the information needed in that context.
Write concise alternatives for project samples
For a portfolio screen, say what the screen shows and why it matters to the case study: “Checkout wireframe showing the delivery-choice step” is more useful than “wireframe final 3”. If the nearby caption already gives the same information, avoid repeating it word for word.
If the image is a link, make sure its alternative tells the reader what the link opens or does. If the image contains text that is not available elsewhere, include the essential wording in the alternative or nearby page text.
Check complex images separately
A detailed diagram, chart or dense screenshot may need more than a short alt attribute. Provide the important data, labels or conclusions in surrounding text, a table or a separate long description so the information is available without the image.
Treat the W3C decision tree as a way to choose an approach, not as an automatic accessibility certification. Review the image in the context of the whole page and test it with the tools available to you.
UK considerations
This is general CV guidance. Follow the UK employer, client or application system’s instructions, especially when it requests a specific format or set of details.
Make your project history clear to every reader. Build your CV and link to a portfolio with useful text alternatives.