Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared Managed Cloud India
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Best lists Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

AI & WordPress · Guide

How to Write Alt Text With AI in WordPress

Short answer

To write alt text with AI in WordPress, install an AI alt text plugin, connect its account or API key, and turn on generation on upload. Then run a bulk pass over your Media Library and edit every AI draft before you publish, because AI text can describe an image wrong.

Key takeaways

  • AI drafts alt text fast, but a person must check each draft for accuracy before it goes live.
  • Alt text set in the Media Library is the default for future inserts, not a fix for old posts.
  • Keep most alt text under 150 characters and describe what the image means in context.
  • Decorative images need empty alt text, alt="", so screen readers skip them.
  • The WebAIM Million 2026 report found missing alt text on 53.1% of top home pages.
  • Google calls alt text the most important attribute for image metadata.

What is AI alt text in WordPress?

AI alt text is a short description of an image that an AI tool drafts for you, which you then check and save in WordPress.

An AI alt text plugin looks at the pixels of an image and writes a sentence about what it shows. It saves that sentence as the image alt text in your Media Library. You stay in charge of the final words.

Alt text itself is the text a screen reader reads aloud in place of an image. It also shows when an image fails to load. Make WordPress Documentation calls alt text a concise description that can replace the image when it is not visible.

The need is large. The WebAIM Million 2026 report found missing alt text on 53.1% of the top 1,000,000 home pages, down from 55.5% in 2025. The same report found detectable accessibility failures on 95.9% of those home pages, with an average of 56.1 errors per page.

What do you need before you start?

You need a WordPress admin login, a short list of your images, and an AI alt text plugin with an account or API key.

First, confirm you can install plugins. Go to Plugins in your WordPress admin and check that you see Add New Plugin. If you do not, ask the person who manages your site for admin access.

Second, look at your Media Library and note how many images lack alt text. Open Media, then Library, and scan the list view. A small site may have 50 images, while a large blog may have thousands.

Third, compress large images before you generate alt text. Large files slow a page, and alt text does not fix that. Our guide to speeding up WordPress walks through the steps that matter most.

Fourth, pick one plugin and stick with it for the first pass. Mixing two AI tools on one library makes it hard to tell which draft came from where. The image plugins page lists the image tools on this site.

You can also use an image optimizer such as Imagify to shrink files before you start. Smaller files load faster, and the alt text step stays the same.

How do you pick an AI alt text plugin?

Pick the plugin whose free allowance covers your library size and whose billing model fits how often you upload.

Start with the free allowance: Alt Text Pro gives 150 credits on sign-up, and those credits never expire, plus 15 free credits every month, according to its WordPress.org plugin page. One image uses one credit. Paid plans start at $5 a month for 500 credits, as of November 2026.

Alt Text Generator AI gives new accounts 2 free credits, according to its WordPress.org plugin page. It supports 131+ languages, and it was updated on 2026-10-03, as of November 2026.

AltPost gives 60 images free in the first month, then 15 per month, with no API key to set up, according to its WordPress.org plugin page. That suits a small site with few new uploads.

Some plugins use your own AI provider key instead. AI Auto Alt Text Generator lets you bring a key from OpenAI, Anthropic, or DeepSeek, and you pay that provider directly, according to its WordPress.org plugin page. That suits a site that already pays for an AI account.

PluginFree allowance as of November 2026Bulk generationLanguages
Alt Text Pro150 credits on sign-up, plus 15 per monthUp to 20,000 images per run40
Alt Text Generator AI2 free credits for new accountsBulk Alt Text page131+
AltPost60 images in the first month, then 15 per monthBuilt-in bulk generationSite language
AI Auto Alt Text GeneratorPay your AI provider directlyBulk update toolProvider models

Check the plugin page for the current price before you pay. Free allowances change, and the numbers above were checked in November 2026.

How do you install and set up the plugin?

Install the plugin from Plugins, then Add New Plugin, activate it, and add its API key or account link on its settings page.

Follow these steps for Alt Text Generator AI. Other plugins use the same flow with different menu names.

  1. Go to Plugins, then Add New Plugin, in your WordPress admin.
  2. Search for Alt Text Generator AI, then click Install Now and Activate.
  3. Open the plugin settings page from the admin menu and create a free account on the plugin dashboard.
  4. Copy the API key from that dashboard and paste it into the plugin settings page.
  5. Leave automatic generation on upload switched on, since it is on by default.
  6. Save the settings and upload one test image to confirm the key works.

Setup takes about 15 minutes for a first plugin, including account creation. If the test image gets no alt text, check the key first, then check that the plugin is active.

Some plugins ask you to connect an account instead of pasting a key. Alt Text Pro, for example, asks you to sign up and connect, and it needs no credit card for its free credits, according to its WordPress.org plugin page.

How do you generate alt text for one image?

Open the image in the Media Library and click Generate Alt Text, then read the draft and edit it before you save.

  1. Go to Media, then Library, and click the image you want to fix.
  2. Find the Alternative Text field in the attachment details panel.
  3. Click Generate Alt Text next to that field.
  4. Read the draft the AI returns and compare it with the image.
  5. Edit the draft so it says what the image means on your page, not just what it shows.
  6. Close the panel to save, then check the image in its post.

Alt Text Generator AI adds a Generate Alt Text button in the Media Library, according to its WordPress.org plugin page. Other plugins use a similar button in the same panel.

You can also generate alt text in the block editor. Select an Image block, open Block settings, and find the Alternative text field. Type or paste the checked text there, then update the post.

How do you generate alt text in bulk for your whole library?

Open the plugin bulk page, run it on images with missing alt text first, and keep the tab open until the run ends.

  1. Open the plugin bulk page from the admin menu, such as Bulk Alt Text.
  2. Choose the Empty tab so the run covers images with no alt text first.
  3. Click the button to generate alt text for the listed images.
  4. Leave the tab open while the run works through the list.
  5. Spot-check 10 drafts from the run before you start the next batch.
  6. Repeat for the Short tab, which lists alt text under 20 characters.

The Bulk Alt Text page in Alt Text Generator AI sorts images into Empty, Short (under 20 characters), and All tabs, according to its WordPress.org plugin page. Alt Text Pro can process up to 20,000 images in one bulk run, according to its WordPress.org plugin page.

Bulk runs use credits fast. A library of 500 images needs 500 credits at one credit per image, so check your balance before a large run. Split a large library into batches of 100 if your plan limits each run.

How do you edit AI alt text so it is accurate?

Read each AI draft against the image and the page around it, then rewrite anything vague, wrong, or stuffed with keywords.

AI tools describe what they see, not why the image is on your page. A photo of a person at a desk may be a support agent, a founder, or a stock model. Only the page context tells you which one matters.

Use the W3C alt decision tree to sort each image first. Informative images get a short description of the meaning they carry.

Functional images, such as a logo that links home, get the destination or action. Decorative images get empty alt text.

Keep most alt text under 150 characters. web.dev advises a cap of 150 characters or less to avoid reader fatigue. Make WordPress Documentation gives a similar limit of 155 characters or less.

Do not start with “image of” or “photo of”. A screen reader already tells the user it is an image, so those words add nothing.

Do not fill alt text with keywords. Google warns that keyword stuffing may cause a site to be seen as spam, according to Google Search Central.

Add the page context in your own words. A chart alt text should state the point the chart makes, such as sales rose in March, and the full numbers should sit in text or a table near the chart.

How does AI alt text help SEO?

Good alt text helps search engines understand an image, and it can help the image appear in image search results.

Google calls alt text the most important attribute for image metadata, according to Google Search Central. Google uses alt text with computer vision and the page contents to understand what an image shows.

Alt text also works as anchor text when an image is a link. That is why a linked logo should say where the link goes, such as the home page, rather than describing the logo art.

Alt text is not a shortcut to rank a page. It helps Google index the image and helps people who cannot see it. The SEO plugins page lists tools that check on-page SEO, including image checks in some cases.

Some SEO plugins flag missing alt text in their content checks. Yoast SEO includes image alt text in its readability and SEO checks for posts, so a bulk alt pass often clears those warnings.

How do you check that the alt text worked?

Open the live post, view the image in the page source, and confirm the alt attribute holds the text you approved.

  1. Open the live post in your browser and right-click the image.
  2. Choose Inspect to open the browser developer tools.
  3. Find the img tag and read the alt attribute inside it.
  4. Confirm the text matches the draft you approved, word for word.
  5. Check the same image in the Media Library to confirm the default is saved.

Remember that the Media Library and the post can hold different alt text. The Media Library value is the default for future inserts, and it does not change images already placed in older posts. Edit those images in the post itself.

Run a free accessibility check on a page with WAVE, the WebAIM tool, to find images still missing alt text. WAVE flags missing alt attributes, but it cannot judge whether the text is accurate. Only a person reading the draft can do that.

Check featured images too. WordPress Developer Resources notes that the alt attribute for featured images is defined in the media library. Set it there, then view the live post to confirm it appears.

What mistakes should you avoid?

Avoid publishing AI drafts without reading them, using the same alt text for every image, and marking informative images as decorative.

  • Publishing drafts unchecked. AI text can name the wrong object, miss the point of a chart, or describe a person who is not in the photo. Read every draft.
  • Copying one alt text across many images. Each image needs its own description, even when two photos look alike.
  • Marking informative images as decorative. The Mark as decorative option in the block editor sets empty alt text, which hides the image from screen readers. Use it only for images that add no information.
  • Writing alt text in the caption field. A caption is visible text under an image, and it does not replace alt text. Make WordPress Documentation warns not to replace alt text with a caption.
  • Leaving alt text blank on linked images. A linked image with no alt text gives a screen reader user a link with no name. Describe the destination instead.
  • Trusting a green check from a scanner. A scanner can tell that an alt attribute exists, but it cannot tell whether the words are right.

Fix the worst pages first. Start with your home page, your top 10 posts, and your product pages, then work through the rest of the library in bulk batches.

Frequently asked questions

Can AI write alt text for every image on a WordPress site?

AI can draft alt text for most photos and simple graphics, but it cannot judge why an image sits on a page. Charts, screenshots, logos, and images of text need a person to add the context or the exact words. Decorative images need empty alt text, not a description. Treat AI output as a first draft for every image.

Does AI alt text cost money?

It can be free for a small library and paid for a large one. Some plugins give free credits each month, such as 15 credits, while others charge per image or per month. Bring-your-own-key plugins charge through your AI provider instead. Check the free allowance on the plugin page and count your images before you start a bulk run.

Will AI alt text fix images in posts I already published?

It depends where the plugin writes the text. Most plugins write to the Media Library, which sets the default for future inserts. Images already placed in published posts often keep the alt text they had when they were inserted. Check those posts one by one, or use a plugin bulk tool that updates images inside posts as well.

How long should AI alt text be?

Aim for one short sentence under 150 characters for most images. Short alt text is easier for screen reader users to hear and easier for search engines to use. A complex chart may need a short alt text plus a longer description in the text near it. Keep the alt itself brief and put the detail where all readers can see it.

Should I mark AI-generated alt text as decorative?

No, unless the image truly adds no information. Decorative means removing the image would lose nothing, or the nearby text already says the same thing. A photo that shows a product, a person, or a result is informative and needs a description. Marking it decorative hides it from screen reader users who need that information.

Do I need to check AI alt text if the plugin says it is accessible?

Yes. A plugin can confirm that an alt attribute exists, but it cannot confirm that the words are correct. AI tools can misread a chart, name the wrong object, or invent detail that is not in the image. Read each draft against the image and the page, fix errors, and only then publish the result.

Sources

  1. Media Make WordPress Documentation
  2. Accessibility WordPress Developer Resources
  3. Image SEO Best Practices Google Search Central
  4. The WebAIM Million 2026 WebAIM
  5. Alt Text Generator AI WordPress.org
  6. Alt Text Pro WordPress.org
  7. Understanding Success Criterion 1.1.1 Non-text Content W3C

Is your product missing, or something out of date?

Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.

About the editors

WPLegible editors

Researched from the primary sources listed above and checked against our editorial rules. About the site · How we test