Moments handbook

Captions, alt text, and the lightbox

Photos & privacy3 sections · Complete guide

Photographs

Captions, alt text, and the lightbox

The field note belongs to a moment; a caption belongs to one photograph. Keeping those layers separate lets the sequence remain spacious while still making room for names, observations, context, and a useful description for people who cannot see the image.

01

Caption one frame at a time

Each completed photograph in the moment editor has a caption and alt-text editor with a large preview. Move through the whole set without closing the editor, using its controls or the left and right arrow keys when you are not typing. A progress indicator shows which photographs already have captions.

Captions can be brief or expansive. They appear with the photograph in the lightbox, so they work best when they add something the image cannot say alone rather than repeating the moment's field note.

The Moments caption and alt text editor open over a photograph, with controls for moving through the set
Illustrated viewThe focused caption editor keeps the photograph large while you move through the complete set.
02

Caption and alt text have different jobs

By default, a caption also becomes that photo's alt text. This gives screen readers a useful description without asking you to write everything twice. If the visible caption assumes the image can be seen, add a separate plain description in the alt-text field.

Good alt text names the important visual information in context. A caption might say “the road finally opened”; the alt text could say “a narrow mountain road emerging from fog between dark pines.” Decorative detail can stay out if it does not help someone understand the moment.

Keep reading