Documentation

Installation

In WordPress, go to Plugins > Add New, search for "Altagonist", and click Install Now, then Activate.

Altagonist is published in the official WordPress.org plugin directory, so it installs in one click and updates automatically.

Activating Your License

A free license is provisioned automatically when you activate the plugin — you'll get 50 free credits per month with nothing to configure.

To upgrade, paste your license key from your account page into Altagonist > Settings and click Validate. Your credits and plan will be confirmed.

Choosing Your Languages

On the Settings page, check the languages you want to use for alt tag generation. Only checked languages will appear in the language selector on the main page. Use the search bar to filter the list.

Altagonist supports 70 languages — from major world languages like English, Spanish, French, and Arabic to regional languages like Catalan, Basque, Welsh, and Swahili.

Single Image

Go to Altagonist in your WordPress admin. You'll see all images in your media library.

1. Select a language and quality level
2. Click the play button next to any image
3. The alt tag will be generated and saved automatically
4. A checkmark appears when complete

To regenerate, hover over the checkmark and click the redo icon.

Batch Processing

To process multiple images at once:

1. Check the boxes next to the images you want to process (or use the select-all checkbox)
2. Click the blue play button in the header
3. Images are processed one by one — each shows a spinner while processing
4. Credits are deducted per image based on quality level

Filtering Images

Use the Show Only Empty toggle to filter your media library to only show images that don't have an alt tag yet. This is useful for finding images that still need processing.

Auto-Generate on Upload

Enable this in Settings to automatically generate alt tags whenever you upload new images to WordPress.

You can configure the default language and quality level for auto-generated tags. This runs silently in the background and won't interrupt your upload.

Lite (1 credit)

Uses image metadata only: filename, title, caption, description, and dimensions.

Best for: Standalone images, product photos, or images where the filename is descriptive. Fastest processing time.

Medium (2 credits)

Everything in Lite, plus excerpts from your homepage and the page/post where the image is used (up to 500 characters each).

Best for: Most use cases. Provides a good balance between context and cost. The AI understands what your page is about and generates more relevant descriptions.

High (3 credits)

Everything in Medium, but sends the full content of your homepage and the page where the image appears — and points the AI at the text right around the image.

Best for: Content-heavy pages where context matters most. Produces the most relevant and specific alt tags. Slowest processing time.

How Credits Work

Each image you process costs credits based on the quality tier:

Your remaining credits are displayed in the top-right corner of the Altagonist admin page.

Plans

Paid plans are billed monthly. All plans include access to all quality tiers and all 70 languages.

Credit Renewal

Free plan credits reset on the 1st of each month. Paid plan credits reset on your billing anniversary date. Unused credits do not roll over.

Upgrading

You can upgrade your plan at any time from your account page. Your new credit balance takes effect immediately.

Supported Languages

Altagonist generates alt tags in 70 languages:

English, Nederlands, Español, Français, Deutsch, Italiano, Português, Русский, 日本語, 中文, 繁體中文, 한국어, العربية, हिन्दी, Türkçe, Polski, Svenska, Dansk, Norsk, Suomi, Čeština, Українська, Ελληνικά, Română, Magyar, Slovenčina, Български, Hrvatski, עברית, فارسی, Tiếng Việt, ภาษาไทย, Bahasa Indonesia, Bahasa Melayu, Català, Lietuvių, Latviešu, Eesti, Slovenščina, Srpski, Bosanski, Македонски, Shqip, Беларуская, Afrikaans, বাংলা, ગુજરાતી, मराठी, தமிழ், తెలుగు, ಕನ್ನಡ, മലയാളം, ਪੰਜਾਬੀ, اردو, Kiswahili, Filipino, ភាសាខ្មែរ, မြန်မာဘာသာ, नेपाली, Azərbaycanca, Қазақша, O'zbek, Հայերեն, ქართული, Монгол, Euskara, Galego, አማርኛ, Íslenska, Cymraeg

Setting Your Language

1. Go to Altagonist > Settings
2. Enable the languages you want in the checkbox list
3. On the main page, select the active language from the dropdown
4. All generated alt tags will be in the selected language

You can switch languages between batches to generate alt tags in different languages for different images.

Insufficient credits

If you see this error, you don't have enough credits for the selected quality tier. You can:

• Switch to a lower quality tier (e.g. Lite instead of Medium)
• Wait for your monthly credit renewal
• Upgrade to a higher plan

Image could not be read

This usually means the file is corrupted or larger than 20MB. JPEG, PNG, GIF, and WebP work natively, and SVG, AVIF, TIFF, and BMP are converted automatically. Try re-uploading the image or reducing its file size.

Server not available

If the server is temporarily unreachable, wait a moment and try again. If the issue persists, contact us at https://altagonist.com/contact.

Alt tag seems inaccurate

Try the following:

• Use Medium or High quality for more context-aware results
• Make sure your image filename is descriptive (e.g. red-nike-sneaker.jpg instead of IMG_4521.jpg)
• Regenerate by hovering over the checkmark and clicking the redo icon
• You can always manually edit alt tags in the WordPress media library

Plugin not showing in admin menu

Altagonist requires the upload_files capability. This is available to Editors and Administrators by default. If you have a custom role, make sure it includes this capability.

Are my images stored on your servers?

No. Images are processed in real-time and immediately discarded after generating the alt text. We do not store your images.

Can I use Altagonist on multiple sites?

Yes! All plans, including free, support multiple WordPress sites. Just enter the same license key in each WordPress installation. Credits are shared across all sites.

Will this slow down my site?

No. Alt tags are generated in the WordPress admin only, not on the front-end. The plugin adds no code or scripts to your public pages.

Can I cancel my subscription?

Yes, you can cancel at any time from your account page. You'll keep access until the end of your billing period.