Upload an image and add useful alt text

Article

Add an image to your Media Library and describe its purpose for people who cannot see it.

  1. Open Media in the WordPress dashboard. The Media Library appears.

    Media in the fresh WordPress dashboard, outlined and marked 1.
  2. Choose Add Media File. The upload area opens above the library.

    Add Media File in the Media Library, outlined and marked 2.
  3. Choose Select Files. Your computer’s file chooser appears.

    Select Files in the uploader, outlined and marked 3.
  4. Select your image. WordPress starts uploading the selected file.

  5. Wait for the upload to complete. The image’s thumbnail appears in the Media Library.

  6. Open the uploaded image. Its attachment details appear.

    The newly uploaded demo logo in the Media Library, outlined and marked 6.
  7. Enter suitable Alternative Text. This example uses “Faciotech blue logo for the demo website.”

    Alternative Text containing the demo logo description, outlined and marked 7.
  8. Close the details after WordPress shows Saved. The description is saved automatically after you leave the field.

    Close dialog after the Saved status appeared, outlined and marked 8.
  9. Reopen the image. Check its alt text before using it on a page.

    The persisted alt text after reloading the Media Library and reopening the image, outlined and marked 9.

Describe what the image contributes in its page context. Leave alt text empty when an image is purely decorative.

Video walkthrough

Sources

For help, contact Faciotech support.