Writing Captions and Alternative Text for a Service Website Project Gallery

Why Gallery Text Deserves Its Own Draft

A project gallery is often treated as decoration: images are uploaded, a short label is typed in a hurry, and the page is published. That habit leaves value on the table. Captions and alternative text are the two pieces of writing that decide whether a visitor understands what they are looking at and whether someone using a screen reader gets an equivalent experience.

Think of the two as different jobs. The caption is visible editorial content. It tells every visitor what the project was, who it was for in general terms, and what the image actually shows. Alternative text is a short description attached to the image for assistive technology and for situations where the image does not load. It is not a place for sales copy, and it is not a second caption.

For a service business, the gallery is often the closest thing to proof of work. If the images are strong but the words are vague, the page asks the visitor to guess. A small amount of structured writing fixes that without redesigning anything.

One caution before you start: only describe what the image genuinely shows and what your records confirm. If a photo was taken at a client site but you cannot verify the project scope, write about the visible detail rather than inventing outcomes.

This guide is written for business owners and project leads in Malaysia who manage their own site content or brief a team. It offers a method, a hypothetical example and a checklist. It does not report research findings or measured results.

Start With an Image Inventory, Not With Words

Writing goes faster when you know what you are describing. Before drafting a single caption, list every image in the gallery in a spreadsheet or document with these columns: file name, what is visible, project reference, client permission status, caption draft, alternative text draft, reviewer, date checked.

The inventory does two things. First, it forces you to look at each image properly. Second, it creates a record you can revisit when a project is updated or a client asks for a change.

Group the images by type, because each type needs different wording. Typical groups for a service gallery include:

Finished work or installations, where the image shows an end state.

People at work, where the image shows a team, a process or a site visit.

Equipment, materials or components, where the image shows a specific item.

Documents, screens or diagrams, where the image shows information rather than a place.

Place and context shots, where the image establishes a location or setting.

For each group, decide the one question the caption must answer. For finished work, describe what was delivered and give location context if it is relevant and approved. For a photo of people at work, describe the activity it shows. For a document or screen, explain which detail the viewer needs to see.

Keep the inventory short. A single row per image is enough. The goal is a working list, not a database project.

A Caption Formula You Can Repeat

Captions work best when they follow a predictable shape, because visitors scan galleries quickly and repeatable structure helps them compare images. A workable formula is: subject, action or scope, context.

Subject: what the image is of, in plain words. Avoid internal project codes that mean nothing to an outside reader.

Action or scope: what was done, described at the level your records support. If you installed, supplied, designed or maintained something, say so. If the image only shows a finished space and you cannot confirm the full scope, describe the visible result instead.

Context: the setting, sector or general location, using only details you are permitted to publish.

Here is a hypothetical example, invented for illustration and not a real project. Suppose a facilities services company has a photo of a newly fitted lighting array in a warehouse aisle. A weak caption reads: Project completed. A stronger caption reads: Replacement lighting array fitted along a warehouse aisle, shown after installation. The second version tells the reader what the object is, what happened and where it is, without claiming savings, timelines or client names.

Keep captions to one or two sentences. Put the most useful noun early. Avoid starting every caption with the same word, because a gallery of identical openings reads as filler.

If a client has not approved being named, describe the sector instead: a distribution warehouse, a retail unit, an office floor. Never attach a client name to an image unless your records show permission.

Alternative Text: Short, Literal, and Separate From the Caption

Alternative text has one job: to convey the information in the image to someone who cannot see it. That means it should describe, not persuade.

A practical length is roughly five to fifteen words for a simple image and up to about twenty-five for a complex one. These are working guidelines, not standards, and the right length depends on what the image contributes to the page.

Rules that hold up in practice:

Describe what is visible. Name the main object, the setting and any action that matters.

Do not repeat the caption word for word. If the caption already explains the project, the alternative text can focus on the visual content.

Skip phrases like image of or picture showing unless the medium itself matters.

Do not stuff keywords. Alternative text is read aloud, and a string of service terms sounds broken to a listener.

For text-heavy images such as screenshots or diagrams, summarise the point in the alternative text and place the full detail in nearby body text, not inside the image.

For purely decorative images, use an empty alternative attribute so assistive technology skips them. If the image serves a purely decorative purpose, use empty alternative text. If it conveys a detail that the surrounding text leaves out, describe that detail.

Returning to the hypothetical lighting example: the caption explains the installation, while the alternative text might read: Row of ceiling-mounted light fittings above a warehouse aisle. The two pieces complement each other instead of duplicating.

If an image shows a person, describe the activity rather than guessing at identity, role or emotion.

A Checklist for Reviewing Gallery Text

Use this checklist before publishing a gallery page or after adding new images. It is a practical review tool, not a scored audit, and the pass marks below are suggestions rather than validated measures.

Every image has a caption that names the subject and the scope or visible result.

Every image has alternative text that describes what is visible, without repeating the caption.

No caption claims a result, saving, timeline or certification that your records do not support.

No client name, logo or identifiable site appears without documented permission.

No internal project codes, staff initials or file names appear in visible text.

Decorative images are marked as decorative rather than given filler descriptions.

Text inside images is either summarised in the alternative text or repeated in body copy.

Captions are consistent in length and tone across the gallery.

A second person has read the page and confirmed the descriptions match the images.

A simple routine helps: draft captions and alternative text in the inventory, review them in one sitting away from the design tool, then paste them in. Reading the alternative text aloud is a quick way to catch awkward phrasing, because that is how a screen reader user will hear it.

As a rough author heuristic, allow about two to three minutes per image for a first draft and a similar amount for review. Treat that as a planning estimate only.

Where This Fits in a Wider Web Project

Gallery text is one small part of a larger content system, and it is easier to maintain when it follows the same rules as the rest of the site. If your organisation is planning or refreshing a site, ask whoever handles web design services to build caption and alternative text fields into the content template, so the writing is captured at upload rather than patched later. That single request prevents the common situation where images are published with file names as captions.

Keep the inventory with your other content records. When a project is completed, add the images and drafts in the same session, while the details are fresh. When a project is retired, remove or archive the images and note the change.

For Malaysian businesses, two practical points come up often. First, client confidentiality expectations vary by sector, so confirm naming and location permissions in writing before publishing. Second, if your site serves audiences in more than one language, decide early whether captions and alternative text will be translated, and keep the translated versions in the same inventory row so they do not drift apart.

Finally, treat the gallery as a living page. A short review each quarter, using the checklist above, keeps descriptions accurate as work changes. The writing effort is modest, and the result is a gallery that explains itself to every visitor.

This guide is published by Blackstone Intelligence, the public identity of Blackstone Consultancy Sdn Bhd, a company whose legal business name is recorded in its terms of service. The method above is general editorial advice and does not describe specific services, outcomes or certifications.