Recipe Widget Embed Parameter Reference

This page is the exhaustive companion to the parameter table in each platform install guide: every parameter the widget reads, what it does, which script version(s) support it, and its default when omitted. If you just want a working embed for your platform, start with the install guide for your platform instead — come back here when you need the full contract.

Recommended default embed

Unless you have a specific reason to change it, start here: omit rows (infinite scroll reads better for a first install than pagination), and turn on ratings and catfilter so the gallery ships with social proof and a way to narrow a large catalog:

<!-- Crafted Pour SEO script (load first) -->
<script type="text/javascript"
  src="https://plugin.craftedpour.com/v2/scripts/crafted-pour-recipe-plugin-seo.js">
</script>

<!-- Crafted Pour recipe widget — recommended default -->
<script id="crafted-pour-recipe-plugin-script"
  src="https://plugin.craftedpour.com/v2/scripts/crafted-pour-recipe-plugin.js?plugin_id=YOUR_PLUGIN_ID&ratings=true&catfilter=true&primaryColor=B42B30">
</script>

Copy-paste snippets by mode

Gallery mode

A full cocktail gallery — the default rendering when no sku or product restricts it to one bottle. Use this on a dedicated recipes/cocktails page.

<!-- Crafted Pour SEO script (load first) -->
<script type="text/javascript"
  src="https://plugin.craftedpour.com/v2/scripts/crafted-pour-recipe-plugin-seo.js">
</script>

<!-- Crafted Pour recipe widget — recommended default -->
<script id="crafted-pour-recipe-plugin-script"
  src="https://plugin.craftedpour.com/v2/scripts/crafted-pour-recipe-plugin.js?plugin_id=YOUR_PLUGIN_ID&ratings=true&catfilter=true&primaryColor=B42B30">
</script>

Product-page mode (via sku)

On an ecommerce product template, template the sku value (UPC preferred) so one snippet covers your whole catalog. Pair with rows=1 for a single swipeable row and ratings=true for that bottle’s community reviews:

<!-- Crafted Pour recipe widget — product page mode -->
<script id="crafted-pour-recipe-plugin-script"
  src="https://plugin.craftedpour.com/v2/scripts/crafted-pour-recipe-plugin.js?plugin_id=YOUR_PLUGIN_ID&rows=1&ratings=true&sku=YOUR_PRODUCT_UPC_OR_SKU&primaryColor=B42B30">
</script>

Ratings-only mode

The same script also runs as a standalone reviews widget — no recipe grid at all:

<!-- Crafted Pour recipe widget — ratings-only, no recipe grid -->
<script id="crafted-pour-recipe-plugin-script"
  src="https://plugin.craftedpour.com/v2/scripts/crafted-pour-recipe-plugin.js?plugin_id=YOUR_PLUGIN_ID&ratings=true&recipes=false&primaryColor=B42B30">
</script>

Recipe deep-link (informational)

You do not construct these URLs by hand — the widget appends cp_rid (or, where available, cp_slug) automatically when a shopper clicks into a recipe. Documented here so the pattern is recognizable in your analytics, server logs, or Search Console:

<!-- A recipe card's own outbound link — the widget appends this automatically
     when a shopper clicks a recipe. You do not need to construct this by hand;
     it is documented here so the pattern is recognizable in analytics/logs. -->
https://yourdomain.com/your-recipes-page?cp_rid=RECIPE_ID

<!-- Slug-addressed form, used internally by the recipe-detail view -->
https://yourdomain.com/your-recipes-page?cp_slug=recipe-name-slug

Full parameter reference

All parameters are optional. Chain them with & after the ? in the script src. Color values are 6-digit hex without the # prefix — a # starts a URL fragment, silently truncating everything after it.

Partner-level behavior that is not an embed parameter — editor’s notes, smart product placement (competitor masking), generic-recipe inclusion, and filter style — is configured per brand in the CMS instead. See the Partner Settings guide.

SEO script tag

The recipe gallery and the SEO content are two separate script tags, and the order matters — the SEO script goes first, on the same page, as shown in every snippet above:

<script type="text/javascript"
  src="https://plugin.craftedpour.com/v2/scripts/crafted-pour-recipe-plugin-seo.js">
</script>

It server-renders each recipe’s title, ingredients, instructions, and AI-sommelier editor’s note directly into the page HTML before any JavaScript runs, plus Recipe structured data (JSON-LD) with aggregate star ratings — so crawlers index real content on your domain instead of an empty widget shell, and your pages become eligible for Google’s rich results.

Always close the script tag explicitly — never self-close it. A self-closing <script … /> is invalid HTML5. Browsers recover by treating everything up to the next real </script> (or end of document) as part of the script’s content, which can silently swallow the rest of your page’s <head> — including your title and meta tags. This has broken real partner installs in the past.

<!-- INVALID HTML5 — do not do this -->
<script id="crafted-pour-recipe-plugin-script"
  src="https://plugin.craftedpour.com/v2/scripts/crafted-pour-recipe-plugin.js?plugin_id=YOUR_PLUGIN_ID" />

<!-- Always close with an explicit tag -->
<script id="crafted-pour-recipe-plugin-script"
  src="https://plugin.craftedpour.com/v2/scripts/crafted-pour-recipe-plugin.js?plugin_id=YOUR_PLUGIN_ID">
</script>

How to know it worked

1. The gallery renders. Open the published page — you should see a grid of recipe cards with photos and a “Powered by Crafted Pour” badge. If you enabled featured=true, a FEATURED rail leads the page.
2. Cards open recipe pages on your domain. Click any recipe — the URL should stay on your site and gain ?cp_rid=…, showing the full recipe with your product linked in the ingredients.
3. Your products are shoppable. On a recipe that uses your product, the ingredient should link out with your “shop” call-to-action (competitor names masked if smart product placement is on).
4. SEO content is being served. On a recipe page (with cp_rid in the URL), use View Source and search for recipe-seo-content or the recipe name — it should appear in the raw HTML.
5. No console errors. Open your browser's developer tools (F12) → Console. A healthy install logs Recipe widget loaded with no red errors.

Want the platform-specific walkthroughs (WPCode snippets, Shopify Liquid templates, Squarespace code injection, and more)? See all install guides. Curious what the widget does end to end? See the full feature tour.