Skip to content

Add application/recipe intent type (create, edit) - #49

Open
patrickbolle wants to merge 1 commit into
Shopify:mainfrom
patrickbolle:add-application-recipe
Open

patrickbolle wants to merge 1 commit into
Shopify:mainfrom
patrickbolle:add-application-recipe

Conversation

@patrickbolle

Copy link
Copy Markdown

Summary

Adds types/application-recipe.md: a new application/recipe type with create and edit, for app-owned recipes (ingredients and steps a food or drink brand publishes on its store, often with its own products linked to the ingredients).

RFC: #38

Why

  • Recipes are the main content for many Shopify food and drink brands. Merchants describe the work in one sentence: "write a recipe for our new chili crisp and link the jar", "turn this PDF into a recipe", "change the servings on the banana bread to 8".
  • Sidekick can already find recipes through a data extension, but it has no action to hand off to. Merchants leave Sidekick and do the work by hand.
  • No existing type fits. Shopify has no recipe object, there is no shopify/article intent, and application/faq or a page type would flatten ingredients, steps and product links.
  • Who registers: recipe card and recipe blog apps, meal-kit and subscription-box apps that attach recipes to products, and content apps for food, drink and supplement brands.

Schema

  • Canonical schema follows application/quote and application/optimization-plan: only id, additionalProperties: true. Draft included inline in the file.
  • Fields proposed for promotion, snake_case like the neighbouring types, mapped one-to-one to schema.org/Recipe: title, description, ingredients ({text, product_id}), instructions, servings, prep_time, cook_time, image, category, cuisine, tags, source_url. product_id on an ingredient is what makes a recipe shoppable, so it is the first candidate to standardize.
  • The inputSchema example declares no required, at any depth.

Open questions from the RFC, answered in the file

The RFC asked about delete, app settings and bulk create. Following the precedent in application/quote, the file treats delete, duplicate and publish as tools registered from the editor route with shopify.tools.register, and card or theme settings as out of scope for a recipe intent. Bulk create (for example a whole PDF cookbook) is still open: we would use create+bulk if it comes to application/* types.

What we bring

Recipe Kit (on the App Store since 2020) will register create (/recipe/create) and edit (/recipe/{id}) on admin.app.intent.link. Our data extension already returns resource links with mimeType: "application/recipe" and uri: "gid://application/recipe/<id>", so search results become actionable as soon as the type ships.

🤖 Generated with Claude Code

RFC: Shopify#38

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@patrickbolle

Copy link
Copy Markdown
Author

I have signed the CLA.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant