There are several terms that are commonly used to describe image attributes:
- Captions are brief descriptions related to the image (for example commentary, attributions or quotations). Use captions to acknowledge the creator or copyright holder of images in captions. Add captions for all images, unless they are only decorative.
- Description field is an extended description (or ‘long description’) that explains a complex image.
- Alternative text (alt text) is a short description of the information an image conveys. It’s either available to the user as an HTML attribute or through a document’s accessibility tool. Alt text is not usually visible on the page.
Only captions and descriptions fields should reveal to the regular user and they should look consistent throughout the Image, Gallery, and Advanced Gallery blocks.
Image block:
Credits inside caption field.
Core Gallery block:
The caption of core Gallery block should resemble the ones from Advanced Gallery.
Advanced Gallery block:
The Description field is an extended description that explains a complex image. Like users are at the centre of the content lifecycle. The cycle starts with intent. The cycle shows continuous improvement through repetition. Stages can repeat before completing a full cycle.
Credits inside description field.
The caption is a text traditionally displayed underneath the image.
Credits inside caption field.
It is worth noting that WordPress image captions can contain HTML elements including links or bold text..
Advanced Gallery block and Color Signal to Medium:
The Description field is an extended description that explains a complex image. Like users are at the centre of the content lifecycle. The cycle starts with intent. The cycle shows continuous improvement through repetition. Stages can repeat before completing a full cycle.
Credits inside description field.
The caption is a text traditionally displayed underneath the image.
Credits inside caption field.
The captions below displayed only on image hover using the “show-captions-on-hover” class.
The Description field is an extended description that explains a complex image. Like users are at the centre of the content lifecycle. The cycle starts with intent. The cycle shows continuous improvement through repetition. Stages can repeat before completing a full cycle.
Credits inside description field.
The caption is a text traditionally displayed underneath the image.
Credits inside caption field.