{"id":16,"date":"2026-09-29T12:40:57","date_gmt":"2026-09-29T11:40:57","guid":{"rendered":"https:\/\/dexwp.com\/blog\/how-to-add-alt-text-to-images-in-wordpress\/"},"modified":"2026-09-29T12:42:44","modified_gmt":"2026-09-29T11:42:44","slug":"how-to-add-alt-text-to-images-in-wordpress","status":"publish","type":"post","link":"https:\/\/dexwp.com\/blog\/how-to-add-alt-text-to-images-in-wordpress\/","title":{"rendered":"How to Add Alt Text to Images in WordPress"},"content":{"rendered":"

To add alt text to images in WordPress, select an image in the block editor and enter a description in the Alternative text<\/strong> field in its block settings. Save or update the post, then check the published page. If you plan to reuse the image, you can also set its alt text in the Media Library. An existing post may still need its own edit because the two fields serve different purposes.<\/p>\n

Decide what the image needs to communicate<\/h2>\n

Alt text gives someone who cannot see an image the information it contributes to the page. For an informative image, describe its purpose in the surrounding content, not every visible detail. The W3C guidance on images<\/a> explains how the right approach depends on the image’s role.<\/p>\n

On a bakery menu, a product photo might need \u201cSourdough loaf with a dark crust and flour-dusted top.\u201d In instructions about checkout settings, a screenshot might need \u201cShipping options panel with local pickup enabled.\u201d These are examples, not descriptions to copy without checking the actual images. Avoid strings of search terms and introductory words such as \u201cimage of\u201d when they add nothing.<\/p>\n

Leave the field empty when the image adds no information, such as a decorative flourish beside an already clear heading. Empty means no text in the field, not the words \u201cdecorative image.\u201d If an image is the only content of a link, its accessible name needs to convey the link’s destination or action. Use the W3C alt text decision tree<\/a> when the image’s role is unclear.<\/p>\n

Add alt text in the WordPress Image block<\/h2>\n

Use the block editor when the description should fit a particular post or page. You need permission to edit that content, and the image must be in a core Image block. WordPress’s Image block documentation<\/a> identifies the Alternative text field in the block settings.<\/p>\n

    \n
  1. Open the post or page in the WordPress editor.<\/li>\n
  2. Select the image. If the settings sidebar is hidden, open it and view the settings for the selected block.<\/li>\n
  3. Find Alternative text<\/strong>. Enter a description that fits this use of the image, or leave the field empty if the image is purely decorative here.<\/li>\n
  4. Save or update the post or page, then open its preview or published version.<\/li>\n<\/ol>\n

    The description entered in an Image block applies to that image instance. This is useful when the same photo has different jobs on different pages. A storefront photo on an accessibility page might need \u201cEntrance with a step-free doorway,\u201d while a post about seasonal decorations might describe the window display instead.<\/p>\n

    When you insert an image from the Media Library, its existing attachment alt text may provide a starting value in the new block. Check that value before publishing. Changing one block’s field does not revise every other use of the file.<\/p>\n

    Add alt text in the Media Library<\/h2>\n

    Use the Media Library to maintain the image attachment’s alt text for future insertions. In WordPress, open Media \u2192 Library<\/strong>, select the image, and find its Alternative Text<\/strong> field in the attachment details. Enter a concise description and save the change if that screen asks you to. WordPress covers attachment editing in its Edit Media guide<\/a>.<\/p>\n

    Attachment alt text and text saved in an existing Image block are not interchangeable. An Image block can store its own value, so editing the Media Library field does not<\/strong> reliably update images already placed in posts or pages. Review those uses individually when correcting older descriptions. A gallery, theme, or plugin may also use attachment data differently.<\/p>\n

    For example, \u201cCeramic mug with blue glaze\u201d might be a useful attachment description for later insertions. If an existing post uses that photo to show where the maker’s stamp appears, edit that post’s Image block with a description relevant to the stamp. The Media Library cannot supply every page’s context.<\/p>\n

    Check the rendered result<\/h2>\n

    After saving, open the page preview or published page. Confirm that the intended image appears and that its description makes sense beside the heading, caption, and body text. If nearby text already conveys everything the image adds, consider whether the image is decorative in that context.<\/p>\n

    For a direct check, right-click the image on the rendered page and inspect its HTML with your browser’s developer tools. Find the image’s alt<\/code> attribute. An informative image should contain the intended text, such as alt=\"Entrance with a step-free doorway\"<\/code>. A decorative image should generally have alt=\"\"<\/code>, which is different from an image missing the attribute altogether.<\/p>\n

    Check linked images separately. For example, a linked logo should tell a reader where the link goes rather than merely describe its colors; the W3C’s guidance for functional images<\/a> explains this use. If a page builder, product gallery, or other plugin renders the image, its controls may differ from the core Image block. Find the relevant field in that tool and inspect the published output instead of assuming a Media Library edit carried through.<\/p>\n

    Review older images systematically<\/h2>\n

    Start with important pages and recent posts. Open each page, identify images that convey information, and compare their Image block fields with the rendered page. An empty Media Library field alone does not prove every use of an image lacks useful alt text. Likewise, a filled attachment field does not prove an existing block or plugin displays it.<\/p>\n

    Keep a short review list with the page URL, image, proposed description, and whether the image is decorative. Ask someone familiar with the product, place, or process pictured to confirm details you cannot establish from the image. For screenshots, describe the screen that is actually shown; if the screenshot is replaced, review its alt text again.<\/p>\n

    Use DexWP to prepare a review<\/h2>\n

    Dex can read and edit supported posts and pages on a connected WordPress site. You can ask it to help identify images that may need attention and propose descriptions, then review those suggestions against each image and its page context before editing.<\/p>\n

    Suggested Dex request:<\/strong> \u201cReview my recent WordPress posts and pages for images that may be missing useful alt text. List each page and image you can assess, suggest context-specific descriptions, and flag images that may be decorative. Show me the proposed changes before editing.\u201d<\/p>\n

    Check what Dex can access on your connected site. Images rendered by a builder, gallery, or plugin may still need manual review. For a broader maintenance workflow, see how to turn WordPress tasks into a conversation with Dex<\/a>. You can connect your WordPress site with DexWP<\/a> if you want to try this approach.<\/p>\n

    Common questions<\/h2>\n

    Will changing Media Library alt text fix images in old posts?<\/h3>\n

    Do not assume it will. Existing Image blocks can have alt text saved for that particular use, and other image tools may handle attachment data differently. Edit the relevant post or page, then inspect the published image’s alt<\/code> attribute to confirm the change.<\/p>\n

    Should every WordPress image have written alt text?<\/h3>\n

    No. Give informative images text that conveys their purpose in context. Leave purely decorative images with an empty alt attribute. If you are unsure, read the surrounding page without the image and ask what information a reader would miss.<\/p>\n","protected":false},"excerpt":{"rendered":"

    Learn how to add alt text to images in WordPress using Image blocks or the Media Library, then check published results and decorative images.<\/p>\n","protected":false},"author":2,"featured_media":15,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[4],"tags":[6,7,5],"class_list":["post-16","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-site-care","tag-image-alt-text","tag-site-care","tag-wordpress-accessibility"],"_links":{"self":[{"href":"https:\/\/dexwp.com\/blog\/wp-json\/wp\/v2\/posts\/16","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/dexwp.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/dexwp.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/dexwp.com\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/dexwp.com\/blog\/wp-json\/wp\/v2\/comments?post=16"}],"version-history":[{"count":1,"href":"https:\/\/dexwp.com\/blog\/wp-json\/wp\/v2\/posts\/16\/revisions"}],"predecessor-version":[{"id":17,"href":"https:\/\/dexwp.com\/blog\/wp-json\/wp\/v2\/posts\/16\/revisions\/17"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/dexwp.com\/blog\/wp-json\/wp\/v2\/media\/15"}],"wp:attachment":[{"href":"https:\/\/dexwp.com\/blog\/wp-json\/wp\/v2\/media?parent=16"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/dexwp.com\/blog\/wp-json\/wp\/v2\/categories?post=16"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/dexwp.com\/blog\/wp-json\/wp\/v2\/tags?post=16"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}