Skip to content
Tutorials Center
My learning

Topics

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.

HTML
<article>
  <h2>Ten-minute tomato soup</h2>
  <p>Roast the tomatoes first for a deeper flavor…</p>
</article>

Try it

A post with nested comment articles

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 article role, 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 a datetime attribute.

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.