--- url: 'https://metadrop.net/en/articles/fixing-missing-image-alt-attributes-in-drupal-without-development' title: 'Fixing missing image alt attributes in Drupal without development' author: 'Alejandro Cabarcos' date: '2026-08-25T06:16:07+00:00' updated: '2026-09-02T10:55:10+00:00' type: article summary: 'Missing or incorrect image alt attributes damage both accessibility and SEO. They surface at scale after content migrations, and also in day-to-day content operations, when the alt field is optional, whether by misconfiguration or by explicit client request, or when an image should be decorative and carry no alt text. Image Alt Fallback is a Drupal contrib module that automatically fills missing alt attributes based on configurable rules, entity label or decorative, per content type and field, with no development work required. This article covers why the problem matters for WCAG compliance and SEO, when to reach for the module, and the configuration details needed to set it up.' tags: - 'Drupal Planet' - Accessibility - SEO/GEO/AEO - Contribution image: 'https://metadrop.net/sites/default/files/styles/full/public/2026-08/image-alt-fallback-config-form.png.webp?itok=X6Dv3_CX' files: - 'https://metadrop.net/sites/default/files/2026-08/2026-image-alt-fallback.pdf' published: true og: determiner: Automatic site_name: Metadrop 'image:url': 'https://metadrop.net/sites/default/files/styles/full/public/2026-08/image-alt-fallback-config-form.png.webp?itok=X6Dv3_CX' 'image:type': image/png 'image:width': '1251' 'image:height': '740' 'image:alt': 'Fixing missing image alt attributes in Drupal without development' street_address: 'Calle Manuel Luna, 12, 3 Dcha' locality: Madrid region: Madrid postal_code: '28020' country_name: España email: hola@metadrop.net phone_number: '910053180' schema: '@context': 'https://schema.org' '@graph': - '@type': Article '@id': 'https://metadrop.net/en/articles/fixing-missing-image-alt-attributes-in-drupal-without-development#article' name: 'Fixing missing image alt attributes in Drupal without development' headline: 'Fixing missing image alt attributes in Drupal without development' description: |- Missing or incorrect image alt attributes damage both accessibility and SEO. They surface at scale after content migrations, and also in day-to-day content operations, when the alt field is optional, whether by misconfiguration or by explicit client request, or when an image should be decorative and carry no alt text.   Image Alt Fallback is a Drupal contrib module that automatically fills missing alt attributes based on configurable rules, entity label or decorative, per content type and field, with no development work required. This article covers why the problem matters for WCAG compliance and SEO, when to reach for the module, and the configuration details needed to set it up. about: - Accessibility - SEO/GEO/AEO - Contribution image: '@type': ImageObject url: 'https://metadrop.net/sites/default/files/styles/full/public/2026-08/image-alt-fallback-config-form.png.webp?itok=X6Dv3_CX' width: '1251' height: '740' datePublished: '2026-09-02T00:53:07+0200' dateModified: '2026-09-02T12:55:10+0200' author: '@type': Person name: 'Alejandro Cabarcos' publisher: '@type': Organization '@id': 'https://metadrop.net/#organization' mainEntityOfPage: 'https://metadrop.net/en/articles/fixing-missing-image-alt-attributes-in-drupal-without-development' - '@type': Organization '@id': 'https://metadrop.net/#organization' url: 'https://metadrop.net/' name: Metadrop sameAs: - 'https://www.drupal.org/metadrop' - 'https://twitter.com/metadrop' - 'https://asociaciondrupal.es/partner/metadrop' - 'https://www.linkedin.com/company/metadrop' logo: '@type': ImageObject url: 'https://metadrop.net/themes/custom/mdrop_radix/logo-metadrop-500-500.jpg' width: '500' height: '500' - '@type': ItemPage '@id': 'https://metadrop.net/en/articles/fixing-missing-image-alt-attributes-in-drupal-without-development' breadcrumb: '@type': BreadcrumbList itemListElement: - '@type': ListItem position: 1 name: Home item: 'https://metadrop.net/en' - '@type': ListItem position: 2 name: 'Expert Drupal & Tech Articles' item: 'https://metadrop.net/en/articles' publisher: '@type': Organization '@id': 'https://metadrop.net/#organization' --- 1. [Articles](https://metadrop.net/en/articles) # Fixing missing image alt attributes in Drupal without development Wednesday, September 02, 2026 Missing or incorrect image alt attributes damage both accessibility and SEO. They surface at scale after content migrations, and also in day-to-day content operations, when the alt field is optional, whether by misconfiguration or by explicit client request, or when an image should be decorative and carry no alt text. Image Alt Fallback is a Drupal contrib module that automatically fills missing alt attributes based on configurable rules, entity label or decorative, per content type and field, with no development work required. This article covers why the problem matters for WCAG compliance and SEO, when to reach for the module, and the configuration details needed to set it up. ## Missing image alt attributes cost accessibility and SEO points Empty alt attributes are an **accessibility and SEO killer**, and the cost is measurable. Google Lighthouse flags the error on both of its audits: up to 6 points subtracted from the Accessibility score and 8 points from the SEO score. The impact on real users is worse than the score. A screen reader completely ignores an image with no alt text, so blind users never know the image was there, which makes the experience disruptive and confusing. It also violates WCAG Success Criterion 1.1.1: Non-text Content, the baseline requirement for accessible non-text content. That is why we had to act when a migration project resulted in thousands of images without an `alt` attribute. ## A Drupal migration left 12,000 images without proper alt text A Drupal 9 to Drupal 11 migration for a multilingual sports news project surfaced around 12,000 images with missing or incorrect alt attributes, found via Screaming Frog tool. Some images had no alt attribute at all, while others had alt text in the wrong language, with English alt text appearing on the /es version of the site. The obvious next step was to look for a pattern. Was the issue tied to a specific content type, such as Articles? Was the wrong-language text caused by untranslated Media content? Answering these questions turned out to be surprisingly hard: Drupal provides no default mechanism, no view and no report, to identify images with problematic alt attributes. The root cause was at the migration source. On the Drupal 9 site, some images never had an alt attribute to begin with, and the migration carried that gap straight into the new architecture. Here is where Image Alt Fallback kicks in. ## Image Alt Fallback fills missing alt text automatically, no development required Image Alt Fallback targets only images that have no alt attribute text defined. Existing alt text is never touched. Image Alt Fallback configuration form, showing different options. The starting point is a configurable **Global default behaviour**: set the fallback alt attribute to the parent entity's label, or mark the image as decorative. Per-field configuration sits on top of that default. For example, `field_image` on the **Article** content type can use the parent entity label (in other words, the title from that Article), `field_gallery` can follow the global default, and the `field_image` on the **Fruits & Vegetables** taxonomy vocabulary can be marked decorative. The module currently detects two entity types: Nodes and Taxonomies. Technically, the module acts in a `post_render` callback. There are no database changes and no Twig template changes, just install and configure. The module also ships with a helper view that helps us identify and fix the issue. It lists all media items with filters by alt status (empty or not empty) and by type, so problematic images surface without technical help. Image Alt Fallback helper view, which helps identifying missing alt attributes. ## When to use Image Alt Fallback The ideal long-term solution is to store meaningful alt text directly on the File or Media entity itself. Recent Drupal versions make the alt attribute required by default, but older Drupal versions or other source systems may not enforce this, so migrations can carry the legacy gap into the new site. Gaps also appear outside migrations. The alt field may be configured as optional, sometimes through a configuration mistake, sometimes as an explicit project requirement, so content gets published without alt text over time. In other cases the image is purely decorative, and the correct treatment is to mark it as decorative rather than to force meaningful alt text onto it. **The module should be treated as a safety net, not a permanent solution**. It covers these gaps automatically while the content itself is fixed at the source. ## Conclusion Missing alt attributes carry a real, measurable cost in Accessibility and SEO audits, and they show up at scale in real projects, as the 12,000-image migration case shows. Image Alt Fallback closes that gap automatically, with configurable rules per content type and field, and no development work needed to install or configure it. It earns its place as a safety net for legacy gaps and time constraints, while meaningful alt text stored at the source remains the goal. Visit the module page for installation and configuration details: [https://www.drupal.org/project/image\_alt\_fallback](https://www.drupal.org/project/image_alt_fallback) [ Download 2026-image-alt-fallback.pdf (PDF, 628.26 KB) ](https://metadrop.net/sites/default/files/2026-08/2026-image-alt-fallback.pdf) [Accessibility](https://metadrop.net/en/articles?text=Accessibility) [SEO/GEO/AEO](https://metadrop.net/en/articles?text=SEO/GEO/AEO) [Contribution](https://metadrop.net/en/articles?text=Contribution) - Alejandro Cabarcos Drupal developer Make your website accessible and compliant [Drupal accessibility audit for EAA & WCAG 2.1 compliance](https://metadrop.net/en/services/drupal-audit/accessibility " See Drupal accessibility audit for EAA & WCAG 2.1 compliance") Metadrop's Drupal accessibility audit evaluates your site against WCAG 2.1, EN 301 549 and the EAA, delivering a prioritized, effort-estimated remediation plan plus expert consultancy. See more