img2text Documentation

Complete guide to using the img2text WordPress plugin for automatic SEO-optimized image descriptions.

Getting Started

img2text is a WordPress plugin that uses AI to automatically generate SEO-optimized alt texts, titles, captions, and descriptions for your images. It improves your website's accessibility and search engine ranking.

Requirements:

WordPress 5.0 or higher
PHP 7.4 or higher
An img2text account with API key
Active subscription with available credits

Installation

Step 1: Download the Plugin

Step 2: Upload to WordPress

Go to Plugins > Add New > Upload Plugin
Select the downloaded ZIP file
Click "Install Now"
Activate the plugin

Step 3: Enter API Key

Navigate to img2text in the WordPress admin menu
Copy your API key from the dashboard
Paste it into the API Key field
Click "Save Settings"

Keep your API key secure. Never share it publicly.

Configuration

Click to enlarge

Setting	Description
API Key	Your personal API key from the img2text dashboard. Required for all operations.
Custom Prompt	Additional context for the AI to generate more relevant descriptions (e.g., "This is a furniture shop").
Language	Output language for generated texts. Supported: German, English, French, Spanish, Italian, Portuguese, Dutch.
Overwrite	When enabled, existing texts will be overwritten. When disabled, only empty fields will be filled (saves credits).
Rename Files	Automatically renames image files to SEO-friendly names.

Generated Fields

Click to enlarge

Alt Text

The most important field for SEO and accessibility. Describes image content for screen readers and search engines.

Title

The image title displayed on hover. Useful for additional context.

Caption

Visible text below the image when inserted into posts/pages.

Description

Detailed description stored in the media library.

Long Description

Extended description for detailed image documentation.

Filename

SEO-friendly filename suggestion based on image content.

Manual Generation

Generate texts for individual images on demand.

Click to enlarge

How to use:

Go to Media > Library
Click on any image
Find the "img2text" section
Click "Generate Texts"
Wait for the AI to analyze and generate
Review and save the generated content

Tip: Manual generation uses the fields configured under "Manual (Button)".

Automatic Upload Processing

Automatically generate texts when new images are uploaded.

Setup:

Go to img2text settings
Find "On Upload" in the Fields section
Select the fields to generate automatically
Save settings

Note: Each upload consumes credits. Consider your credit usage.

Bulk Processing

Process all images in your media library at once.

Click to enlarge

How it works:

Configure fields to generate under "Bulk Processing"
Scroll to the "Bulk Processing" card
Click "Generate All Missing Texts"
Progress bar shows current status
Processing runs in background via WP-Cron
You can stop anytime with Cancel

When "Overwrite" is OFF

Only images without alt text will be processed. Existing texts are preserved.

When "Overwrite" is ON

ALL images will be processed and existing texts will be replaced.

Performance: Bulk processing handles 5 images per minute via WP-Cron.

Custom Prompts

Use custom prompts to get better, context-aware descriptions for your specific use case.

E-Commerce / Online Shop

                                        Describe products for an online shop. Focus on product features, materials, and benefits. Use persuasive sales language.                                    

Real Estate

                                        Describe real estate images. Highlight room features, lighting, space, and architectural details. Professional tone.                                    

Food & Restaurant

                                        Describe food images appetizingly. Mention ingredients, cooking style, and presentation. Make readers hungry!                                    

Travel & Tourism

                                        Describe travel destinations. Capture the atmosphere, sights, and experiences. Inspire wanderlust.                                    

API Reference

For developers who want to integrate img2text directly.

POST /v1/chat/completions

Request Headers

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Origin: https://your-domain.com

Request Body

{
  "image_url": "https://example.com/image.jpg",
  "fields": ["alt", "title", "caption", "description"],
  "language": "en",
  "custom_prompt": "Optional context..."
}

Response

{
  "choices": [{
    "message": {
      "content": "{\"alt\": \"...\", \"title\": \"...\", ...}"
    }
  }]
}

GET /v1/status

Check your account status, credits, and subscription.

{
  "api_key_valid": true,
  "subscription": "starter_yearly",
  "subscription_name": "Starter (Yearly)",
  "credits_left": 5000,
  "max_domains": 5,
  "domains_used": 2
}

Frequently Asked Questions

How many credits does one image use?

Each image analysis uses approximately 1 credit, regardless of how many fields you generate.

What image formats are supported?

All common web formats are supported: JPG/JPEG, PNG, GIF, and WebP. The image must be accessible via a public URL.

Can I use the plugin on multiple websites?

Yes! The number of domains depends on your subscription plan. Starter allows 1 domain, Professional 3, and Agency unlimited.

Is the service GDPR compliant?

Yes! Our servers are located in Germany and we don't store your images. The image URL is only used temporarily for analysis.

What happens when my credits run out?

The plugin will show an error message. You can purchase additional credit packs or wait for your monthly/yearly renewal.

Can I edit the generated texts?

Of course! The generated texts are stored in standard WordPress fields and can be edited at any time.

Does the plugin work with page builders?

Yes! Since img2text works at the media library level, it's compatible with all page builders - Elementor, Divi, WPBakery, Gutenberg, and others.

Troubleshooting

"API Key Invalid" Error

This error occurs when the API key is incorrect or expired.

Copy the API key directly from your dashboard
Check for leading/trailing spaces
Ensure your subscription is active
Regenerate a new API key if needed

"Domain Limit Reached" Error

You've exceeded the number of allowed domains.

Go to your domain management
Remove unused domains
Add the new domain
Consider upgrading to a plan with more domains

Bulk Processing Stops or Is Very Slow

Bulk processing relies on WP-Cron, which doesn't run reliably on all hosts.

Ensure your site gets regular traffic
Set up a real cron job
Check if a caching plugin is blocking cron
Increase PHP timeout in your hosting settings

"Image URL Not Found" Error

The API couldn't access your image.

Check if the image is publicly accessible
Ensure your site doesn't block external requests
Check firewall or security plugin settings
Test the image URL in an incognito browser

Generated Texts Not Appearing

Texts were generated but don't show in WordPress.

Refresh the media library page
Clear cache plugins
Check if "Overwrite" is disabled and fields already have content
Verify the correct fields are selected

Still Need Help?

Our support team is ready to help you with any questions.

Contact Support