Schema Health Check
Check the structured data on your Shopify storefront's pages from the QueryCatch Shopify app, so they can show rich results in Google.
Schema Health Check Structured data is code in a page, usually written as JSON-LD, that tells Google what the page is: a product with a price, an article with a date, or your business and its details. Google uses it to show rich results, such as prices, ratings and images beside your listing. The Schema Health Check in the QueryCatch Shopify app reads the structured data on your storefront's pages and shows which pages have what they need, which are missing something, and which have none. In the app it's called Schema markup. Choose Schema markup in the app's menu in your Shopify admin, or click Open on the Schema markup tile of the app's dashboard. Running a scan Click Run scan. Once you've scanned, the button reads Re-run scan.. QueryCatch lists your published products, collections, pages and blog posts through Shopify (or from your sitemap if Shopify can't be asked), then reads the structured data on each one. It reads about two pages a second, so your store stays fast for shoppers and doesn't block the scan; a store with a thousand pages takes about ten minutes. While it works, the page shows how many pages it has checked.. When the scan finishes, the results appear and are saved. A scan runs when it's started here, from the app's dashboard or through a connected AI assistant, and QueryCatch also runs one by itself at the start of each month for every store on a plan that includes it, so the page shows your last results until the next scan.. Fix what the results show in your theme, or in the app that adds your structured data, then run the scan again to check. A scan runs on QueryCatch's servers, so it keeps going if you leave the page, close the app or shut your computer. Open the page again at any time to see how far it has got, or the results once it has finished. Pressing Run scan again while it's going won't restart it. In the app, one scan checks H1 headings, orphan pages, broken links and schema together, reading each page once, so starting it here refreshes all four and takes about a quarter of the time four separate scans would. If your store is busy when a scan starts, QueryCatch waits and tries again a few times before giving up. A scan checks up to 5,000 pages; on a larger storefront the page says it has checked the first 5,000. /assets/documentation/schema-health-check/scan-running.webp /assets/documentation/schema-health-check/schema-markup-results.webp Reading the results Each page gets one of four results: Valid: the page has the structured data it should, with its key details filled in.. Issues: the page has structured data, but it's missing a key detail, or a block of it is broken and can't be read.. Missing: the page has no structured data, or not the kind it needs, such as a product page without Product markup.. Not checked: QueryCatch couldn't read the page, so it can't say anything about its structured data. If your store asked QueryCatch to slow down, the issue says so; otherwise it says "Page could not be fetched", for example when the page no longer exists. Run the scan again to check these pages. Your schema health score is the share of the pages QueryCatch checked that are Valid: 31 valid pages out of 44 scores 70. Pages marked Not checked are left out of it, and a note above the table says how many there are. The score also counts towards the SEO Health score on the app's dashboard. Click Valid, Issues or Missing (or Not checked, when a scan has any) to show only those pages, and click it again to show them all. The search box finds pages by their address, or by a type of structured data such as Product. From your second scan on, the page also shows how each count has changed since the scan before. The table lists each page with its type (Product, Collection, Page, Article, Blog or Other; your home page shows as Other), its result, the types of structured data found on it, and what's wrong. View page opens the page on your storefront in a new tab. /assets/documentation/schema-health-check/pages-with-issues.webp What it checks Product pages need Product markup with a name, an image and offers (the price).. Blog articles need Article, BlogPosting or NewsArticle markup with a headline, an image and the date it was published.. Every other page, including your home page, collections and pages, is Valid with any structured data at all, such as Organization, WebSite, BreadcrumbList or CollectionPage.. On any page, a block of JSON-LD that can't be read is flagged as an issue, because Google ignores broken markup. QueryCatch reads the HTML your storefront sends before any JavaScript runs. Structured data that your theme or another app adds later with JavaScript isn't seen, so such a page can show as Missing even though Google finds markup on it. Check it with Google's Rich Results Test before you change anything. Requirements The QueryCatch app, installed from the Shopify App Store. QueryCatch Pro, or the older Essential or Grow plan. A storefront open to the public: QueryCatch can't read the pages of a password-protected storeDocumentation
Everything you need to know about using QueryCatch