Cookies & analytics

    We use cookies for analytics and to serve ads. Accept to enable Google Analytics and AdSense. You can decline to stay opt-out.

    SwiftSchema Logo

    SwiftSchema

    Intuitive Schema Generation at Your Fingertips

    AboutLearnContact
      Stack

      Directory / Listings Stack

      Directory pages listing local businesses with ItemList, FAQ, and breadcrumb context.

      Open generatorValidate in Rich Results Test

      When to use this stack

      • City/vertical directories listing multiple businesses or partners
      • Franchise or partner lists needing structured listings
      • Pages where FAQs clarify selection, coverage, and booking

      What's included

      • Structures the directory list with order and IDs.

      • Local Business
        Open generator

        Representative business entries for the directory.

      • Frequently Asked Questions
        Open generator

        Answers how listings are selected, how to contact, and coverage.

      • Breadcrumb
        Open generator

        Provides navigation context.

      Required properties (stack union)

      Ensure every applicable required property is present in your implementation. Nested props reference their parent objects (for example, `offers.priceCurrency`).

      address.addressCountry
      address.addressLocality
      address.addressRegion
      address.streetAddress
      itemListElement[].item.@id
      itemListElement[].name
      itemListElement[].position
      mainEntity[].@type=Question
      mainEntity[].acceptedAnswer.text
      name
      telephone
      url

      Recommended properties (stack union)

      image
      itemListElement[].item
      itemListElement[].name
      itemListOrder
      mainEntity[].acceptedAnswer.text
      mainEntity[].author.name
      mainEntity[].name
      numberOfItems
      openingHours
      priceRange

      Combined JSON-LD

      Paste as a single script tag. Keep product details, offer data, shipping/returns, and FAQ answers in sync with the page.

      Validate
      [
        {
          "@context": "https://schema.org",
          "@type": "ItemList",
          "@id": "https://www.example.com/directory/austin-plumbers#list",
          "itemListOrder": "https://schema.org/ItemListOrderAscending",
          "numberOfItems": 2,
          "itemListElement": [
            { "@type": "ListItem", "position": 1, "name": "RapidRooter Plumbing", "item": { "@id": "https://www.example.com/partners/rapidrooter#business" }, "url": "https://www.example.com/partners/rapidrooter" },
            { "@type": "ListItem", "position": 2, "name": "BlueSky Plumbing", "item": { "@id": "https://www.example.com/partners/bluesky#business" }, "url": "https://www.example.com/partners/bluesky" }
          ]
        },
        {
          "@context": "https://schema.org",
          "@type": "LocalBusiness",
          "@id": "https://www.example.com/partners/rapidrooter#business",
          "name": "RapidRooter Plumbing",
          "url": "https://www.example.com/partners/rapidrooter",
          "telephone": "+1-512-555-1212",
          "address": { "@type": "PostalAddress", "streetAddress": "123 Main St", "addressLocality": "Austin", "addressRegion": "TX", "postalCode": "78701", "addressCountry": "US" },
          "openingHours": "Mo-Su 07:00-19:00",
          "priceRange": "$$"
        },
        {
          "@context": "https://schema.org",
          "@type": "FAQPage",
          "mainEntity": [
            { "@type": "Question", "name": "How do you vet partners?", "acceptedAnswer": { "@type": "Answer", "text": "We verify licensing, insurance, and review history before listing." } },
            { "@type": "Question", "name": "Do you cover the entire metro?", "acceptedAnswer": { "@type": "Answer", "text": "Yes, all Austin ZIP codes. Check each partner page for service areas." } }
          ]
        },
        {
          "@context": "https://schema.org",
          "@type": "BreadcrumbList",
          "itemListElement": [
            { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://www.example.com" },
            { "@type": "ListItem", "position": 2, "name": "Directory", "item": "https://www.example.com/directory" },
            { "@type": "ListItem", "position": 3, "name": "Austin Plumbers", "item": "https://www.example.com/directory/austin-plumbers" }
          ]
        }
      ]

      Implementation steps

      1. Start from your live product detail page content; ensure titles, prices, and availability match the page.
      2. Embed one JSON-LD script in the head or just before the closing body tag using the combined example as a template.
      3. Fill shipping details for each region you serve and keep them aligned with on-page shipping tables.
      4. Attach your canonical MerchantReturnPolicy URL and keep the policy text in sync with Merchant Center.
      5. Add 3–6 FAQs that address purchase blockers (shipping, returns, compatibility) and keep answers consistent with visible content.
      6. Validate in the Rich Results Test and revalidate after price/availability/policy changes.

      Common errors and fixes

      FAQs

      Can I list multiple LocalBusiness objects?

      Yes. Include each business you show on the page with unique @id/URL.

      Do I need reviews?

      Optional. Link to review content on each business page if present; keep directory focused on listings.

      References