Recipe Roundup Feature
The Recipe Roundup feature lets you display a curated list of recipes on any page of your store. Use it to create "best of" lists, seasonal collections, or featured recipe sections on your home page, blog posts, or custom pages.
How It Works
When enabled:
- You add the Recipe Roundup app block to a page in the theme editor
- A rich text element on the same page contains your list of recipe handles
- The block finds the list, fetches each recipe, and renders them as styled cards with images, descriptions, and links
Adding Recipe Roundup to a Page
Step 1: Add the App Block
- Open your Shopify theme editor (Online Store > Customize)
- Navigate to the page where you want the roundup (home page, blog post, custom page, etc.)
- Click Add block or Add section
- Select Recipe Roundup from the app blocks
Step 2: Add a Rich Text Element
The roundup block reads recipe handles from a rich text element on the same page.
- Add a Rich Text section or block to the same page
- In the rich text content, type your recipe list using this syntax:
recipe-list: - my-first-recipe-handle - my-second-recipe-handle - another-recipe-handle
Important: Use Shift+Enter (soft line break) between each line, not regular Enter. Regular Enter creates separate paragraphs and the block won't detect the list.
For a numbered list, add numbered before the colon:
recipe-list numbered: - my-first-recipe-handle - my-second-recipe-handle - another-recipe-handle
Finding Recipe Handles
A recipe handle is the URL-friendly version of the recipe title. To find a recipe's handle:
- Open the recipe's blog post in your Shopify admin
- Look at the URL — the handle is the last part (e.g.,
blogs/recipes/chocolate-chip-cookieshas the handlechocolate-chip-cookies)
Handles are lowercase with hyphens replacing spaces.
Block Settings
Button Colour
Customize the color of the "View Recipe" button on each recipe card. The text color automatically adjusts for contrast (white text on dark buttons, black text on light buttons).
Customization
Custom Styling
Use custom CSS to adjust the roundup appearance:
/* Card layout */
.rk-recipe-card {
gap: 1.5rem;
}