Skip to content

Require a Description (alt text) when uploading images #1300

Description

@brylie

Templates use Wagtail's image Description field as alt text, falling back to the title. Editors can still save an image with no description, which leaves screen-reader users with a filename-like alt text (WCAG 1.1.1). Make the Description required when an image is uploaded or edited.

Grounding: docs/accessibility-audit-2026-09.md, "Remaining recommendations (not fixed in code)", item 3

Acceptance criteria:

  • The image upload and edit forms require a Description (a custom image form, or Wagtail's WAGTAILIMAGES_IMAGE_FORM_BASE setting)
  • Help text tells editors to describe what the image shows
  • Existing images without a Description are unaffected, or a management command lists them
  • Tests cover the form validation

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    UX ReviewEnsure features work correctly and have good UXenhancementNew feature or requestgood first issueGood for newcomershacktoberfestIssues selected for Hacktoberfesthelp wantedExtra attention is needed

    Type

    No type

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions