Request a demo

Accessibility

Alt text for municipal websites: a publishing checklist

Help municipal staff write useful alt text, handle decorative photos and linked images, and check flyers and charts before publishing website updates.

On this page

Alt text for municipal websites should communicate what an image contributes to the page. Describe meaningful images, identify the purpose of image links and deliberately mark purely decorative images. Put lengthy notice details and chart information in readable page text, then check the result after publishing.

Alt text is a text alternative for an image. It lets people who cannot see the image receive its information or understand its function. WCAG 2.1 Success Criterion 1.1.1 (opens in a new tab) addresses equivalent text alternatives and explains how purely decorative content should be ignored by assistive technology. This guide covers routine image publishing, not a complete accessibility evaluation.

How do you choose alt text for municipal websites?

Start with the image's job on this page. A photograph, a linked logo and a notice saved as a picture can require different treatment. W3C's image decision tree (opens in a new tab) helps separate those cases.

Before uploading, decide:

  • Does the image add information residents need? Write a concise description that preserves that information.
  • Is it the only content of a link or button? Explain the destination or action.
  • Does it only decorate the page, or repeat information fully provided nearby? Use the appropriate decorative setting.
  • Does it contain detailed instructions, a chart or a map? Prepare the necessary text explanation as part of the page.

Give the person publishing the image its purpose and any verified names or details they need. A staff member receiving a file without context should not have to guess which entrance a photograph shows or what a diagram is meant to explain.

What makes a useful image description?

Describe the information that matters to the reader's task. Keep the wording specific enough to explain why the image is on the page. Check names and locations with the department supplying the content before including them.

W3C's image-writing tips (opens in a new tab) recommend putting important information first and keeping the description concise. They also explain that introductory words such as "image" or "picture" are usually unnecessary because screen readers announce the image.

Read the surrounding paragraph and the proposed description together. Remove repetition that adds nothing, but keep details the surrounding text does not supply. If the explanation needs several paragraphs, move that detail into the page and use a short alternative that identifies the image and points to the explanation.

When should an image be marked decorative?

Mark an image decorative when it adds no information needed to understand the page and has no independent function. Do not use that setting simply because the description is difficult to write.

For ordinary web images, W3C's decorative-image guidance (opens in a new tab) specifies an empty alternative, written in HTML as alt="". Omitting the attribute is different: some screen readers may announce the file name when it is missing.

Ask your provider which editor control produces a deliberately empty alternative, and what happens when the image-description field is left blank. If the editor inserts the file name or refuses to save without a description, ask the provider how decorative images should be handled.

An image used alone as a link needs text that explains where the link goes. Describing the picture's appearance can leave the destination unclear.

W3C's functional-image examples (opens in a new tab) show the distinction with its own logo. When the logo is the only link content, its alternative identifies the W3C home page. When the same link already contains visible text identifying that destination, the redundant logo can have an empty alternative.

Apply that check to linked department graphics and service tiles. Ask the provider to verify the link's accessible name, the label assistive technology receives. Nearby text outside the link does not automatically label it. Follow the link yourself too, so the wording and destination agree.

How should staff handle flyers, charts and maps?

Publish the information residents need as ordinary page content. W3C's guidance on images of text (opens in a new tab) explains why real text is more adaptable when people enlarge it or change its appearance.

For an event flyer or service notice, carry over the instructions and details into the page. Check dates, locations, contact information and any steps residents must take. Include usable links where an image shows a web address. If the retained graphic adds no information or function beyond that text, assess it as a redundant image using the decorative-image guidance.

A chart or map needs more than a label naming its subject. W3C's complex-image guidance (opens in a new tab) describes a short identification plus a longer equivalent of the essential information. Depending on the content, that longer explanation can include a data table, trends or location details. Have the department responsible for the information check that the text preserves what the graphic communicates.

Where does alt text go in the website editor?

Use the field that supplies the image's text alternative. A file name, media title or visible caption may serve a different purpose. Confirm the correct control for each image layout staff use.

Minneapolis documents this difference in its website image instructions (opens in a new tab). Some content types have an image-alt box; images inserted in a paragraph use a Description field reached through the image settings. Those are instructions for Minneapolis's system, but they show why training should cover the actual editing path.

Ask your provider to walk through a regular image, a decorative image and a linked image in a practice page. Save and reopen each one. Include this exercise in municipal website staff training so the employee covering website updates can repeat it.

What should you check on the published page?

Verify both the wording and how the website exposes it. Use this check after adding or replacing an image:

  1. Open the public page and confirm the intended image appears with its supporting text.
  2. Check that its description fits this placement, especially if the file came from a shared media library.
  3. Have the provider show staff how to inspect the published alternative with an accessibility tool. Confirm meaningful images have the intended description and decorative images are deliberately ignored.
  4. For image links, verify the accessible name and destination. Report missing or misleading labels with the page URL and the image's location.
  5. Confirm that longer explanations and notice details remain available as readable page content.

A filled-in field alone cannot establish that the description is accurate. Review meaning as well as the technical result. Add this check to the routine accessibility update process, and keep an owner for any editor problem staff cannot correct.

Frequently asked questions

How long should image alt text be?

Use the shortest description that communicates the image's purpose. W3C's image tips (opens in a new tab) recommend a short phrase or sentence and a longer description method when more detail is needed. Do not cut essential information merely to fit a preferred character count. Put detailed instructions or data in readable page content and connect the image to that explanation.

Can the same photograph use different alt text on different pages?

Yes. The text alternative depends on the image's purpose in each location. W3C's decision tree (opens in a new tab) asks whether an image adds meaning, repeats nearby text or functions as a link. Reassess a reused photograph in its new context. Ask the provider whether changing a shared media-library description also changes other pages that use the file.

Should staff put search keywords in alt text?

Include a place, department or service name when it helps explain the image accurately. Do not add unrelated search terms. W3C's guidance (opens in a new tab) bases the text alternative on the information or function the image represents. Read the description as a substitute for seeing that image; remove words that do not help the resident understand it.

Does a visible caption replace the alt text field?

It depends on what information the caption supplies and how the image is used. W3C's decorative-image guidance (opens in a new tab) allows an empty alternative when adjacent text already supplies the image's information. A short credit or vague caption may not do that. Review the whole image and any link function before choosing a decorative setting; do not assume every caption makes the image redundant.

Make image review part of everyday publishing.

See Muniway's accessibility approach for local government websites and content.

Explore website accessibility