
How to Write Alt Text for Creative Work Without Losing the Detail
Creative work often depends on details that are easy to take for granted when an image is in front of you: scale, material, contrast, gesture, setting or the relationship between objects. Alt text is a brief description of an image, and writing it gives you a chance to decide which of those details matter most. It does not need to translate a whole artwork into a paragraph or explain every possible interpretation. It needs to offer a clear, useful first picture of what is visibly there. With a little practice, this can become part of presenting work with the same care you bring to captions and project notes.
Describe What Is There Before Explaining What It Means
Start with the observable elements of the image. Name the main subject, the material or medium where it is relevant, and the setting if it changes how the work is understood. A useful description of a ceramic piece might mention its uneven glazed surface, a tall narrow form and the shadow it casts on a pale plinth. A useful description of a performance image might note one person in a red coat standing beneath a projected field of light in a dark room. These details give a reader something to hold on to before you add a more interpretive idea elsewhere on the page.
Let the image lead
Avoid beginning with an assessment such as ‘beautiful’, ‘powerful’ or ‘important’. Those words may be true to your response, but they do not help someone picture the work. Instead, identify the visual feature that produces that response: a dense field of hand-drawn lines, a large blank area around a small object, or a repeated grid of cut paper forms. You are not reducing the work by being concrete. You are giving the description a stable starting point that lets the viewer’s own response remain possible.
Choose the Details That Change Understanding

You rarely need to catalogue every object in a frame. Choose the details that distinguish this image from the next one and make the work easier to imagine. For a textile piece, texture, colour relationship and scale may be more useful than the wall behind it. For a documentary photograph of a workshop, the arrangement of hands, tools and materials may matter more than each person’s clothing. Ask yourself what a reader would miss if this detail were left out. If removing it changes the character, material or action of the image, it probably belongs in the description.
Mention material, setting and action when useful
A small amount of context can make an image much clearer. Include material when it shapes the surface or method: charcoal on rough paper, stitched cotton, mirrored acrylic or weathered wood. Include setting when it affects the work’s scale, atmosphere or purpose: installed low on a gallery wall, spread across a studio floor or carried through a public square. Include action when something is happening: two people assembling a structure, a hand drawing a line, or a group sitting around a table. Keep the phrasing direct so the key image remains easy to follow.
Let Captions and Alt Text Do Different Jobs

A caption can carry information that sits around the image: a title, year, project name, location, process note or a link to further work. Alt text is where you describe the image itself. Keeping those jobs separate means you do not have to repeat the same words twice or force all the context into one small field. When preparing a selection for a PageLink page, write a short note for each image before you publish it: one description of what can be seen and one piece of surrounding context if it is needed. This makes it easier to decide what belongs in a caption, a project page or a more detailed article.
Use short, clean language
Write as though you are helping a thoughtful visitor form a picture, not submitting an academic inventory. Complete sentences can work well, but clipped phrases are fine when they are clear. Read the description aloud once. If it is hard to say, it is probably carrying too many details. If it could describe almost any image in your portfolio, it needs one or two more specific observations. A concise description with the right visual anchors is more useful than a long one that loses its subject halfway through.
Build Descriptions Into Your Publishing Routine
The easiest time to write alt text is while you still remember why you chose the image. Add a brief description to your working notes when you export a photograph, prepare a project update or select images for a new page. For older work, begin with the images that appear most often or introduce a key project. You do not have to rewrite an entire archive in one session. A steady small review is more realistic: choose five images, describe what is most visibly important, then return to the next group when you update the page. This gives your public work more care without turning every upload into a major task.
Good alt text does not flatten creative work into a label. It notices the visual information that gives an image its character and offers it in plain language. Start with what is visible, choose the details that matter and keep captions for the context around the work. Over time, those small descriptions make a creative collection easier to enter, revisit and understand.


