Decorative Images

Updated

What it helps you do

Some images never mean anything: a solid background, a divider line, a texture, a shape behind a heading. Screen readers should skip them, which means they need empty alt text. Ticking Decorative image on the file in the media library does that everywhere the image is used, and keeps Dirigible AI from writing a description for it.

Mark an image as decorative

  1. Open the image in the media library (or in the media window while editing a page).
  2. Under Alt Text, tick Decorative image. It saves straight away in the media window; on the full Edit Media screen, click Update.

The alt text field goes grey and says Not used while Decorative is ticked. Its text is kept: untick the box and that text is used again everywhere.

What changes on your pages

  • Every place the image is used is silent for screen readers: hero and Background block backgrounds, Image blocks, Photo & Text, CTA, Logos, cards, featured images, and its social sharing description. That includes copies placed before you ticked the box, which saved their own alt text at the time.
  • Nothing in your pages is rewritten. The change is made as each page is shown, so live pages pick it up within about 12 hours, or straight away when you update the page.
  • Dirigible AI lists the image as Decorative, not as missing alt text, and Generate All, automatic alt text on upload and its background fill all skip it.
  • The editor's Accessibility panel stops asking for alt text on it.

Things to know

  • Decorative belongs to the file, so use it for files that never carry meaning. If the same photo is content on one page and decoration on another, leave the box unticked and turn on Decorative image in that one Image block's sidebar instead.
  • A decorative image that is the only thing inside a link still needs a name for the link. The theme names links to your own pages and to the image file; a link to another site needs alt text or link text. The Accessibility panel flags it.
  • Images pasted in as HTML with their alt text typed in, and not added from the media library, aren't reached.

Related settings and guides

Built by Dirigible Studio. Get in touch