Joomla Documentation
Step-by-step guide to installing, configuring, and using AutoAlt.ai – the AI-powered Automatic Alt Text Generator for Joomla. Learn features, settings, and best practices to optimize images for SEO and accessibility.
Requirements
- Joomla: Version 4.0, 5.0 or 6.0 (fully compatible)
- PHP: Version 7.4 or higher (recommended: PHP 8.1+)
- AutoAlt.ai Account: Register for free (50 free credits)
- Admin access: Required for the Joomla backend
01 About
What does AutoAlt.ai do in Joomla?
AutoAlt.ai automatically generates descriptive and SEO-friendly alt text for all images across your Joomla site. It integrates with Joomla components such as Articles, Categories, Banners, News Feeds, Contacts, and User Notes, ensuring images are always accessible and optimized.
Video Tutorials
Explore how AutoAlt.ai works across different platforms. Watch step-by-step tutorials and plugin demos on our YouTube channel to quickly learn how to get started and make the most of our features.
Need Support?
Have questions or need help? Visit our Support Page to browse FAQs, watch helpful videos, or connect with our support team for personalized assistance.
02 Plugin Installation
Joomla
Joomla – AI-Powered Image Alt Text Generator Automatically generate alt text for your Joomla site images using advanced AI. AutoAlt.ai analyzes your content and images to create accurate, SEO-friendly Alt Text Improving accessibility and boosting your search rankings with minimal effort.
- Open Joomla Admin Panel.
- From the top menu, click System → Extensions → Install.
- On the Install Extensions screen, select the Install from Web tab.
- In the search box, type AutoAlt, select the AutoAlt extension from the results, and click Install.
- Go to Components → AutoAlt.ai → Login / Register.
- Enter your Email Address.
- Click "Send Verification Code", enter the OTP, and verify.
- Done! Your AutoAlt.ai account is automatically created, and the API key is configured.
- Go to Articles (or upload a new image to any article).
- When you upload an image, AutoAlt automatically generates the alt text.
Screenshot: of the AutoAlt.ai “AI Alt Text Generator for Images” admin dashboard showing options to connect an API key or log in/register, with buttons for “Connect & Save” and “Send Verification Code,” plus sections for Bulk Alt Text Generator, Alt Text Generation History, and image statistics for articles, categories, banners, and newsfeeds.
Note: The inserted Domain must match the API key. If they don’t, you’ll see the error: “Domain and key mismatch.” Please ensure both values are correct.
When Images are Uploading
If the “Auto-Generate on Image Upload” checkbox is enabled, AutoAlt.ai will automatically generate alt text every time you upload an image to Joomla (e.g., in Articles, Banners, or Categories).
If the checkbox is disabled, AutoAlt.ai will not run automatically. Instead, you can manually generate alt text by clicking the “Generate Alt Text – AutoAlt.ai” button when editing an image. This gives you more control if you prefer to decide which images should have AI-generated alt text.
Screenshot: Screenshot of Joomla plugin AutoAlt configuration page with options for API key, alt text settings, and plugin status.
Note: This option is Checked by default. If unchecked, automatic alt text generation for new images will be stopped.
Generate Alt Text on Article Page
Click the “Generate Alt Text – AutoAlt.ai” button to instantly create AI-powered alt text for your uploaded image.
Screenshot: Joomla dashboard displaying an article editor with an image upload interface.
Generate Alt Text on Category Page
Click “Generate Alt Text – AutoAlt.ai” on the Category page to automatically create AI-powered alt text for category images.
Screenshot: Joomla interface with options for editing article categories, including uploading and describing an image.
Filter by Image Extension
The “Filter by Image Extension” feature helps you manage credits efficiently. For example, if you upload images in JPG or PNG format, but your website automatically converts them to WebP for performance optimization, it’s recommended to filter and select only the WebP format during processing. This ensures that credits are used only for the final images actually displayed on your site.
Screenshot: Screenshot of AutoAlt settings interface showing API key, credit balance, and language options for alt text generation.
Include Prefix & Post Fix for SEO
Add custom prefix or postfix keywords to your generated alt text to improve SEO relevance and branding.
Screenshot: Joomla plugin settings interface displaying AutoAlt configuration for automatic alt text generation.
Bulk Alt Text Generator Dashboard
The Bulk Alt Text Generator dashboard enables administrators to automatically create AI-powered alt text for images across Articles, Categories, Banners, and Newsfeeds within Joomla. It provides a clear overview of total images, missing alt text counts, available credits, and used credits to help manage optimization efficiently. Users can select specific image groups or target only images without existing alt text, ensuring accurate and resource-friendly processing. With a single click, alt text can be generated in bulk, improving website accessibility, enhancing SEO performance, and ensuring compliance with accessibility standards while saving time and manual effort.
Screenshot: Screenshot of the AutoAlt.ai “AI Alt Text Generator for Images” Joomla admin dashboard showing the Bulk Alt Text Generator tab with image statistics for articles, categories, banners, and newsfeeds, available and used credits, and options to select images to process with a “Generate Alt Text” button.
FAQ
Which Joomla components does AutoAlt.ai support?
AutoAlt.ai seamlessly integrates with Joomla’s core components, including:
- Articles (Intro and Full Article Images)
- Article Categories (Category Images)
- Banners (Banner & Banner Category Images)
- News Feeds (Feed & Category Images)
- Contacts (Contact Category Images)
- User Notes (Edit Category Images)
Is AutoAlt.ai compatible with different Joomla versions?
Yes. AutoAlt.ai is fully compatible with Joomla 4, Joomla 5 and Joomla 6.
Can I use one AutoAlt.ai API key for multiple Joomla sites or domains?
Yes. AutoAlt.ai allows you to use a single API key across multiple Joomla websites or domains. This makes it easier to manage alt text generation for agencies, developers, or businesses running several Joomla installations.
Can I customize how the alt text is written?
Absolutely. AutoAlt.ai includes a Custom GPT Prompt feature that lets you define how descriptions should be generated. This ensures the alt text matches your brand’s style, tone, and intent.
What image formats are supported by AutoAlt.ai?
AutoAlt.ai works with all common web formats including JPG, JPEG, PNG, SVG, AVIF, GIF, and WebP. This ensures compatibility with most Joomla sites regardless of the type of images you upload.
Do I need to configure anything after installation?
Yes. After installation, go to System → Plugins → AutoAlt and enable it. In the plugin settings, you need to enter your API key from AutoAlt.ai. You can also configure options such as language, customize GPT prompts for your brand voice, and set multilingual options if your Joomla site supports multiple languages.
Does AutoAlt.ai support Joomla’s Accessibility compliance (WCAG, ADA, EAA)?
Yes. AutoAlt.ai helps your Joomla site meet accessibility standards by ensuring all images have descriptive alt text, improving compliance with WCAG 2.1, ADA, and EAA guidelines.
How do credits and pricing plans work?
We offer both subscription plans and one-time credit pack.
- Standard image formats (JPG, PNG, GIF, WebP) use 1 credit per image.
- 25 free credits are included for new accounts.
- Unused credits roll over to the next billing cycle.
- You can cancel at any time without losing your unused credits
What happens if I cancel my subscription?
When you cancel:
- Your subscription stops renewing automatically.
- You won’t be charged further.
- Any unused credits remain in your account.
Can I use AutoAlt.ai on multiple websites?
Yes, You can add as many websites as you want to your AutoAlt.ai account. Just add each domain to your account. As long as you have credits available, you can generate alt text across all sites.
What does the “Auto-Generate on Image Upload” setting do in Joomla?
If the “Auto-Generate on Image Upload” checkbox is enabled, AutoAlt.ai will automatically generate alt text every time you upload an image to Joomla (e.g., in Articles, Banners, or Categories).
If the checkbox is disabled, AutoAlt.ai will not run automatically. Instead, you can manually generate alt text by clicking the “Generate Alt Text – AutoAlt.ai” button when editing an image. This gives you more control if you prefer to decide which images should have AI-generated alt text.
Done!
Your Joomla installation is now successfully connected to AutoAlt.ai. All new images will automatically receive SEO-optimized and WCAG-compliant alt text.
