Image alt attributes are missing or do contain the focus keyphrase

The error

Images on this page are missing alt attributes.


Images on this page do not have alt attributes with words from your keyphrase


The code to embed the image onto the page does not contain an image alt tag or the alt tag does not have the focus keyphrase.


In short, you must add the alt attribute directly to the image on the post or page.

  1. Log in to your WordPress website.

    When you’re logged in, you will be in your ‘Dashboard’.

  2. Open the post or page to edit the content.

  3. Click on the pencil ‘Edit’ icon for the image.

    You will see a row of icons where the pencil icon allows you to edit the image details.
    WordPress Edit Image

  4. Add or edit the ‘Alternative Text’ field.

    A window will open called ‘Image Details’. Add or edit the ‘Alternative Text’ field so it contains the focus keyphrase.WordPress Edit Image Details in Visual Tab

  5. Click ‘Update’.

  6. Repeat this for all images on the page.

    Alternatively, you can switch to the ‘Text’ tab and manually add or change the alt tag:  alt=”ALT_TAG_GOES_HERE”WordPress Edit Image Details in Text Tab

Why Can’t I Change it In The Media Library?

The media library only changes the media information going forward and does not retroactively edit images added to your current content. That said, the ‘Add Media’ button does have a field for you to enter alt attributes when adding images to your content.

Was this article helpful? ·