---
title: "Export Image Alt Text and Find Images Without It"
url: "https://wpimportexport.com/export-image-alt-text-find-missing/"
description: "Export WordPress image alt text to a spreadsheet, list images without alt text, write descriptions and import them back into the Media Library in one go."
type: post
published: 2026-11-09T09:03:28+00:00
modified: 2026-11-14T10:37:18+00:00
categories: ["Export Guides", "Tutorials"]
tags: ["Import Export by RockStarLab", "Media Library sync", "WordPress export"]
docs_topics: ["Export guides", "Media workflows"]
---

# Export Image Alt Text and Find Images Without It

Alt text describes an image for people who use screen readers and for search engines, and accessibility checks flag every image without it. In the WordPress Media Library you can only see it one image at a time. With [Import Export by RockStarLab](https://wordpress.org/plugins/import-export-by-rockstarlab/) you export the alt text of all images to a spreadsheet, list the images that have none, and import the alt text you write back into the Media Library in one go. On our test site, 82 of 111 images had no alt text.

**Free:** Media Library export and import with alt text, title, caption and description. **PRO:** transformations of values during export and import.

## Short Answer

1. Go to **Import Export → Export**, choose **Media** and add the filters **MIME Type** contains `image` and **Alt Text** **Is Empty**.
2. Export **ID**, **File Name**, **Alt Text**, **Title**, **Attached Post Title** and **File URL** to CSV or XLSX.
3. Write the alt text in the Alt Text column.
4. Import the file under **Import → Media** with **Check for Existing Items by Field: ID**, **If Match Found: Update** and **If No Match Found: Skip**.

## Step 1: Export the images without alt text

Open **Import Export → Export**, choose **Media** and click **Next Step**. Add two filters: **MIME Type** **Contains** `image`, so PDFs and videos are left out, and **Alt Text** **Is Empty**.

![Media export step 2 with filters MIME Type contains image and Alt Text Is Empty, Total Items Available 82](https://wpimportexport.com/wp-content/uploads/2026/11/01-missing-alt-filter.webp)

_82 images without alt text._

In step 3, add the columns. **File URL** lets you open each image from the spreadsheet, and **Attached Post Title** tells you which post it was uploaded for, which helps to describe it.

![Media export columns ID, File Name, Alt Text, Title, Attached Post Title and File URL](https://wpimportexport.com/wp-content/uploads/2026/11/02-alt-columns.webp)

_Columns for writing alt text: ID to match, File URL to look at the image._

In step 4, choose CSV or XLSX and click **Start Export**. To review all alt text instead, leave out the Alt Text filter; the exported column then shows the existing descriptions too.

## Step 2: Write the alt text

Open the file and fill in the Alt Text column. Our rows:

| ID | File Name | Alt Text |
| --- | --- | --- |
| 2020 | bakery-front-original-scaled.jpg | Bakery shop front with bread in the window |
| 2021 | summer-banner-scaled.png | Summer offers banner |
| 2022 | team-photo-1.jpg | Bakery team in the kitchen |
| 2023 | favicon-orange.png | _(left empty: decorative)_ |

Describe what the image shows and why it’s on the page, in a short sentence. Don’t start with “Image of”, and don’t stuff keywords. Purely decorative images, such as a background shape or an icon next to a text that says the same thing, should have an empty alt text, so leave those cells empty.

Keep the ID column unchanged: the import uses it to find each image. You can delete the other columns or rows you don’t change.

## Step 3: Import the alt text back

Go to **Import Export → Import**, choose **Media** and upload the file. The file doesn’t need the image files or their addresses; the import only changes the details of images that already exist.

1. In the field mapping, click **Auto Map**: ID goes to ID and alt_text to Alt Text.
2. In the import options, set **Check for Existing Items by Field** to **ID**, **If Match Found** to **Update** and **If No Match Found** to **Skip**, so a wrong ID can’t create a new item.
3. Click **Start Import**.

![Media import options: Check for Existing Items by Field ID, If Match Found Update, If No Match Found Skip](https://wpimportexport.com/wp-content/uploads/2026/11/03-update-by-id.webp)

_Update existing images by ID and never create new ones._

All four rows were updated; the three images now had alt text in the Media Library, and the decorative icon kept its empty alt text, because empty cells don’t change existing values.

![Import Completed Successfully: Successful 4, Updated 4, Created 0, Skipped 0, Failed 0](https://wpimportexport.com/wp-content/uploads/2026/11/04-import-result-3.webp)

_Four images updated, none created._

An import changes your Media Library, so [create a backup](https://wpimportexport.com/how-to-create-a-wordpress-website-backup-and-restore-it/) before you run it on a live site.

## Alt text in posts that already use the image

The Media Library alt text is used whenever you insert the image from now on, and by themes and plugins that read it, such as featured images and WooCommerce product images. An Image block that was inserted earlier keeps the alt text it had at that moment, because the block stores its own copy. To find such images in old posts, search the content for `alt=""`, for example with an export filter **Content** contains `alt=""`, and fix those posts in the editor; see [bulk find and replace in posts](https://wpimportexport.com/bulk-find-replace-wordpress-posts/) for changes across many posts.

## With an AI agent

An AI agent with vision, connected through the WordPress MCP Adapter (see [connecting Claude Code to WordPress](https://wpimportexport.com/connect-claude-code-to-wordpress-mcp/)), can look at the images and write the descriptions for you to review:

```
List images without alt text, look at the first two, propose an alt text for
each, and after I approve, save them to the Media Library.
```

In our run, the agent exported the list with `rsl-ie/export-start` (filter `alt_text is_empty`), opened two gallery photos and proposed “Rocky headland with green trees above a blue sea and white surf” and “Forested coast at sunset with a headland and calm sea”. After approval it uploaded a two-row CSV with `rsl-ie/upload-create`, `upload-chunk` and `upload-complete`, and ran `rsl-ie/import-start` with `import_type: media`, the mapping ID and alt_text, and `duplicate_mode: update`, `duplicate_check: ID`, `if_not_exists: skip`. The job updated 2 images and failed none. Review descriptions written by an AI before saving them: it can’t know the context of your page.

## FAQ

### How do I find images without alt text in WordPress?

Export the Media Library with the filter Alt Text Is Empty, together with MIME Type contains image. The file lists every image that has no alt text.

### Can I add alt text to many images at once?

Yes. Fill in the Alt Text column of the export and import the file under Import → Media, matching by ID and set to Update.

### Does the import need the image files?

No. When the import updates existing items, the ID and the columns you change are enough.

### Will new alt text appear in posts that already use the image?

Featured images and places that read the Media Library show it. Image blocks inserted earlier keep their own copy and need to be edited in the post.

### Should every image have alt text?

Every meaningful image should. Decorative images should have an empty alt text so screen readers skip them.

## Related Guides

- [Export the Media Library with File Sizes to Find Large Images](https://wpimportexport.com/find-large-images-wordpress-media-library-file-sizes/)
- [Export the WordPress Media Library to CSV or Excel](https://wpimportexport.com/export-wordpress-media-library-to-csv-excel/)
- [Import WordPress Media Library Files](https://wpimportexport.com/import-wordpress-media-library-files/)
- [Bulk Find and Replace in WordPress Posts](https://wpimportexport.com/bulk-find-replace-wordpress-posts/)

Get the free plugin on [WordPress.org](https://wordpress.org/plugins/import-export-by-rockstarlab/).
