Set up Ritual

1. From your Shopify admin, go to Online Store > Themes and add Ritual from the Theme Store. It is added to your theme library unpublished, so your live store is not affected.
2. Choose Customize to open the theme editor.
3. Set your logo, fonts and color schemes under Theme settings (the gear icon), then build your home page with sections.
4. Preview the store on desktop and mobile. When you are ready, choose Publish from the theme library.

Color schemes live under Theme settings > Colors. Every section has a Color scheme setting, so you can alternate light and dark bands down a page without editing any colors. Changing a scheme updates every section that uses it. Ritual ships with these schemes:

Each scheme sets Background, Text, Headings, Signature color, Primary button background, Primary button label, Secondary button label and border, Borders and dividers, Tray surface, Input background and Input text.

Before you edit theme code, duplicate the theme (Actions > Duplicate) and work on the copy. Code changes are not covered by theme updates or support.

Open the theme editor and select the gear icon to find these groups.

• Header: add a Link block for each navigation item (a Label and a Link). Turn Enable search suggestions on or off, set Suggestions per result type, and choose the Customer account menu.
• Footer: add Text blocks, Link list blocks (a heading and a menu) and a Newsletter block with its own Heading. Newsletter signups are saved as customers in your admin with email marketing consent.

Add sections from Add section in the theme editor.

The home page starts with Hero, Content and Featured collection. The product page has Product information, Subscribe & save, Refill reminder and Recently viewed. The cart page has Cart and Gift options.

• Product information blocks: Description, Key ingredients, How to use, Lasts (days) and Custom liquid. Reorder or remove them in the product template.
• Blog and article pages have settings to show the featured image, date, author, tags and excerpt. The collections list page has a heading, intro text, collections per page and product counts.
• Contact form Topics: one topic per line. Leave the box empty to hide the topic dropdown.
• Recently viewed remembers products in the shopper's own browser. Nothing is stored on your store.

Ritual reads product details from metafields in the ritual namespace. Create these definitions under Settings > Custom data > Products, then fill them in on each product. Anything left blank is simply not shown.

Keep the ritual namespace and keys exactly as written. If you use metaobjects for ingredients, give the metaobject a name field and a description field.

Routine builder: add the Routine builder section to any page, or create a page and choose the page.routine-builder template. Add a Routine block for each routine (for example Morning routine, Evening routine and Weekly), give it a Name, and choose its Products in step order. Each routine appears as a tab. Add routine to cart adds every available step in one go.

Subscribe & save: this section lists the subscription options for the selected variant and updates when the shopper changes variant. It uses Shopify selling plans, so install a subscriptions app (such as Shopify Subscriptions) and add at least one selling plan to the product. The section shows nothing on products without one.

Refill reminder: tells shoppers how long the product usually lasts, based on ritual.lasts_days, with a one-tap button (Reorder now by default) to add the current variant to the cart again. It is a one-off reorder, separate from subscriptions, and is hidden on products without a Lasts (days) value.

Customers can also reorder from their account: Shopify customer accounts include a Buy again action on past orders.

Ritual uses a cart page. Quantity changes update the cart without reloading the page.

Gift options add a gift wrap checkbox and a gift note to the cart. In Ritual it is the Gift options section on the cart template.

Settings: Show gift wrap option and Show gift note (both on by default), Heading, Gift note placeholder, and Gift note maximum length (200 characters by default).

Choices are saved as the cart attributes Gift wrap (Yes when ticked) and Gift note. They appear on the order in your admin and on packing slips from apps that print cart attributes. Keep the names exactly as they are so those apps can read them.

Gift wrap is a free option by default. To charge for wrapping, create a gift wrap product and sell it as a separate item.

The free shipping progress bar is set under Theme settings > Cart. It shows on the cart page and tells shoppers how much more they need to spend, then confirms when free shipping is unlocked.

• Turn on Show free shipping progress bar.
• Set the Free shipping threshold in your store's default currency (75 by default). For shoppers paying in another currency it is converted automatically.
• Optionally change the Progress message (use [amount] where the remaining amount should appear) and the Unlocked message. Leave them blank to use the default wording, which is translated.

The bar only displays a message. Free shipping itself comes from your shipping rates or an automatic discount, so set the same threshold under Settings > Shipping and delivery.

Ritual uses Shopify's customer accounts. Sign-in, order history, order status, addresses, profile and the Buy again action are hosted by Shopify, so they keep working through theme updates. The theme has no legacy account templates to set up or maintain.

1. In your Shopify admin, go to Settings > Customer accounts and turn on customer accounts.
2. In the theme editor, select the Header section and choose the Customer account menu. It uses the customer-account-main-menu menu by default; edit it under Content > Menus.
3. The account icon appears in the header on desktop and mobile. Shoppers sign in with a one-time code sent to their email, so there are no passwords to manage.

The account icon only shows while customer accounts are turned on. If it is missing, check Settings > Customer accounts first.

Ritual includes the storefront features every Shopify Theme Store theme provides. They use Shopify's own data and apps, so there is nothing extra to install. Where a feature has options, you find them in the theme editor on the section or block that shows it.

• Product page: the product section is built from blocks. Open the product template in the theme editor to add, reorder or remove blocks such as title, price, variant picker, quantity, buy buttons and description. Buy buttons include dynamic checkout buttons, such as Shop Pay, when they are turned on in your payment settings.
• Filtering and sorting: collection and search pages use Shopify storefront filters. Choose which filters appear, such as availability, price, product type, vendor, variant options or metafields, in the free Shopify Search & Discovery app.
• Product recommendations: related and complementary products come from Shopify's product recommendations. Adjust them per product in the Search & Discovery app.
• Country and language selectors: they appear when your store sells in more than one country or language. Set these up under Settings > Markets and Settings > Languages.
• Newsletter signup: email signups are saved as customers in your admin with email marketing consent, ready for Shopify Email or your email app.
• Follow on Shop: when Shop Pay is turned on, shoppers can follow your store in the Shop app from your storefront. Manage this from the Shop channel in your admin.
• Search suggestions: the header search shows suggestions as shoppers type. Set how many appear for each result type in the Header section.

If your copy of Ritual is missing one of these, check your theme library for an update. Updates add a new copy with your settings carried over, so you can review it before publishing.

Ritual is built to be used with a keyboard and screen readers, and animations stop for visitors who prefer reduced motion. Images load at the size the screen needs, and images below the fold load as the shopper scrolls.

• Add alt text to every product and section image in your admin.
• Keep text and background colors in each color scheme at a contrast ratio of at least 4.5:1.
• Compress large images before uploading. Shopify serves them in modern formats automatically.

2.0.0: first Theme Store version, built on Shopify's Skeleton theme. Ritual preset; key ingredients, skin type, how to use and lasts-about details from metafields; routine builder; subscribe and save; refill reminder; gift options; free shipping progress bar; recently viewed products; predictive search; footer newsletter signup; Shopify customer accounts.

Send a request from the Ritual support page at happifyapps.com/themes/ritual/support. Include your store URL, what you expected and what happened, and a screenshot if you can. You get an email confirmation straight away and a reply within 2 business days.

• Covered: questions about theme settings, sections and blocks; bugs in the theme; installing and updating the theme.
• Not covered: changes to theme code or problems caused by edited code; third-party apps; custom design or new features. For these we recommend hiring a Shopify Partner.