Drupal Documentation
Step-by-step guide to installing, configuring, and using AutoAlt.ai – the AI-powered Automatic Alt Text Generator for Drupal. Learn about module setup, account connection, bulk alt text generation, and best practices to optimize images for SEO and accessibility compliance.
Requirements
- Drupal: Version 10.x or 11.x (fully compatible)
- PHP: Version 8.0 or higher (recommended: PHP 8.1+)
- AutoAlt.ai Account: Free registration available (includes free credits)
- Admin access: Required to install and configure modules in Drupal backend
01 About
What does AutoAlt.ai do in Drupal?
AutoAlt.ai automatically generates descriptive and SEO-friendly alt text for images across your Drupal website. It integrates seamlessly with Drupal media fields and content types, ensuring that images used in Articles, Basic Pages, Blogs, and custom content types are always accessible and optimized. This helps improve website accessibility, search engine rankings, and overall content quality without manual effort.
Video Tutorials
Learn how AutoAlt.ai works in Drupal with step-by-step video tutorials and module demonstrations. Our guides walk you through installation, configuration, bulk alt text generation, and best practices to maximize performance and efficiency.
Need Support?
Have questions or need assistance? Visit our Support Page to explore FAQs, documentation, and helpful resources. You can also contact our support team for personalized guidance and technical help with your Drupal module setup.
02 Module Installation
Drupal
Drupal – AI Powered Image Alt Text Generator automatically generates alt text for images used across your Drupal website. AutoAlt.ai analyzes your media files and content to create accurate, SEO-friendly alt text, improving accessibility and search visibility with minimal manual work.
- Download the AutoAlt.ai module
OR install via Composer:composer require drupal/autoalt - Log in to Drupal Admin.
- Go to Extend
(/admin/modules). - Search for AutoAlt.ai, check the module, and click Install.
- Go to Configuration → Media → AutoAlt.ai Settings.
- Enter your Email Address.
- Click "Send Verification Code", and verify the OTP.
- Done! Your AutoAlt.ai account is automatically created, and the API key is configured.
- When uploading new images, alt text is generated automatically (if enabled).
- You can also manually generate alt text from the Media Library by editing an image and clicking Generate Alt Text.
Screenshot: Screenshot of the Drupal “General Settings – AutoAlt.ai” configuration page showing options to connect an API key or log in/register, with fields for API key and email address and buttons for “Connect & Save” and “Send Verification Code.”
AI Alt Text Generator Dashboard – Bulk Image Alt text Generate with AutoAlt.ai
The AutoAlt.ai dashboard in Drupal allows administrators to generate AI-powered alt text for multiple images at once. It displays total images, available credits, and provides fields for optional SEO and negative keywords to control output quality. Users can skip previously processed images and quickly generate optimized alt text in bulk. This tool improves website accessibility, enhances search engine visibility, and streamlines image SEO management directly from the admin panel.
Screenshot: Screenshot of the Drupal “AI Alt Text Generator for Images – AutoAlt.ai” Bulk Alt Text Generator page showing total images, available credits, optional SEO and negative keyword fields, a skip processed images option, and a “Generate Alt Text” button.
AI Alt Text Generation History – Manage and Update Image Descriptions
The AutoAlt.ai Alt Text Generation History page allows administrators to review, search, and update previously generated image alt texts. Users can filter by language, search by image URL, and edit descriptions directly within the table. Each entry displays the image preview, generated alt text, and language. The update option enables quick corrections or improvements, ensuring accurate accessibility compliance and optimized SEO performance across multilingual website content.
Screenshot: Screenshot of the Drupal “AI Alt Text Generator for Images – AutoAlt.ai” Alt Text Generation History page showing a list of images with generated alt text in different languages, search and filter options, and “Update” buttons for each entry.
When Images are Uploading
Within the extension configuration page, there is an option labeled “Auto-Generate on Image Upload”. When enabled, the extension will automatically generate alt text for newly uploaded images in all configured languages.
Screenshot: Screenshot of a settings page showing image extension options (jpeg, png, gif, webp, svg) with checkboxes including “Automatic set image name when generate alt text,” “Auto-Generate on Image Upload” (highlighted), and “This site is publicly accessible on the internet,” along with a notice about Cloudflare or .htpasswd protected sites.
Auto Image Name Setting
Enable automatic image naming during alt text generation and configure upload behavior, accessibility settings.
Screenshot: Settings page showing the checked option “Automatic set image name when generate alt text” highlighted with a red box.
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: Settings page showing “Filter by Image Extension” with selected formats (jpg, jpeg, png, gif, webp, svg) highlighted in a red box.
Include Prefix & Post Fix for SEO
Add custom prefix or postfix keywords to your generated alt text to improve SEO relevance and branding.
Screenshot: Settings section showing “Prefix for Alt Text” and “Suffix for Alt Text” input fields highlighted in a red box.
FAQ
Does the module support multilingual Drupal websites?
Yes. AutoAlt.ai can generate alt text in different languages.
If your site uses:
- Drupal Language module
- Content Translation
- Media translation
Then alt text can be generated for each translated media item.
Do I need an AutoAlt.ai account to use the module?
Yes. The module requires an AutoAlt.ai account and API key.
You can create a free or paid account at AutoAlt.ai, add your domain, and copy your API key and Insert into the Drupal configuration page.
Is bulk image processing supported?
Yes. You can process hundreds or thousands of images in one go using our bulk update feature. It’s ideal for large media libraries and product catalogs.
Does it work with multiple store languages?
Yes, Alt text is automatically generated in all configured store languages simultaneously.
Can I update both Alt Text and Image Title together?
Yes, you can Just enable the option in the extension configuration settings.
Check the box labeled “Use alternative text as image title” to apply the same text to both fields automatically.
Done!
Your Drupal installation is now successfully connected to AutoAlt.ai. All new images will automatically receive SEO-optimized and WCAG-compliant alt text.
