HTML Reference Β· Sections
The <article> element
Reference for the HTML <article> element: what counts as self-contained content, nesting articles, article vs section, accessibility, examples and details.
The <article> element represents a self-contained composition: content that would still make sense if you lifted it out of the page and published it somewhere else. Blog posts, news stories, product cards, forum posts, user comments and reusable widgets are all good candidates.
<article> <h2>Ten-minute tomato soup</h2> <p>Roast the tomatoes first for a deeper flavorβ¦</p> </article>
Try it
Each comment is an <article> nested inside the post's article. Nested articles are understood to relate to their outer article.
Attributes
This element has no attributes of its own. It accepts the global attributes.
Usage notes
- The syndication test. Ask: "Could this be shown alone, in a feed reader or on another site?" If yes, use
<article>. If it is just one part of a bigger whole, a<section>is probably better. - Give it a heading. An article should usually start with a heading (
<h1>β<h6>) that names it. Choose the level that fits the page's overall heading order. - Header and footer inside. An article can have its own
<header>and<footer>for the title, author, date or tags. These do not become page-wide landmarks. - Not a styling wrapper. If you only need a box for layout, use a
<div>. - Accessibility. Screen readers expose it with the
articlerole, and some let users jump between articles. A list of cards, each an<article>, is easy to browse this way. - Machine-readable dates. Put publication dates in a
<time>element with adatetimeattribute.
Technical summary
| Content categories | Flow content, sectioning content, palpable content |
| Permitted content | Flow content |
| Tag omission | None; both the start and end tags are required |
| Permitted parents | Any element that accepts flow content |
| Implicit ARIA role | article |
| DOM interface | HTMLElement |
| Default display | block |
Browser support
Supported in every browser.
Related
<section>β a thematic part of a larger whole<aside>β tangential content<main>β the page's dominant content<address>β the author's contact details- Lessons: Semantic Elements, Page Layout, Project: Blog Article