wordpress-star-5

Documentation

Introduction

Image Alt Text Pro is a powerful WordPress plugin designed to help you add, update, and optimize alt text for all your images. It improves your website’s SEO and accessibility through advanced features including AI-powered generation, bulk editing, SEO validation, and real-time missing alt text highlighting.

Why Alt Text Matters

  • SEO Benefits: Search engines use alt text to understand image content, improving your rankings
  • Accessibility: Screen readers rely on alt text to describe images to visually impaired users
  • User Experience: Alt text displays when images fail to load
  • WCAG Compliance: Meets Web Content Accessibility Guidelines requirements

Key Benefits

  • Save hours of manual work with AI-powered generation
  • Improve search engine rankings with SEO-optimized alt text
  • Ensure accessibility compliance across your entire website
  • Manage thousands of images efficiently with bulk actions
  • Get instant feedback with 100-point SEO scoring system

Installation

Requirements

  • WordPress 5.0 or higher
  • PHP 7.4 or higher
  • MySQL 5.6 or higher
  • Administrator access to your WordPress site

Installation Steps

1. Download the Plugin

Purchase and download Image Alt Text Pro from https://imagealttext.in/my-account/downloads/

  • You will receive a ZIP file named image-alt-text-pro.zip

2. Upload to WordPress

  • Log in to your WordPress admin dashboard
  • Navigate to Plugins → Add New
  • Click Upload Plugin button
  • Choose the downloaded ZIP file
  • Click Install Now

3. Activate the Plugin

  • After installation completes, click Activate Plugin
  • The plugin will appear in your WordPress admin menu

4. Activate Your License

  • Navigate to Image Alt Text Pro → License
  • Enter your license key (login to your dashboard at https://imagealttext.in/my-account, go to My Subscription, and find your license key)
  • Click Activate License
  • Your license status will show as “Active”

Getting Started

First Steps After Installation

1. Access the Plugin

  • Look for Image Alt Text Pro in your WordPress admin menu
  • You’ll see multiple sub-menus:
  • With Alt Text
  • Without Alt Text
  • Settings
  • License

2. Check Images Without Alt Text

  • Click Image Alt Text Pro → Without Alt Text
  • This shows all images missing alt text on your site
  • Use this as your starting point for optimization

3. Configure Basic Settings

  • Navigate to Image Alt Text Pro → Settings
  • Review default settings
  • Set up AI generation (Local AI or OpenAI)
  • Configure auto-add preferences

4. Test with a Few Images

  • Select 2-3 images from the “Without Alt Text” page
  • Try different bulk actions to see which works best
  • Review the generated alt text
  • Edit if needed for better results

Features Overview

Core Features

1. Image Management Dashboard

  • View all images with or without alt text
  • Advanced search and filtering capabilities
  • Data table with Title, Filename, Alt Text, SEO Score, Date columns
  • Thumbnail preview with full-size image viewing
  • Real-time image statistics

2. AI-Powered Generation

  • Local AI – Free, unlimited, no API key required
  • OpenAI Integration – GPT-4o powered with customizable prompts
  • Intelligent context analysis
  • SEO-optimized output

3. Bulk Processing

  • Process multiple images simultaneously
  • Three bulk action types available
  • Progress tracking with detailed results
  • Error handling and reporting

4. One-Shot Actions

  • Process ALL images with a single click
  • No manual selection required
  • Batch limits: 100 images per action
  • Comprehensive result reporting

5. SEO Validation

  • 100-point scoring system
  • Real-time validation feedback
  • Actionable improvement suggestions
  • Color-coded quality indicators

6. Auto-Add on Upload

  • Automatically generate alt text for new uploads
  • Four generation methods available
  • Set and forget automation
  • Works in Media Library and post editor

7. Advanced Filtering

  • Filter images by date range
  • Quick date presets (Today, Last 7 days, etc.)
  • Custom date range picker
  • Search across all image metadata

8. Missing Alt Text Highlighter

  • Visual identification on frontend
  • Red border overlay with label
  • Customizable border color
  • Admin-only visibility

Managing Images

Learn how to view, edit, and generate alt text for your images using Image Alt Text Pro.

Viewing Images With Alt Text

Navigation: Image Alt Text Pro → With Alt Text
  • View current alt text
  • Edit existing alt text
  • Generate alt text using AI
  • Validate SEO quality
  • Filter by upload date

Viewing Images Without Alt Text

Navigation: Image Alt Text Pro → Without Alt Text
This page shows all images missing alt text and should be your top priority.
  • Identify images needing alt text
  • Bulk process images
  • Track optimization progress

Image Actions

View Details

  • 1. Click SEO Score or Details toggle
  • 2. Enter or edit alt text
  • 3. Click Save
  • 4. SEO score updates instantly

Copy Title to Alt Text

  • Copies image title automatically
  • No confirmation needed

Copy Filename to Alt Text

  • Removes file extension
  • Keeps hyphens and underscores

Generate with Local AI

  • Free & unlimited
  • 2–5 seconds per image

Generate with OpenAI

  • Requires OpenAI API key
  • Higher-quality results

Searching & Filtering

Search

  • Top-right of table
  • Searches by image title
  • Real-time results

Date Range Filter

  • 1. Select Date Range
  • 2. Choose preset or custom range
  • 3. Click Apply

Pagination

  • 10, 25, 50, or 100 images per page
  • Navigate using page numbers
  • Total images shown at bottom

AI-Powered Alt Text Generation

Generate accurate, SEO-friendly alt text automatically using Local AI or OpenAI integration.

Viewing Images With Alt Text

No API Key Required • Free & Unlimited

What is Local AI?

  • Runs on our secure servers
  • No API key required
  • Completely free and unlimited
  • Privacy-friendly (images are not stored)
  • Optimized for SEO and accessibility

How It Works

  • 1. Image is securely sent to our AI server
  • 2. AI analyzes the visual content
  • 3. Generates descriptive, SEO-friendly alt text
  • 4. Returns result to your WordPress site
  • 5. Alt text is saved to your Media Library

Best For

  • Users who want free, unlimited generation
  • Sites with many images to process
  • Users without an OpenAI account
  • Budget-conscious websites

Limitations

  • Slightly less contextual than OpenAI
  • Uses a fixed, pre-optimized prompt
  • Requires internet connection

OpenAI Integration (GPT-4o)

API Key Required • Premium Quality

What is OpenAI?

  • Premium AI service by OpenAI
  • Uses GPT-4o Vision model
  • Extremely accurate and contextual
  • Supports custom prompts
  • Requires paid OpenAI account

Setup Steps

1. Get OpenAI API Key
  1. Go to https://auth.openai.com/log-in
  2. Create account or log in
  3. Navigate to API Keys section
  4. Click Create new secret key
  5. Copy the key (starts with sk-)
2. Add API Key to Plugin
  1. Go to Image Alt Text Pro → Settings
  2. Open OpenAI Settings tab
  3. Paste API key
  4. Click Save Changes
  5. Status shows Connected if valid
3. Configure Prompt (Optional)
  • Default prompt is pre-optimized
  • Click Edit Prompt to customize
  • Use placeholders if available
  • Test with a few images
  • Save your custom prompt

Default Prompt

Generate a concise, SEO-friendly alt text for this image in 8–12 words.

Be specific and descriptive. Focus on the main subject and key details.

Use natural language without articles (a, an, the).

Provide only the alt text, no quotes or explanations.

Best For

  • High-quality content websites
  • E-commerce with complex products
  • Sites needing highly specific descriptions
  • Users with existing OpenAI accounts

Costs

  • Charged by OpenAI based on usage
  • Approx. $0.01–$0.03 per image
  • Check OpenAI pricing for current rates
  • You control spending in OpenAI dashboard

Limitations

  • Requires paid OpenAI account
  • Costs per image processed
  • Needs API key configuration

Choosing Between Local AI and OpenAI

Feature Local AI OpenAI
Cost Free Paid per use
Setup None API key required
Quality Very Good Excellent
Speed 2-5 seconds 3-7 seconds
Customization Fixed prompt Custom prompts
Limits Unlimited Your OpenAI budget
Best For Most users Premium needs

Recommendation:

  • Start with Local AI for most images
  • Use OpenAI for important product or hero images
  • Compare results and choose what works best

Bulk Actions

Bulk actions allow you to process multiple images simultaneously, saving significant time.

How to Use Bulk Actions

1. Select Images

  • Check the box next to each image you want to process
  • Or use the table header checkbox to select all visible images
  • Selected image count appears at the top of the table

2. Choose Bulk Action

  • Click the Bulk Actions dropdown
  • Select one of the following:
  • Copy Title to Alt Text
  • Copy Filename to Alt Text
  • Generate with Local AI

3. Execute Action

  • Click the Apply button
  • Confirmation dialog appears
  • Review number of images to process
  • Click Confirm to proceed

4. Monitor Progress

  • Shows current image being processed
  • Displays success and failure counts
  • Processing time varies based on quantity

5. Review Results

  • Success notification appears when complete
  • Total processed images shown
  • Any errors are indicated
  • Table refreshes automatically with updated data

Bulk Action Types

Copy Title to Alt Text

Fast • No AI • Instant

When to Use

  • Images have descriptive titles
  • Quick optimization needed
  • Basic SEO is acceptable

Process

  • Uses image title from Media Library
  • Copies directly to alt text field
  • No AI processing required
  • Instant results

Example
Title: Red Sports Car Driving on Highway
Result: Red Sports Car Driving on Highway

Copy Filename to Alt Text

Exact Filename • No AI

When to Use

  • Filenames are descriptive
  • Images named systematically
  • Need quick batch processing

Process

  • Takes original filename
  • Removes file extension (.jpg, .png, etc.)
  • Keeps hyphens and underscores

Example
Filename: blue-ocean-sunset-beach.jpg
Result: blue-ocean-sunset-beach

Generate with Local AI

AI Powered • Free • SEO Optimized

When to Use

  • Need quality, descriptive alt text
  • Processing many images
  • SEO optimization is important

Process

  • Each image sent to AI service
  • AI analyzes visual content
  • Generates 8–12 word description
  • Optimized for SEO and accessibility
  • Returns and saves result

Example
AI sees: Golden retriever playing with ball in park
Result: Golden retriever dog playing fetch with red ball in grassy park

Best Practices for Bulk Actions

Start Small

  • Test with 5–10 images first
  • Review result quality
  • Adjust method if needed

Don’t Select Too Many

  • Keep batches under 100 images
  • Prevents timeouts
  • Easier error handling

Review Generated Text

  • Spot-check results
  • Edit any that need improvement
  • Ensure accuracy

Use Appropriate Method

  • Local AI for quality descriptions
  • Title for descriptive titles
  • Filename for systematic filenames

Process in Categories

  • Use date filters
  • Process oldest images first
  • Maintain organized workflow

One-Shot Actions

One-shot actions process ALL images with a single click — no selection required. This is the fastest way to optimize your entire image library.

What Are One-Shot Actions?

One-shot actions automatically process every image matching your current page (with or without alt text), up to the batch limit.
  • No manual selection needed
  • Processes up to 100 images per action
  • Comprehensive progress tracking
  • Detailed result reporting
  • Automatic error handling

How to Use One-Shot Actions

1. Navigate to Target Page

  • Go to Without Alt Text to process images needing optimization
  • Go to With Alt Text to update existing alt text

2. View Filters (For Reference)

  • Date range filters help view specific images
  • Search helps find images by title
  • Note: One-shot actions ignore filters and process all images

3. Click One-Shot Button

  • Find One-Shot Actions dropdown at top of page
  • Select a method:
  • Copy Title to Alt Text (100 limit)
  • Copy Filename to Alt Text (100 limit)
  • Generate with Local AI (100 limit)

4. Confirm Action

  • Confirmation dialog shows number of images
  • Review the count
  • Click Proceed to start

5. Monitor Progress

  • Real-time progress bar
  • Status such as Processed 25 of 100
  • Estimated time remaining

6. Review Results

  • Total processed
  • Successful updates
  • Failed updates (if any)
  • Processing time
  • Table refreshes automatically

Important: One-shot actions process ALL images in your media library for the selected page, regardless of active filters.

One-Shot Action Types

Copy Title to Alt Text (One-Shot)

Very Fast • No AI
  • Batch limit: 100 images
  • Speed: 2–5 seconds total
  • Best for images with good titles

Process

  1. Finds first 100 images
  2. Copies each title to alt text
  3. Updates database
  4. Reports completion

Copy Filename to Alt Text (One-Shot)

Very Fast • No AI
  • Batch limit: 100 images
  • Best for descriptive filenames

Process

  1. Retrieves filenames
  2. Removes file extension
  3. Keeps hyphens and underscores
  4. Saves as alt text

Generate with Local AI (One-Shot)

AI Powered • SEO Optimized
  • Batch limit: 100 images
  • Speed: 3–8 minutes per 100 images
  • Best for quality optimization at scale

Process

  1. Queues first 100 images
  2. Sends each to Local AI sequentially
  3. Saves generated alt text
  4. Reports success/failure

One-Shot Limits Explained

  • Prevents server timeout
  • Manages API rate limits
  • Ensures stable processing
  • Better error handling

Default Limits

  • Copy Title: 100 images
  • Copy Filename: 100 image
  • Local AI: 100 images

Processing More Than the Limit

  • Run the one-shot action again
  • Next batch processes automatically
  • Repeat until finished
  • Use date filters for smaller chunks

One-Shot Best Practices

Start with a Test

  • Process last 30 days first
  • Review results
  • Adjust if needed

Work in Batches

  • Don’t process thousands at once
  • Use date ranges
  • Review after each batch

Use During Off-Hours

  • Lower traffic times
  • Faster processing
  • Better user experience

Monitor Server Resources

  • Check hosting limits
  • Ensure adequate timeouts
  • Consider better hosting for large libraries

Backup First

  • Backup database before large runs
  • Easy rollback if needed
  • Standard WordPress best practice

SEO Validation System

The SEO Validation System provides instant feedback on alt text quality using a 100-point scoring system.

What Is SEO Validation?

SEO validation analyzes your alt text against best practices for search engine optimization and accessibility, assigning a score from 0 to 100.

Validated Criteria

  • Alt text length (optimal: 8–12 words)
  • Keyword density (no stuffing)
  • Special character usage
  • Avoid generic terms (e.g., “image of”, “picture of”)
  • Capitalization
  • Punctuation
  • Relevance and specificity

How Scoring Works

Score Ranges

90–100 • Excellent
  • Perfect length
  • Natural language
  • Descriptive and specific
  • SEO optimized
70–89 • Good
  • Acceptable length
  • Minor improvements needed
  • Mostly optimized
Below 70 • Needs Improvement
  • Too short or too long
  • Generic language
  • Keyword issues
  • Requires revision

Accessing SEO Validation

During Alt Text Editing

  • Click the Edit icon on any image
  • Modal opens with current alt text
  • SEO score displays automatically
  • Score updates in real time as you type
  • Suggestions appear below the score

In Image Table

  • SEO Score column shows score for each image
  • Color-coded badges:
  • Green = Excellent
  • Yellow = Good
  • Red = Needs Improvement
  • Click score to see detailed breakdown

Understanding Validation Messages

Length Validation

  • Too Short (<5 words) – Add more descriptive details
  • Too Long (>15 words) – Condense to key details
  • Optimal (8–12 words) – Ideal balance

Keyword Stuffing

Example: red shoes red footwear red sneakers
Fix: Use natural, varied language

Generic Terms

Bad: Image of a cat
Better: Orange tabby cat sleeping on windowsill

Special Characters

Avoid: Cat!!! @home #cute wow
Use standard punctuation only

Empty Alt Text

  • Alt text is required
  • Add descriptive text immediately

Validation Tips

For E-commerce Products

  • Product image
  • Men’s running shoe
  • Nike Air Max men’s running shoe in blue and white

For Blog Images

  • Blog post image
  • Person working on laptop
  • Woman working on laptop at modern office desk with coffee

For Decorative Images

  • Leave alt text empty (only if truly decorative)

Using Validation to Improve SEO

Sort by Score

  • Click SEO Score column header
  • Find lowest-scoring images
  • Prioritize for editing

Review Suggestions

  • Read validation messages
  • Apply recommended changes
  • Re-check score

Aim for 90+

  • Target excellent scores for important images
  • 70–89 acceptable for less critical images
  • Never leave below 70

Batch Review

  • Filter by date range
  • Review weekly
  • Maintain high average score

Monitor Over Time

  • Track improvements
  • Celebrate progress
  • Maintain standards

Auto-Add on Upload

Auto-Add automatically generates alt text when you upload new images to your Media Library.

What Is Auto-Add?

Auto-Add is a set-and-forget feature that ensures every new image includes alt text from the moment it’s uploaded.
  • Never forget to add alt text
  • Maintain SEO from day one
  • Save time during content creation
  • Consistent alt text quality
  • Works with any upload method

Enabling Auto-Add

1. Navigate to Settings

  • Go to Image Alt Text Pro → Settings
  • Click Auto-Add Settings tab

2. Enable Feature

  • Toggle Enable Auto-Add on Upload
  • Switch turns green when active

3. Choose Generation Method

  • Copy Title to Alt Text
  • Copy Filename to Alt Text
  • Generate with Local AI (recommended)
  • Generate with OpenAI (requires API key)

4. Save Settings

  • Click Save Changes
  • Confirmation message appears
  • Auto-Add is now active

Auto-Add Methods

Copy Title Method

Instant • No AI

How It Works

  • Uses the image title entered during upload
  • Sets it as alt text

Best For

  • Users entering descriptive titles
  • Quick publishing workflows

Pros

  • Instant processing
  • No AI required
  • Full control over wording

Cons

  • Quality depends on title
  • Requires manual input

Copy Filename Method

Instant • Automated

How It Works

  • Uses original filename
  • Removes file extension
  • Keeps hyphens and underscores

Best For

  • Well-named image files
  • Systematic naming workflows

Pros

  • No manual input
  • Instant processing

Cons

  • Depends on filename quality
  • May require later editing

Local AI Method (Recommended)

AI Powered • Free • SEO Optimized

How It Works

  • Image uploads to Media Library
  • Automatically sent to Local AI
  • AI generates optimized alt text
  • Saved immediately in background

Best For

  • E-commerce stores
  • Professional sites
  • Content-heavy websites

Pros

  • High-quality results
  • SEO optimized
  • Free and unlimited
  • No manual work required

Cons

  • Adds 2–5 seconds to upload
  • Requires internet connection

OpenAI Method

Premium • Customizable

How It Works

  • Image uploads
  • Sent to OpenAI API
  • GPT-4o generates alt text
  • Uses your custom prompt
  • Saved automatically

Best For

  • Premium quality needs
  • Product photography
  • Professional portfolios

Pros

  • Highest quality output
  • Custom prompts
  • Excellent SEO

Cons

  • Costs per image
  • Requires API key
  • 3–7 second processing time

Where Auto-Add Works

WordPress Media Library

  • Upload new media page
  • Drag-and-drop uploads
  • Standard uploader

Post/Page Editor

  • Block editor (Gutenberg)
  • Classic editor
  • Featured images
  • Inline image uploads

Third-Party Plugins

  • Page builders (Elementor, Divi, etc.)
  • WooCommerce product images
  • Gallery plugins
  • Supported form uploads

Auto-Add Workflow

  • 1. Select image file(s)
  • 2. WordPress uploads to server
  • 3. Auto-Add triggers
  • 4. Selected method generates alt text
  • 5. Alt text saved automatically
  • 6. Upload completes
  • 7. Image ready with alt text included

User Experience

  • Minimal delay (2–7 seconds)
  • Progress indicator shown
  • Alt text auto-filled
  • Editable immediately

Managing Auto-Add

Checking Auto-Added Text

  • Upload new image
  • Open Media Library
  • Click uploaded image
  • View alt text in details panel

Editing Auto-Added Text

  • Update alt text field
  • Click Update
  • Changes save immediately

Disabling Auto-Add

  • Go to Settings
  • Toggle feature off
  • Save changes

Changing Method

  • Select different method in Settings
  • Save changes
  • Future uploads use new method

Auto-Add Best Practices

Choose the Right Method

  • Local AI for most users
  • OpenAI for premium quality
  • Title/Filename only when appropriate

Review Periodically

  • Check recent uploads weekly
  • Edit if needed
  • Maintain quality

Train Your Content Team

  • Explain Auto-Add is active
  • Encourage review of generated text
  • Provide editing guidelines

Monitor Results

  • Check SEO validation scores
  • Track improvements
  • Adjust method if needed

Combine with Bulk Actions

  • Use Auto-Add for new uploads
  • Use Bulk or One-Shot for existing images
  • Achieve full media library coverage

Advanced Filters

Advanced filters help you narrow down images by date, making it easy to process specific time periods.

Date Range Filtering

Access Filters

  • Look for Filter by Date Range dropdown at top of image table
  • Available on both With Alt Text and Without Alt Text pages

Quick Date Presets

Today

  • Shows images uploaded today
  • Updates automatically each day
  • Useful for daily checks

Yesterday

  • Shows previous day's uploads
  • Good for reviewing recent work

Last 7 Days

  • Shows past week of uploads
  • Popular for weekly reviews
  • Manageable batch size

Last 30 Days

  • Shows past month
  • Good for monthly optimization

This Month

  • Shows current calendar month
  • Resets on the 1st of each month
  • Ideal for monthly workflows

Last Month

  • Shows previous calendar month
  • Great for historical review
  • Useful for month-by-month processing

Custom Range

  • Select any start and end date
  • Maximum flexibility
  • Target specific time periods

Using Custom Date Range

  • 1. Click Filter by Date Range
  • 2. Select Custom Range
  • 3. Choose a start date (calendar or YYYY-MM-DD format)
  • 4. Select an end date (must be after start date)
  • 5. Click Apply or Filter
  • 6. Table updates with filtered results

Clear Filter

  • Click Clear or Reset
  • Or choose All Dates from dropdown
  • Full image list returns

Combining Filters with Search

  • Apply a date range filter
  • Use search box to find images within that range
  • Results match both criteria

Example:
Filter: Last 30 Days
Search: product
Result: All product images from past month

Filter Use Cases

Monthly Review

  • Filter: Last Month
  • Review previous month’s images
  • Use individual or bulk actions
  • Track month-over-month progress

Client Project Review

  • Use Custom Range for project timeline
  • Review and optimize project images
  • Apply bulk actions where needed

Website Launch Preparation

  • Review images in batches
  • Use bulk actions for selected images
  • Use one-shot actions for full library
  • Launch fully optimized

Ongoing Maintenance

  • Filter: Last 7 Days (weekly)
  • Quick review of new uploads
  • Maintain quality standards

Important: Filters apply to individual and bulk actions only. One-shot actions always process all images in your library.

Filter Performance Tips

Use Filters for Large Libraries

  • Avoid loading thousands of images at once
  • Break work into smaller date ranges
  • Improves performance and usability

Bookmark Common Filters

  • Some browsers support bookmarking filtered URLs
  • Quick access to frequently used views

Export Filtered Data

  • Export filtered lists if needed
  • Track optimization progress
  • Report results to stakeholder

Missing Alt Text Highlighter

The Missing Alt Text Highlighter visually identifies images without alt text on your website’s frontend.

What Is the Highlighter?

A frontend tool that adds a visible border and label to images missing alt text, making them instantly noticeable while you are logged in as an administrator.
  • Visible only to administrators
  • No impact on regular visitors
  • Customizable border color
  • Works across the entire site
  • Real-time detection

Enabling the Highlighter

1. Navigate to Settings

  • Go to Image Alt Text Pro → Settings
  • Find Missing Alt Text Highlighter section

2. Enable Feature

  • Toggle Enable Highlighter
  • Switch turns green when active

3. Choose Border Color (Optional)

  • Use the color picker
  • Default: #FF0000 (Red)
  • Select a color that stands out on your site

4. Save Settings

  • Click Save Changes
  • Highlighter becomes active immediately

How It Works

When Enabled

  • 1. Visit any page while logged in as administrator
  • 2. Script scans all images on the page
  • 3. Checks each image for alt text
  • 4. Images missing alt text receive:
  • Colored border
  • “Missing Alt Text” label
  • Slight overlay for visibility

Visitor Experience

  • Regular visitors see nothing
  • No SEO impact
  • No accessibility issues
  • No noticeable performance impact

Using the Highlighter

Visual Inspection Workflow

  • Browse your site normally
  • Visit key pages (home, about, products, blog posts)
  • Identify red-bordered images
  • Note pages needing optimization
  • Take screenshots for reference if needed

Team Collaboration

  • Show clients or team members the highlighter
  • Visually demonstrate missing alt text
  • Track progress as borders disappear

Customizing Appearance

Border Color Options

  • Red (#FF0000) – Highest contrast
  • Orange (#FF6600) – Slightly softer
  • Yellow (#FFFF00) – Less aggressive
  • Magenta (#FF00FF) – Highly visible
  • Custom – Choose any brand-safe color

Choosing the Right Color

  • Ensure strong contrast with your design
  • Avoid using brand primary colors
  • Test across different pages
  • Consider color accessibility (avoid red/green-only contrast)

Highlighter Limitations

Does Not Highlight

  • CSS background images
  • Some dynamically loaded JavaScript images
  • Images inside external iframes
  • Some SVG configurations

Works Best With

  • Standard tags
  • WordPress content images
  • Featured images
  • Gallery images
  • Most common WordPress image setups

Disabling the Highlighter

When to Disable

  • After completing optimization
  • Before client presentations
  • During frontend development
  • When taking clean screenshots
  • 1. Go to Settings
  • 2. Toggle Enable Highlighter off
  • 3. Click Save Changes
  • 4. Refresh open pages

Re-Enabling

  • Toggle the feature back on
  • Save changes
  • Highlighter becomes active instantly
  • No configuration is lost

Settings Configuration

The Settings page contains all configuration options for Image Alt Text Pro.

Access: Image Alt Text Pro → Settings

Settings Sections

General Settings

  • Alt Text Best Practices information displayed
  • Educational reference material
  • No configuration required

OpenAI Settings

API Key

  • Enter your OpenAI API key
  • Required for OpenAI features
  • Validated when saved
  • Stored securely and encrypted

Custom Prompt

  • Customize AI generation instructions
  • Default prompt provided
  • Recommended for advanced users
  • Test before large-scale use
API Status
  • Connection status indicator
  • Shows if API key is valid
  • Displays error messages if issues occur
  • Includes test connection option

Auto-Add Settings

Enable Auto-Add

  • Toggle on/off
  • Activates automatic alt text generation on upload
  • Applies to all new uploads

Generation Method

  • Select from dropdown
  • Four available methods
  • Choose based on your workflow
  • Can be changed at any time
Method Descriptions
  • Helpful explanations for each method
  • Pros and cons listed
  • Recommendations provided

Missing Alt Text Highlighter

Enable Highlighter

  • Toggle on/off
  • Controls frontend highlighting
  • Visible to administrators only

Border Color

  • Color picker selection
  • Default: Red
  • Preview shown
  • Updates instantly when changed

Label Text

  • Customizable overlay label
  • Default: “Missing Alt Text”
  • Supports multiple languages
  • Keep text clear and concise

Saving Settings

Save Changes Button

  • Located at bottom of each section
  • Must click to apply changes
  • Confirmation message appears after saving
  • Settings persist across sessions

Save Behavior

  • Validates inputs before saving
  • Displays errors if validation fails
  • Confirms successful save
  • Remains on Settings page after saving

License Activation

Your Image Alt Text Pro license must be activated to access all premium features.

Obtaining Your License Key

  1. Complete your purchase at https://imagealttext.in
  2. Log in to your account dashboard
  3. Navigate to the Orders section
  4. Locate your license key
  5. Format: XXXX-XXXX-XXXX-XXXX
  6. Store the key securely for future use

Key Information

  • Unique to your purchase
  • Tied to your registered domain(s)
  • Number of activations depends on your plan

Plan Limits

  • Starter: 1 site
  • Studio: 5 sites
  • Agency: 15 sites

Activating Your License

1. Access License Page

  • Go to Image Alt Text Pro → License
  • License activation form appears

2. Enter License Key

  • Paste or type your license key
  • Format: XXXX-XXXX-XXXX-XXXX
  • Copy and paste recommended

3. Click Activate

  • Activation request sent to license server
  • Validation takes 2–5 seconds

4. Confirmation

  • Success message displayed
  • Status shows Active
  • Expiration date visible
  • All features unlocked

License Status

Managing Your License
  • Green status indicator
  • Full feature access
  • Support access granted

Managing Your License

Moving to Another Site

  1. Deactivate license on current site
  2. Install plugin on new site
  3. Activate using same license key
  4. Activation slot is reused

Troubleshooting License Issues

Invalid License Key

  • Check for typos
  • Remove extra spaces
  • Copy directly from purchase email
  • Contact support if issue persists

Activation Limit Reached

  • All activations for your plan are in use
  • Deactivate on an unused site
  • Upgrade your plan if needed
  • Contact support for assistance

Connection Error

  • Check internet connection
  • Ensure firewall isn’t blocking requests
  • Retry in a few minutes
  • Contact support if problem continues

License Not Showing Active

  • Clear browser cache
  • Refresh page
  • Check license server status
  • Contact support if unresolved

License Plans

Plan Site Activations Features Support Price (Per Year)
Starter 1 All features included Priority $14.99
Studio 5 All features included Priority $29.99
Agency 15 All features included Priority $49.99

Frequently Asked Questions

General Questions

Feature Questions

Technical Questions

Pricing & License Questions

Support Questions

Troubleshooting

Common issues and solutions to help you quickly resolve problems with Image Alt Text Pro.

Plugin Not Appearing in Menu

Symptoms

  • Cannot find “Image Alt Text Pro” in WordPress admin menu
  • Plugin installed but not visible

Solutions

  • 1. Verify plugin is activated (Plugins → Activate)
  • 2. Clear browser cache (Ctrl+F5 / Cmd+Shift+R)
  • 3. Check for plugin conflicts:
  • Deactivate other plugins temporarily
  • Activate Image Alt Text Pro alone
  • Reactivate others one by one

AI Generation Not Working

Symptoms

  • Generate button does nothing
  • Error message appears
  • Stuck on “Generating…”

Local AI Solutions

  • Check internet connection
  • Ensure firewall is not blocking imagealttext.in
  • Retry (server may be busy)
  • Contact support if issue persists

OpenAI Solutions

  • Verify API key is entered correctly
  • Ensure OpenAI account has credits
  • Check API rate limits
  • Review error message details

Bulk Actions Timing Out

Symptoms

  • Process does not complete
  • Maximum execution time exceeded
  • Connection error

Solutions

  • Reduce batch size (25–50 images)
  • Increase PHP max_execution_time (contact host)
  • Use one-shot actions for better chunking
  • Upgrade hosting if limits are strict

Images Not Showing in Tables

Symptoms

  • Table loads but no images appear
  • “No data available” message

Solutions

  • Reset date filters to “All Dates”
  • Clear search box
  • Confirm images exist in Media Library
  • Clear plugin cache or re-activate plugin
  • Contact support if database issue suspected

Highlighter Not Working

Symptoms

  • No red borders on frontend
  • Feature enabled but not visible

Solutions

  • Ensure Highlighter is enabled in Settings
  • Confirm logged in as Administrator
  • Hard refresh page
  • Check browser console for JS errors (F12)
  • Verify images use standard tags

License Activation Failing

Symptoms

  • Invalid license key
  • Activation limit reached
  • License shows inactive

Solutions

  • Deactivate unused sites
  • Ensure email matches purchase email
  • Verify firewall not blocking server
  • Contact support with error details

Auto-Add Not Generating

Symptoms

  • Alt text remains empty after upload
  • Auto-Add enabled but inconsistent

Solutions

  • Confirm Auto-Add is enabled
  • Verify method requirements (API key / internet)
  • Test with a single small image
  • Clear browser and CDN cache

SEO Score Not Updating

Symptoms

  • Score does not change after editing
  • Score appears outdated

Solutions

  • Ensure you clicked Save
  • Refresh page or reopen modal
  • Verify alt text saved in Media Library
  • Clear browser/server cache

Getting More Help

Before Contacting Support

  • Review documentation
  • Try steps listed above
  • Test with other plugins disabled
  • Clear all caches

Response Time

  • Expected response within 24 hours
  • Priority for active license holders
  • Emergency issues escalated

When Contacting Support

  • License key
  • WordPress version
  • PHP version
  • Theme name
  • Active plugins list
  • Exact error messages
  • Screenshots
  • Steps to reproduce

Support & Contact

Need help or want to share feedback? We’re here to support you.

Getting Help

Email Support

  • Response time: Within 24 hours (often faster)
  • Include your license key for quicker assistance
  • Describe your issue in detail

Online Documentation

  • Knowledge base articles
  • Video tutorials
  • Feature guides
  • Best practices

Community Forum

  • Coming soon
  • Share tips and tricks
  • Learn from other users
  • Submit feature ideas

Feature Requests

We love hearing from users and continuously improve based on your suggestions.

Submit Ideas

  • Subject line: “Feature Request”
  • Describe the desired feature clearly
  • Explain your use case

Voting on Features

  • Roadmap published quarterly
  • Vote on upcoming features
  • Community-driven development
  • Contact support if issue persists

Bug Reports

Found a bug? Help us fix it quickly.

How to Report

  • Subject: “Bug Report”
  • Include:
  • WordPress version
  • Plugin version
  • Steps to reproduce
  • Expected vs actual behavior
  • Screenshots
  • Error messages (exact text)

Bug Priority Levels

  • Security bugs: Immediate attention
  • Critical bugs: 24–48 hours
  • Minor bugs: Next update cycle

Feedback

Your feedback helps shape the future of the plugin.

Share Feedback

  • In-plugin feedback form
  • WordPress.org reviews (free version)
  • Social media mentions

What We Want to Know

  • Features you love
  • Areas for improvement
  • Workflow suggestions
  • UI/UX feedback
  • Documentation clarity

Newsletter

  • Monthly tips and tricks
  • Feature announcements
  • Exclusive discounts
  • SEO best practices

About RS WebStudios

Who We Are

  • Professional WordPress developers
  • SEO and accessibility experts
  • Committed to quality software
  • Customer-focused support

Our Mission:
Make the web more accessible and SEO-friendly, one image at a time.

Appendices

Reference materials and supporting documentation for Image Alt Text Pro.

Appendix A: Alt Text Best Practices

General Guidelines

Length
  • Aim for 8–12 words
  • Maximum 125 characters
  • Be concise but descriptive
Content
  • Describe what you see
  • Focus on important details
  • Be specific and accurate
  • Use natural language
SEO
  • Include relevant keywords naturally
  • Avoid keyword stuffing
  • Match search intent
  • Align with page content
Accessibility
  • Provide meaningful context
  • Avoid “image of” or “picture of”
  • Consider screen reader users
  • Add value for non-sighted visitors

Industry-Specific Examples

E-commerce
❌ Product image
✅ Black leather sofa with chrome legs and three cushions

Blog Posts
❌ Blog post graphic
✅ Woman typing on laptop at modern home office desk

Real Estate
❌ House photo
✅ Modern three-bedroom home with landscaped yard and brick facade

Restaurants
❌ Food
✅ Grilled salmon fillet with roasted vegetables and lemon garnish

News/Media
❌ Event photo
✅ Crowd gathered at city hall for climate change rally

Decorative Images

  • Use empty alt attribute: alt=""
  • Not the same as missing alt attribute
  • Screen readers will skip properly marked decorative images

Complex Images

Charts & Graphs

  • Describe key data points
  • Mention trends or conclusions
  • Link to full data table if available

Infographics

  • Summarize main message
  • Provide full text alternative in content

Maps

  • Describe location and purpose
  • Provide text directions elsewhere

Appendix B: Keyboard Shortcuts

Action Windows/Linux Mac
Open Edit Modal Click + E Click + E
Close Modal Esc Esc
Save Changes Ctrl + Enter Ctrl + Enter
Next Image → →
Previous Image ← ←

Appendix C: API Information

Local AI API

  • Endpoint: Managed internally
  • Authentication handled automatically
  • No rate limits
  • Cost: Free
  • Uptime: 99.9% SLA

OpenAI API

  • Model used: GPT-4o Vision
  • You must obtain API key
  • Manage billing in OpenAI dashboard
  • Monitor usage and rate limits

Estimated Cost: $0.01–$0.03 per image (varies by size)

Appendix D: Glossary

  • Alt Text: Alternative text describing an image
  • API Key: Authentication credential for external services
  • Bulk Action: Operation applied to multiple items
  • GPT-4o: OpenAI vision-capable AI model
  • Local AI: Built-in AI service (no API key required)
  • One-Shot Action: Single-click full processing operation
  • Screen Reader: Assistive technology for visually impaired users
  • SEO: Search Engine Optimization
  • Validation: Quality check against best practices
  • WCAG: Web Content Accessibility Guidelines

Document Information

  • Documentation Version: 1.0.0
  • Plugin Version: 1.0.0
  • Last Updated: November 10, 2025
  • Next Review: Quarterly

Copyright & License

Copyright © 2025 RS WebStudios
All rights reserved.

Documentation may be reproduced for personal use only. Commercial redistribution prohibited without written permission.

Plugin licensed under GPLv2 or later.

Thank you for choosing Image Alt Text Pro! Questions? Email: support@imagealttext.in