Why can't I type the position numbers myself?

Position has to exactly match each item's order in the trail (1, 2, 3, ...) with no gaps, and letting it be typed manually is exactly how a breadcrumb schema ends up with a duplicate or skipped position after someone reorders items without updating the numbers. This tool derives position automatically from array order, so reordering, adding, or removing an item always keeps the numbering correct.

Does the last breadcrumb (the current page) need a URL?

Google's guidelines say the last item's item (URL) property is optional, since it represents the current page you're already on, but including it is harmless and this tool requires it for every row for consistency and validator-friendliness, since Google's structured data testing tools sometimes flag it as a warning either way.

Should the breadcrumb trail in the schema match what's visible on the page?

Yes - this is one of Google's explicit structured data policies for BreadcrumbList: the marked-up trail should reflect the same navigational path shown visually on the page, not a different or more optimistic hierarchy invented purely for search results.

Can I use this for a single-level page with no real breadcrumb trail?

You can technically generate a one-item list, but BreadcrumbList is meant to represent a hierarchy - if a page genuinely has no parent categories, it typically doesn't need breadcrumb schema at all, since there's nothing hierarchical to communicate.

Breadcrumb Schema Generator - BreadcrumbList JSON-LD

Overview

Introduction

BreadcrumbList schema is what lets Google replace a raw URL in search results with a readable trail like Home > Shoes > Trail Running, matching the visible breadcrumb navigation most category and product pages already have. The tricky part of writing it by hand is that every item needs an exact 1-indexed position, and it's easy for those numbers to drift out of sync after reordering items.

This generator sidesteps that entirely: add breadcrumb items in the order they appear on the page, and position is derived automatically from that order, so there's never a manual number to get wrong.

What Is Breadcrumb Schema Generator?

A form-driven generator for BreadcrumbList JSON-LD, built from a dynamic, ordered add/remove list of name/URL pairs representing a page's navigational trail.

The output's itemListElement array mirrors the order items appear in the form, with position auto-assigned 1, 2, 3, and so on based on that order.

How Breadcrumb Schema Generator Works

Each row in the list becomes one ListItem entry: the name field maps to the item's name, and the URL field maps to its item property.

Position is never stored as form state - it's computed at generation time directly from each item's index in the array, so adding, removing, or reordering rows always produces correctly sequential positions.

When To Use Breadcrumb Schema Generator

Any page with a visible breadcrumb trail (category pages, product pages, deeply nested documentation) that doesn't yet have matching structured data.

Rebuilding breadcrumb schema after a site's navigation hierarchy changes, since the auto-derived positions make reordering safe.

Often used alongside Structured Data Validator, Organization Schema Generator and FAQ Schema Generator.

Features

Advantages

Eliminates manually-typed position numbers entirely, removing the most common source of BreadcrumbList errors (duplicate or skipped positions).
Reordering items in the list automatically renumbers every position correctly, with no separate step required.
Produces the minimal valid ListItem shape (position, name, item) without extra unused properties.

Limitations

Doesn't verify the URLs entered actually exist or resolve to the intended pages.
Doesn't check that the trail matches the page's actual visible breadcrumb navigation - keeping them in sync is a manual responsibility per Google's structured data policies.

Examples

A three-level breadcrumb trail

Input

1. Home -> https://example.com
2. Shoes -> https://example.com/shoes
3. Trail Running -> https://example.com/shoes/trail-running

Output

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Home",
      "item": "https://example.com"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Shoes",
      "item": "https://example.com/shoes"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "Trail Running",
      "item": "https://example.com/shoes/trail-running"
    }
  ]
}
</script>

Position 1, 2, 3 is assigned automatically based on each item's order in the list, not typed in by hand.

Best Practices & Notes

Best Practices

Keep the trail identical to the page's visible breadcrumb navigation, in the same order, per Google's structured data guidelines.
Include a Home or top-level entry as the first item, matching standard breadcrumb convention.
Regenerate the schema whenever a page moves to a different category or the site's navigation hierarchy is restructured.
Use absolute URLs (including https://) for every item property, not relative paths.

Developer Notes

Position is deliberately computed from array index at generation time (index + 1) rather than stored as editable form state, which is the entire reason this tool exists instead of just being a slightly more convenient JSON editor - it structurally prevents the duplicate/skipped-position bug that's common in hand-written BreadcrumbList markup.

Breadcrumb Schema Generator Use Cases

Adding breadcrumb structured data to an ecommerce category or product page
Marking up a deeply nested documentation site's navigational hierarchy
Regenerating breadcrumb schema after a site's category structure changes

Common Mistakes

Typing position numbers by hand in raw JSON-LD and having them fall out of sync after later reordering items.
Using a breadcrumb trail in the schema that doesn't match what's actually shown in the page's visible navigation.

Tips

If a page's breadcrumb trail changes, just reorder or edit rows in the list rather than rebuilding the schema from scratch - positions stay correct automatically.
Run the output through the Structured Data Validator tool afterward to confirm every item has position, name, and item present.

Breadcrumb Schema Generator