<article>: The Article Contents element
The <article> HTML 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, a product card, a user-submitted comment, an interactive widget or gadget, or any other independent item of content.
A given document can have multiple articles in it; for example, on a blog that shows the text of each article one after another as the reader scrolls, each post would be contained in an <article> element, possibly with one or more <section>s within.
| 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. |
| Implicit ARIA role | article |
| Permitted ARIA roles | application, document, feed, main, none, 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 HTML5 standard.
Examples
<article class="film_review"> <h2>Jurassic Park</h2> <section class="main_review"> <h3>Review</h3> <p>Dinos were great!</p> </section> <section class="user_reviews"> <h3>User reviews</h3> <article class="user_review"> <h4>Too scary!</h4> <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"> <h4>Love the dinos!</h4> <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 |
|---|
| HTML Standard (HTML) # the-article-element |
Browser compatibility
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
article |
5 |
12 |
4 |
9 |
11.1 |
5 |
Yes |
Yes |
4 |
11.1 |
4.2 |
Yes |
See also
- Other section-related elements:
<body>,<nav>,<section>,<aside>,<h1>,<h2>,<h3>,<h4>,<h5>,<h6>,<hgroup>,<header>,<footer>,<address> - Using HTML sections and outlines
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/HTML/Element/article