New May 22, 2026

A Slight Nuance With WordPress Alt Text

More Front-end Bloggers All from Geoff Graham View A Slight Nuance With WordPress Alt Text on geoffgraham.me

You know that you can drag and drop an image directly into the WordPress Block Editor. And you know it’s a really, really good idea to put alt text on it because screen readers and other assistive tech.

So, you type (or apparently you generate) the alt text in the image’s block settings:

An image added to the WordPress block editor of an unfinished brown wooden guitar standing upright at an angle. The block's settings are open in the editor's right panel.

Yay, an accessibility win! High fives. ✋

Sometime later, you decide to write another post that uses the same image. So, you open up the Media Library from the post editor and select the image:

Image selected in the WordPress Media Library opened in the post editor. Showing image information in the right column.

Where the heck did your carefully crafted alt text go? It only lives in the first post, so globally, it’s empty.

That does make sense. Plopping an image into a specific post should allow you to override the global image alt after all. And WordPress can’t really assume you always want alt text. It also can’t assume that whatever the first or latest instance of the image’s located alt should be retained and override the global setting.

My habit: Plop that image in the post editor, smash the “Replace” button on it, then type the text in the Media Library modal. Then it’s preserved anywhere the image is used.

Scroll to top