Installation

From WordPress Admin

  1. Go to Plugins → Add New
  2. Search for "AltText AI"
  3. Click Install Now, then Activate

Manual Installation

  1. Download the plugin ZIP from altextapi.com/wordpress
  2. Go to Plugins → Add New → Upload Plugin
  3. Choose the ZIP file and click Install Now
  4. Click Activate

Configuration

  1. Go to Settings → AltText AI
  2. Paste your API key
  3. Configure options:

| Setting | Description | |---------|-------------| | Auto-generate on upload | Generate alt text automatically when images are added to the Media Library | | Overwrite existing alt text | Replace alt text that was previously set | | Credit warning threshold | Show a warning when credits drop below this number |

Features

Bulk Generation

Process your entire existing media library:

  1. Go to Media → Library
  2. Select images using the checkboxes
  3. Choose Generate Alt Text from the Bulk actions dropdown
  4. Click Apply

The plugin processes images in batches of 10 to avoid server timeouts. A progress indicator shows how many images have been processed.

WooCommerce Integration

If WooCommerce is active, the plugin automatically:

  • Includes product names in generated alt text
  • Processes product gallery images
  • Adds alt text to product variations

SEO Plugin Integration

The plugin integrates with popular SEO plugins:

  • Yoast SEO — Uses focus keyphrase in alt text
  • Rank Math — Uses focus keyword
  • All in One SEO — Uses keyphrase
  • SEOPress — Uses target keyword

WP-CLI Support

Available commands:

txt
# Generate alt text for a single attachment
wp alttext generate 123

# Bulk generate for all images without alt text
wp alttext generate-all

# Check API key status and credits
wp alttext status

# Regenerate alt text for a specific attachment
wp alttext regenerate 123

Troubleshooting

"Could not connect to API"

Check that:

  • Your server allows outbound HTTPS connections
  • Your API key is valid (verify with /v1/validate-key)
  • wp_remote_post is not blocked by a security plugin

"No credits remaining"

  • Free tier: 50 images/month. Upgrade to Pro for more.
  • Credits reset on the 1st of each month.
  • Check your usage at alttext.ai/dashboard.