Writing & StyleStyle guide

Writing Accessible Feed Descriptions

Writing Accessible Feed Descriptions records a distinct W3C-supported interface-content task while keeping implementation mechanics outside the writing guidance.

Quick answer

When a feed article uses an accessible description, make that description point to the primary content that helps users decide whether to read further.

Key details

Core IssueW3C APG strongly recommends that each feed article may use aria-describedby to reference one or more elements containing the article’s primary content.
Registerweb accessibility and interface content

Important caveats

Scope Boundary

This page covers feed-article descriptions; naming the feed container and distinguishing individual article labels are separate tasks.

Further guidance

Content

Use the description to expose the article’s primary content or summary rather than repeating its distinguishing label.

Purpose

Clear wording helps assistive-technology users understand the component or content in context without relying on implementation details.

Sources and evidence

Sources are shown with the role they play in this guide. Historical or style-sensitive claims are kept within the evidence boundary described above.

  1. Feed Pattern — WAI-ARIA Authoring Practices Guide (opens in a new tab)World Wide Web Consortium (W3C) · W3C APG guidance for accessible naming of a feed and distinguishing accessible labels for the articles within it.

Explore the topic