Recipe Schema on Shopify: What It Is and How to Validate It
Shopify's blog has no recipe format. Paste a recipe into a post and Google sees a page of text and images. It doesn't know which lines are ingredients, how long the dish takes, how many it serves or what readers thought of it.
Recipe schema fixes that. It's structured data, usually a JSON-LD block, that describes the recipe in a format search engines read. This guide covers what recipe schema is, why Google uses it, how it changes the way your recipes look in search, every property that matters, and how to add and validate it on a Shopify store. If you run a Shopify store, the fastest route is the RecipeKit app, which adds the markup to every recipe for you. For a one-off page on any platform, use the free recipe schema generator.
What is recipe schema?
Recipe schema is Schema.org Recipe markup. Schema.org is a shared vocabulary that Google, Bing and other search engines agreed on so websites can label their content. The Recipe type has fields for the recipe's name, image, ingredients, steps, times, yield, nutrition, ratings and video.
You add it to the page as a small script, usually in JSON-LD format (JavaScript Object Notation for Linked Data). Shoppers never see it. Search engines read it to understand the page as a recipe, rather than guessing from the text. Google recommends JSON-LD as the easiest format to add and maintain.
For the longer explainer on the business case, read why recipe schema matters.
Why does Google use recipe schema?
Google crawls billions of pages. Text alone is ambiguous: "4" could be servings, steps or a date. Structured data removes the guesswork. In Google's own words, it provides "explicit clues about the meaning of a page" and classifies the content, so Google can show it in richer formats.
For recipes, that matters more than most content types because searchers compare recipes on facts: how long it takes, how many it feeds, how many calories, and how well it's rated. When Google can read those facts reliably, it can show them directly in results, filter by them, and send the searcher to the recipe that fits.
Google's guidelines also set the rules: the markup must describe content that is visible on the page, ratings must be real ratings from your visitors, and the page must follow Google's general structured data policies. Break those rules and the page can lose rich result eligibility.
How does recipe schema appear in Google Search?
Valid recipe markup makes a page eligible for several recipe features. Here is how Google itself illustrates them.
Recipe rich results
A standard blue link becomes a recipe card: a thumbnail image, star rating and review count, total time and sometimes calories. On mobile, these often show in a swipeable row of recipes at the top of the results.
Host carousel
If your site has several recipes marked up, and a summary page lists them with ItemList markup, Google can show a carousel of recipes from your site alone.
Google Images recipe badge
In Google Images, marked-up recipes get a "Recipe" badge on the image, and the preview shows the title, rating and time. That turns image traffic into recipe clicks.
Recipe filters and guided recipes
Because Google knows the times, calories and ingredients, it can let searchers filter recipes, for example by cook time. Google's documentation also describes guided recipes on the Google Assistant, which use recipeInstructions as step-by-step HowToStep items, alongside recipeIngredient and totalTime.
AI-powered search features
Google has not published a rule that structured data is required for AI Overviews. What structured data does is make your recipe's facts machine-readable and unambiguous, which is what any search system needs to understand and summarize the page. Treat it as good hygiene, not a ranking trick.
Why is recipe schema important for a Shopify food brand?
- More visible results. A recipe card with an image, stars and time takes more space and attention than a plain link.
- Better-qualified clicks. Searchers see the time and rating before they click, so the visitors you get are the ones who want that recipe.
- Eligibility for recipe-only features. Carousels, image badges and guided recipes aren't available to unmarked pages.
- A path from recipe to product. For a food brand, every recipe visit is a chance to sell the ingredients. Ranking recipes that link to your products is content marketing that pays for itself.
How big a boost does structured data give?
Google doesn't promise a ranking boost from structured data, and no one can tell you your exact uplift. But Google publishes case studies from sites that added it. From Google Search Central's introduction to structured data:
- Food Network converted 80% of its pages to enable search features and saw a 35% increase in visits.
- Nestlé measured that pages showing as rich results had an 82% higher click-through rate than non-rich result pages.
- Rotten Tomatoes added structured data to 100,000 pages and measured a 25% higher click-through rate on enhanced pages.
- Rakuten found users spent 1.5x more time on pages with structured data and had a 3.6x higher interaction rate on pages with search features.
Food Network is the closest match to a recipe site, and its result came from making recipe pages eligible for search features at scale. The lesson for a Shopify brand: mark up every recipe, not just a few.
Which recipe schema properties does Google use?
Google's recipe documentation splits properties into required and recommended. Required fields make a page eligible. Recommended fields make the result richer and more useful, so fill in as many as you can show on the page.
Required properties
| Property | What it holds | Tips |
|---|---|---|
| name | The recipe title | Match the H1 on the page |
| image | One or more image URLs | Crawlable, high resolution; Google recommends 16x9, 4x3 and 1x1 versions |
Recommended properties
| Property | What it holds | Tips |
|---|---|---|
| author | Person or Organization who wrote it | Use a real name and URL |
| datePublished | Publish date | ISO 8601, e.g. 2026-11-02 |
| description | Short summary of the dish | One or two sentences |
| recipeIngredient | List of ingredients | One string per ingredient, with quantity |
| recipeInstructions | The method | An array of HowToStep items, one per step, not one text block |
| prepTime, cookTime, totalTime | Durations | ISO 8601, e.g. PT20M; use totalTime or prep plus cook |
| recipeYield | Servings | e.g. "4" or "4 servings"; needed if you add nutrition per serving |
| nutrition.calories | Calories per serving | e.g. "320 calories" |
| aggregateRating | Average rating and count | Only real ratings that are visible on the page |
| recipeCategory | Meal type | e.g. "Dinner", "Dessert" |
| recipeCuisine | Cuisine | e.g. "Italian" |
| keywords | Extra descriptors | e.g. "weeknight, one-pan"; don't repeat category or cuisine |
| video | VideoObject for a recipe video | Needs name, description, thumbnailUrl, uploadDate |
Need calories? The free recipe nutrition calculator gives a per-serving estimate from USDA data.
A complete JSON-LD example
Here is what a filled-in recipe schema block looks like:
<script type="application/ld+json">
{
"@context": "https://schema.org/",
"@type": "Recipe",
"name": "Chili Garlic Noodles",
"image": [
"https://example.com/photos/1x1/noodles.jpg",
"https://example.com/photos/4x3/noodles.jpg",
"https://example.com/photos/16x9/noodles.jpg"
],
"author": { "@type": "Person", "name": "Sam Lee" },
"datePublished": "2026-11-02",
"description": "Quick noodles tossed in chili crisp, garlic and soy.",
"prepTime": "PT5M",
"cookTime": "PT10M",
"totalTime": "PT15M",
"recipeYield": "2",
"recipeCategory": "Dinner",
"recipeCuisine": "Asian",
"keywords": "quick, weeknight, spicy",
"nutrition": { "@type": "NutritionInformation", "calories": "520 calories" },
"recipeIngredient": [
"200 g wheat noodles",
"2 tbsp chili crisp",
"3 cloves garlic, minced",
"1 tbsp soy sauce"
],
"recipeInstructions": [
{ "@type": "HowToStep", "text": "Cook the noodles and drain." },
{ "@type": "HowToStep", "text": "Fry the garlic in oil for 30 seconds." },
{ "@type": "HowToStep", "text": "Toss noodles with garlic, chili crisp and soy." }
],
"aggregateRating": { "@type": "AggregateRating", "ratingValue": "4.8", "ratingCount": "37" }
}
</script>
Only include aggregateRating if those ratings are collected from real visitors and shown on the page.
How do you add recipe schema to Shopify?
Shopify themes output Article markup on blog posts, but no Recipe markup. You have two options.
Option 1: RecipeKit app (recommended for Shopify stores)
RecipeKit is a Shopify app built for food brands that publish recipes. Instead of hand-writing JSON-LD, you enter the recipe once and RecipeKit:
- Publishes a styled recipe card on your store, with ingredients, steps, times and servings.
- Generates Recipe schema JSON-LD automatically from the same data, so the markup always matches the visible recipe.
- Links ingredients to your Shopify products, with add-to-cart buttons so readers can buy what the recipe needs.
- Keeps the schema in sync: change a quantity or a time, and the card and the markup update together.
That removes the most common schema problems on Shopify: duplicate blocks, markup that drifts out of date, and fields that don't match the page. See how it works on recipe SEO for Shopify and shoppable recipes.
Option 2: The free generator (any platform, one page at a time)
Our free recipe schema generator is open to everyone, on any platform. It's ideal for a single recipe or for testing:
- Fill in the recipe: name, description, image URL, times, servings, ingredients and steps.
- Copy the JSON-LD code.
- Paste it on the same page as the recipe: in a Custom Liquid block, an HTML block or the theme code.
- Keep one Recipe block per page. If an app or theme already outputs one, don't add a second.
The catch: hand-pasted code doesn't update when you edit the recipe. If you publish recipes regularly on Shopify, the app saves time and avoids mismatches.
How do you validate recipe schema?
Check every recipe after you publish it, and again after theme or app changes.
- Google's Rich Results Test tells you whether the page is eligible for recipe rich results and lists errors and warnings. Errors block eligibility. Warnings mean a recommended field is missing.
- Schema Markup Validator checks the markup against the full Schema.org vocabulary, including properties Google doesn't use.
- Google Search Console shows a Recipes report under Enhancements once Google has crawled marked-up pages. It lists valid items and errors across the whole site, so you can fix problems in bulk.
- The free recipe SEO audit grades the fields Google uses, checks that the markup matches the visible recipe and looks for product-link opportunities. Enter the recipe URL and click Run audit.
Common recipe schema errors on Shopify
- Missing image or name. The two required fields. Without them the page isn't eligible.
- Instructions as one block. Put each step in its own HowToStep.
- Wrong time format. "20 minutes" fails; use PT20M.
- Two Recipe blocks on one page. Often a theme snippet plus pasted code, or two apps. Keep one.
- Ratings that aren't on the page. Google treats this as a policy issue.
- Markup that doesn't match the page. You edited the recipe but not the JSON-LD.
- Images Google can't crawl. Blocked or tiny images won't show in results.
Valid markup but still no rich results? Read why recipe rich results aren't showing.
Checklist: recipe schema on a Shopify store
- One Recipe block per page
- name and image filled in
- Ingredients one per line, steps as separate HowToSteps
- Times in ISO 8601
- Yield and calories per serving
- Ratings in the markup only if they show on the page
- Markup matches the visible recipe
- Passes the Rich Results Test and the recipe SEO audit
- Recipes report in Search Console shows no errors
Recipe schema on every recipe, without the copy and paste
The free generator is for everyone and works for one page at a time. If you run a Shopify store and publish recipes regularly, use RecipeKit: it adds recipe cards with structured data to every recipe, links ingredients to your products with add-to-cart buttons, and keeps the card and the schema in sync.
Get RecipeKit on the Shopify App Store →
Or generate recipe schema free →
Common questions
Does Shopify add recipe schema automatically?
Not for blog posts. Shopify themes output Article markup on posts, but not Recipe markup. An app like RecipeKit adds it for you.
Where do I paste recipe schema on Shopify?
On the same page as the recipe, in a Custom Liquid block, an HTML block or the theme code. With RecipeKit, you don't paste anything.
Does recipe schema guarantee rich results?
No. It makes the page eligible. Google decides whether to show them based on quality and policy.
Does recipe schema improve rankings?
Google doesn't treat it as a direct ranking boost. The gain comes from richer results that earn more clicks, as in Google's published case studies.
Which recipe schema fields are required?
Google requires name and image. Ingredients, instructions, times, yield, nutrition, author and ratings are recommended.
Should I use the free generator or the RecipeKit app?
Use the free generator for a single page or any non-Shopify site. On Shopify, use RecipeKit so every recipe gets schema automatically and stays in sync.
How do I check my recipe schema?
Run the Rich Results Test, then the free recipe SEO audit, and watch the Recipes report in Search Console.
