Join GitHub today
GitHub is home to over 36 million developers working together to host and review code, manage projects, and build software together.Sign up
Allow or force editors to provide alt text for lead images #2838
When creating or editing a content item with a lead image (such as a News Item or a custom type that uses the lead image behavior), there should be a (new) field for entering alt text. The contents of this field should be put into the alt attribute of the image when the content item is viewed. The image's markup should never include a title attribute. The content item's title is displayed on the page and thus read by screen readers, putting that information in the title attribute of an image would be redundant. Alt text is the proper way to convey the image's meaning to those using screen readers. Note that when displaying the object the Title and Description will show and will be read by screen readers; the alt text should be a non-redundant description of the image itself.
If the accessibility control panel (#2834) is set to force editors to enter alt text for images, then this is a required field.
Field name: Alt Text
Help text: Briefly describe the meaning of the lead image for people using assistive technology like screen readers. Do not duplicate the object's Title or Description fields, since they will also be read by screen readers. Alt text should describe what a sighted user sees when looking at the image. This might include text the image contains, or even a description of an abstract pattern. This field should never be left blank on sites that want to be compliant with accessibility standards.