Article

Use this type to declare an overview of a news article or other similar publication.

Article highlights in Inbox
Article highlights in Inbox

Use cases

The following use cases show common examples of how the Article schema is used. Use these examples to ensure that your markup is properly structured.

Basic article with image

To send out an email containing a single article, include the following markup:

JSON-LD

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "Article",
  "name": "NASA's Messenger mission set to end, will crash into Mercury's surface",
  "url": "http://www.theglobeandmail.com/technology/science/nasas-messenger-mission-set-to-end-will-crash-into-mercurys-surface/article24177993",
  "description": "A spacecraft that transformed scientists' understanding of Mercury, the solar system's innermost planet, is set to end its mission Thursday by crashing into the world it revealed so vividly.",
  "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSZaF7jC1fJWkbseX9aCPsu8ZMjFMtUmiY6AtONEfxNxnDt7NYUC4d1pNd3Lw_VqMYINlzY4iQ",
  "publisher": {
    "@type": "Organization",
    "name": "The Globe and Mail"
  }
}
</script>

Microdata

<div itemscope itemtype="http://schema.org/Article">
  <link itemprop="url" href="http://www.theglobeandmail.com/technology/science/nasas-messenger-mission-set-to-end-will-crash-into-mercurys-surface/article24177993"/>
  <h1 itemprop="name">NASA's Messenger mission set to end, will crash into Mercury's surface</h1>
  <p itemprop="description">
  A spacecraft that transformed scientists' understanding of Mercury, the solar system's innermost planet, is set to end its
  mission Thursday by crashing into the world it revealed so vividly.
  </p>
  <img src="https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSZaF7jC1fJWkbseX9aCPsu8ZMjFMtUmiY6AtONEfxNxnDt7NYUC4d1pNd3Lw_VqMYINlzY4iQ" itemprop="image"/>
  <div itemprop="publisher" itemscope itemtype="http://schema.org/Organization">
    <meta itemprop="name" content="The Globe and Mail"/>
  </div>
</div>

Images must be at least 132x88px with an aspect ratio of 3:2.

Multiple articles

To describe multiple articles included or linked to in an email, use multiple Article items:

JSON-LD

<script type="application/ld+json">
[
{
  "@context": "http://schema.org",
  "@type": "Article",
  "name": "NASA's Messenger mission set to end, will crash into Mercury's surface",
  "url": "http://www.theglobeandmail.com/technology/science/nasas-messenger-mission-set-to-end-will-crash-into-mercurys-surface/article24177993",
  "description": "A spacecraft that transformed scientists' understanding of Mercury, the solar system's innermost planet, is set to end its mission Thursday by crashing into the world it revealed so vividly.",
  "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSZaF7jC1fJWkbseX9aCPsu8ZMjFMtUmiY6AtONEfxNxnDt7NYUC4d1pNd3Lw_VqMYINlzY4iQ",
  "publisher": {
    "@type": "Organization",
    "name": "The Globe and Mail"
  }
},
{
  "@context": "http://schema.org",
  "@type": "Article",
  "name": "NASA's Messenger Probe Comes To Fiery End On Mercury",
  "url": "http://americanlivewire.com/2015-04-29-nasas-messenger-probe-comes-to-fiery-end-on-mercury/",
  "description": "But besides small size and swift speed, little was known about this mysterious planet until (MErcury Surface, Space ENvironment, GEochemistry, and Ranging) spacecraft became the first man-made instrument to orbit Mercury in 2011.",
  "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRaDt8TQrRdsrSt_smjLiXZTIqEHjq0PjjzzuqLMOzPUqFbpeMqHcksY-gVnoc8bPpUSOcCj6aW",
  "publisher": {
    "@type": "Organization",
    "name": "American Live Wire"
  }
}
]
</script>

Microdata

<div>
  <div itemscope itemtype="http://schema.org/Article">
    <link itemprop="url" href="http://www.theglobeandmail.com/technology/science/nasas-messenger-mission-set-to-end-will-crash-into-mercurys-surface/article24177993"/>
    <h1 itemprop="name">NASA's Messenger mission set to end, will crash into Mercury's surface</h1>
    <p itemprop="description">
    A spacecraft that transformed scientists' understanding of Mercury, the solar system's innermost planet, is set to end its
    mission Thursday by crashing into the world it revealed so vividly.
    </p>
    <img src="https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSZaF7jC1fJWkbseX9aCPsu8ZMjFMtUmiY6AtONEfxNxnDt7NYUC4d1pNd3Lw_VqMYINlzY4iQ" itemprop="image"/>
    <div itemprop="publisher" itemscope itemtype="http://schema.org/Organization">
      <meta itemprop="name" content="The Globe and Mail"/>
    </div>
  </div>
  <div itemscope itemtype="http://schema.org/Article">
    <link itemprop="url" href="http://americanlivewire.com/2015-04-29-nasas-messenger-probe-comes-to-fiery-end-on-mercury/"/>
    <h1 itemprop="name">NASA's Messenger Probe Comes To Fiery End On Mercury</h1>
    <p itemprop="description">
    But besides small size and swift speed, little was known about this mysterious planet until (MErcury Surface,
    Space ENvironment, GEochemistry, and Ranging) spacecraft became the first man-made instrument to orbit Mercury in 2011.
    </p>
    <img src="https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRaDt8TQrRdsrSt_smjLiXZTIqEHjq0PjjzzuqLMOzPUqFbpeMqHcksY-gVnoc8bPpUSOcCj6aW" itemprop="image"/>
    <div itemprop="publisher" itemscope itemtype="http://schema.org/Organization">
      <meta itemprop="name" content="American Live Wire"/>
    </div>
  </div>
</div>

Test your markup

You can validate your markup using the Email Markup Tester Tool. Paste in your markup code and click the Validate button to scan the content and receive a report on any errors present.

Specification

See Article for a specification of the properties for this type.

Send feedback about...

Email Markup
Email Markup
Need help? Visit our support page.