I am adding structured data to a new page which could sensibly be defined as either an article (http://schema.org/Article) or an Item List (http://schema.org/ItemList), as it is a news article about a new top 10, where all 10 items exist on their own pages elsewhere on our site.

So this page has a title, author, some unique content, a publish date... but it also has a ranked list of items.

Is there a best practice for use of schema.org structured data that would add weight to going with one or the other? Or could we even use both definitions on the same page to define the list within the article?

  • A big win for what? Who or what are you expecting to consume this data? Jul 10 '17 at 23:37
  • Just looking for best practice. Updated the question with regard to this.
    – petesiss
    Jul 11 '17 at 8:01
  • Best practice for what? There is no point in finding some random schema to apply to your page. You have to know who is going to use it and how they get the data. Jul 11 '17 at 16:51
  • 1
    Haven't you seen Field of Dreams? If you build it, they will come. The OP was very specific that the schema he's considering is NOT random & in fact sounded like a very good match.
    – Wick
    Mar 29 '18 at 17:51

You can use both, if the ItemList is the primary thing the Article is about.

Use the mainEntity property of the Article type to provide the ItemList.

mainEntity is typically used to denote the primary thing a WebPage is about (e.g., probably the Article in your case), but this is not the only way how it can be used (bold emphasis mine):

Indicates the primary entity described in some page or other CreativeWork.

You could use mainEntity for both ways in the same document:

<body vocab="http://schema.org/" typeof="ItemPage">

  <article property="mainEntity" typeof="Article">

    <ul property="mainEntity" typeof="ItemList">



If the ItemList is not the primary thing the Article is about, there doesn’t seem to be a suitable property to link these items. The hasPart property can’t be used, because it expects a CreativeWork as value, but ItemList isn’t one.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.