Skip to content

BreadcrumbList: Clarify position and how it interacts with itemListOrder #333

@pierrefar

Description

@pierrefar

http://schema.org/BreadcrumbList
http://schema.org/itemListElement

For http://schema.org/BreadcrumbList, the example has an itemListElement with two ListItems. They each have a position but it's not clear what it means.

For example, what do these code examples mean?

The current code example:

{
            "@type": "BreadcrumbList",
            "itemListElement":
            [
                {
                    "@type": "ListItem",
                    "position": 1,
                    "item":
                    {
                        "@id": "https://example.com/dresses",
                        "name": "Dresses"
                    }
                },
                {
                    "@type": "ListItem",
                    "position": 2,
                    "item":
                    {
                        "@id": "https://example.com/dresses/real",
                        "name": "Real Dresses"
                    }
                }
            ]
        }

With an extra hint about the order:

{
            "@type": "BreadcrumbList",
            "itemListOrder": "ItemListOrderDescending",
            "itemListElement":
            [
                {
                    "@type": "ListItem",
                    "position": 1,
                    "item":
                    {
                        "@id": "https://example.com/dresses",
                        "name": "Dresses"
                    }
                },
                {
                    "@type": "ListItem",
                    "position": 2,
                    "item":
                    {
                        "@id": "https://example.com/dresses/real",
                        "name": "Real Dresses"
                    }
                }
            ]
        }

And should the itemListOrder be ItemListOrderDescending (going deeper into the leaf structure of a site) or ItemListOrderAscending (meaning???) for breadcrumbs?

Metadata

Metadata

Assignees

Labels

guidelines docs examplesWork on our supporting materials rather than on schema definitionsschema.org vocabGeneral top level tag for issues on the vocabularystatus:work expectedWe are likely to, or would like to, or probably should try, ... to do something in this area.type:bugA mistake or malfunction whose remedy should be straightforward technical worktype:cleanup + clarityAddresses wording fixes, ambiguities, confusion, bad examples etc

Type

No type

Projects

No projects

Relationships

None yet

Development

No branches or pull requests

Issue actions