Writing Alt Text for a Portfolio Website Without Turning It Into a Caption

A studio portfolio is mostly pictures. For a sighted visitor that is the point. For someone using a screen reader, it means the alt text is the portfolio, and on most creative websites it is either missing or a filename. We treat it as copy, and it gets written and checked like any other copy.
The first rule is to describe what the image shows, not what it is for. Hero image tells nobody anything. A 3D render of a red hard hat with a clear visor on a black background tells someone exactly what the work looks like. We aim for one sentence, usually under 125 characters, with the most important detail first.
The second rule is not to repeat the caption. If a case study already says Exhibition stand for a hospitality conference, the alt text should add what the eye sees: the shape of the stand, the lighting, the materials, the people in it. A screen reader user hears both, so repeating the caption wastes their time.
Third, mention the medium when it matters. On a 3D and motion portfolio, render, illustration, photograph and screenshot are meaningful differences. A render of a living room and a photograph of a living room are not the same piece of work, and the distinction is part of what we are showing.
Fourth, decorative images get empty alt text. Background textures, divider shapes and repeated logo marks should be skipped entirely with alt set to an empty string, not described. Describing decoration makes the real content harder to find.
Video and animation need more than alt text. A looping hero video needs a pause control, and a short text description of what happens in it nearby. Case study films need captions, which also help the large number of people watching with the sound off.
Interactive work is harder. For a 3D configurator or an interactive map, the canvas itself cannot describe every state, so we make sure the controls are real buttons with labels, and the current selection is announced in text. The product colour you just picked should be readable as words, not only visible in the model.
Finally, we build alt text into the CMS rather than leaving it to memory. The image field asks for it, and an empty value has to be a deliberate choice for decorative images. It adds seconds per upload.
Good alt text also helps search and makes a site more robust when images fail to load on a slow connection. But the main reason is simpler. If the work is worth showing, it is worth describing to everyone.