Ritual Builder setup
Configure the Ritual Builder section for guided kits, add-ons, and package-style product flows.
Ritual Builder is a homepage or landing section that walks shoppers through choosing products or services as a guided kit. It works best when each step maps to a clear collection or product list.
Sales channels > Online Store > Themes > Customize > add Ritual Builder section > configure blocks
Before you start
- Create collections (or products) for each step — for example Prep, Core, Finish.
- Tag or organize inventory so each step has enough in-stock options.
- Decide whether the final CTA adds all selected items to cart or opens booking.
Section setup
- Add Ritual Builder to the template (often homepage or a landing page).
- Set the section heading and intro copy.
- Add a block per step — title, description, and product source (collection or product list).
- Configure the summary / CTA labels and optional booking link.
- Save and preview on mobile — steps should remain readable without horizontal scroll.
Cart and booking
- Retail kits — selected products add to cart together when the shopper confirms.
- Services — prefer booking CTA or Hollow Reserve when products are type:service.
- Mixed kits — keep retail and services on separate steps so the CTA stays unambiguous.
Accessibility
- Step navigation must work with keyboard.
- Selected state needs a visible focus and selected indicator, not color alone.
- Respect Theme settings → Motion; steps must remain usable with animations off.
Troubleshooting
- Empty step — the collection has no published products, or the storefront filter hid them.
- CTA does nothing — confirm cart permissions and that products are available for sale.
- Section too tall on mobile — shorten step descriptions and reduce product cards per step.
Was this page helpful?
Content is maintained by Arcanum Hollow Labs. For internal engineering notes, see the docs/ folder in the monorepo.