The HTML <article> element represents a self-contained composition in a document, page, application, or site, which is intended to be independently distributable or reusable (e.g., in syndication). Examples include: a forum post, a magazine or newspaper article, or a blog entry.
| Content categories | Flow content, sectioning content, palpable content. |
|---|---|
| Permitted content | Flow content. |
| Tag omission | None, both the starting and ending tag are mandatory. |
| Permitted parents | Any element that accepts flow content. Note that an <article> element must not be a descendant of an <address> element. |
| Permitted ARIA roles | application, document, feed, main, presentation, region |
| DOM interface | HTMLElement |
Attributes
This element only includes the global attributes.
Usage notes
- Each
<article>should be identified, typically by including a heading (<h1>-<h6>element) as a child of the<article>element. - When an
<article>element is nested, the inner element represents an article related to the outer element. For example, the comments of a blog post can be<article>elements nested in the<article>representing the blog post. - Author information of an
<article>element can be provided through the<address>element, but it doesn't apply to nested<article>elements. - The publication date and time of an
<article>element can be described using thedatetimeattribute of a<time>element. Note that thepubdateattribute of<time>is no longer a part of the W3C HTML 5 standard.
Examples
<article class="film_review">
<header>
<h2>Jurassic Park</h2>
</header>
<section class="main_review">
<p>Dinos were great!</p>
</section>
<section class="user_reviews">
<article class="user_review">
<p>Way too scary for me.</p>
<footer>
<p>
Posted on
<time datetime="2015-05-16 19:00">May 16</time>
by Lisa.
</p>
</footer>
</article>
<article class="user_review">
<p>I agree, dinos are my favorite.</p>
<footer>
<p>
Posted on
<time datetime="2015-05-17 19:00">May 17</time>
by Tom.
</p>
</footer>
</article>
</section>
<footer>
<p>
Posted on
<time datetime="2015-05-15 19:00">May 15</time>
by Staff.
</p>
</footer>
</article>
Specifications
| Specification | Status | Comment |
|---|---|---|
| HTML Living Standard The definition of '<article>' in that specification. |
Living Standard | |
| HTML 5.1 The definition of '<article>' in that specification. |
Recommendation | |
| HTML5 The definition of '<article>' in that specification. |
Recommendation |
Browser compatibility
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
| Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| Basic Support | 5 | (Yes) | 4 | 9 | 11.1 | 4.1 |
| Feature | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
|---|---|---|---|---|---|---|---|
| Basic Support | (Yes) | (Yes) | (Yes) | 4 | 9 | 11 | 4.2 |
See also
Document Tags and Contributors
Tags:
Contributors to this page:
teoli,
SphinxKnight,
sideshowbarker,
erikadoyle,
Sebastianz,
MarkBeleski,
chinaowl,
JanXu,
tomturton,
Jeremie,
cfebs,
SteveFaulkner,
Aslam.Sayyed,
kscarfone,
tregagnon,
Sheppy,
medicdude,
ethertank,
cers,
brunoais,
dhodder,
nyc212,
fscholz,
hobophobe,
McGurk,
jswisher,
Ms2ger
Last updated by:
teoli,