Meowhaus Documentation
This comprehensive guide covers everything you need to install, configure, and customize the Meowhaus Shopify theme. Meowhaus is a warm, organic Shopify OS 2.0 theme for cat furniture and pet boutiques, built around a cream and sage base, elegant serif headlines, rounded pill design, circular category medallions, a shop-the-look Lookbook, and five bundled hero photos. No apps are required for any of the features described below. Use the sidebar navigation to jump to a specific section, or scroll through for the complete reference.
Getting Started
System Requirements
Meowhaus requires a Shopify store on any current plan (Basic Shopify, Shopify, Advanced, or Shopify Plus). The theme is built on Online Store 2.0 and requires no additional apps for core functionality.
Installation
After completing your purchase, you will receive a ZIP file named meowhaus-theme-1.0.0.zip. Follow these steps to install it on your Shopify store:
- Log in to your Shopify admin panel at your-store.myshopify.com/admin.
- Navigate to Online Store > Themes in the left sidebar.
- In the Theme library section, click the Add theme button.
- Select Upload ZIP file from the dropdown menu.
- Choose
meowhaus-theme-1.0.0.zipfrom your computer and wait for the upload to complete. This typically takes 15-30 seconds. - Once uploaded, the theme will appear in your theme library. Click Customize to open the visual theme editor, or click Actions > Publish to make it your live theme immediately.
Tip: We strongly recommend customizing the theme on an unpublished version first. Configure your colors, hero banner, and Explore Categories medallions before publishing so your live store never appears in an unfinished state to customers.
Activating Meowhaus
Once you have uploaded and customized the theme to your liking:
- Go to Online Store > Themes in your Shopify admin.
- Find Meowhaus in your theme library.
- Click Actions > Publish.
- Confirm the activation in the dialog. Your previous theme will be moved to the theme library and can be restored at any time.
Theme Settings
Colors
Meowhaus ships with a warm, organic palette built around a cream base. In the Shopify theme editor, navigate to Theme settings > Colors to configure:
- Background — The main cream background used across the storefront.
- Text — The default text color used against the cream background.
- Accent 1 (Sage) — The sage green accent used for buttons, medallions, and highlights.
- Accent 2 (Oak) — The warm oak accent used for secondary buttons and emphasis.
- Accent 3 (Clay) — The clay accent used for badges and tertiary highlights.
- Light text — Text color used on dark or accent-colored surfaces for contrast.
- Dark text — Text color used on light-background surfaces for contrast.
Typography
Navigate to Theme settings > Typography to select fonts. Meowhaus pairs an elegant serif heading font with clean sentence-case body text:
- Heading font — Font picker applied to all headings, section titles, and product names, defaulting to Playfair Display. Choose any font from the Shopify-hosted font library.
- Body font — Font picker applied to paragraphs, descriptions, navigation links, and general UI text.
Layout
Under Theme settings > Layout, you can control the page width and the left rail:
- Page width — Set the maximum content width to suit your storefront.
- Enable left rail — Checkbox that turns the pinned left icon rail on or off globally. This is OFF by default — Meowhaus is designed to look complete without it, so only enable it if you want the extra vertical navigation.
Cart
Under Theme settings > Cart:
- Cart type — Choose
Drawerfor the AJAX slide-in cart orPagefor a traditional full-page cart with a no-JS fallback. - Free shipping threshold — Set the dollar amount required to unlock free shipping. Setting this to
0hides the free shipping progress bar entirely.
Social
Under Theme settings > Social, add your Instagram, Twitter, and Facebook URLs. These populate the footer social icons throughout the storefront.
Header & Navigation
Menu, Logo & Logo Position
In the header section settings, use the menu picker to select which Shopify navigation menu displays in the header, and upload your logo image. A logo position setting lets you choose between Left and Center alignment to match your brand. Manage menus in Shopify Admin > Online Store > Navigation.
Sticky Header
Enable the sticky header checkbox in the header section settings to keep the header pinned as customers scroll.
Mobile Menu
Below 990px viewport width, the header navigation collapses into a mobile menu icon. Above 990px, the full navigation menu displays inline in the header.
Hero Banner
Bundled Photos or Custom Image
The homepage hero banner includes a "Bundled photo" select field — choose any of the 5 bundled lifestyle photos that ship with the theme to launch instantly with zero photography of your own. To use your own photo instead, use the Image picker, which overrides the bundled photo selection whenever an image is uploaded.
Eyebrow, Heading & CTA
The hero supports an eyebrow label above the headline, a two-line heading, and an optional call-to-action button with customizable text and link.
Height & Scrim
- Height — Slider from 360px to 720px to control the hero's height on desktop.
- Light scrim opacity — Adjusts the light overlay applied over the hero photo so heading text stays legible without darkening the warm aesthetic.
- Text position — Choose where the eyebrow, heading, and CTA are anchored within the hero.
Explore Categories
Circular Medallions
The Explore Categories section displays up to 8 collection blocks as circular medallions. For each block, choose a collection to link to and optionally override its image with a custom photo instead of the collection's default image.
Tip: Create automated collections for the most common cat furniture categories by tagging products cat-tower, interactive-toy, scratcher, and bed, then set up 4 automated collections in Shopify Admin > Products > Collections using those tags as conditions. Link each medallion block to the matching collection.
Lookbook
Shop-the-Look Grid
The Lookbook section displays up to 8 image blocks in a staggered grid. Each block accepts a lifestyle photo and an optional product link. When a product link is set, a tag badge appears on the photo so customers can shop the look directly from the image.
Fan Favorites
Add the Fan Favorites section from the theme editor and configure:
- Collection — Pick the collection to pull bestselling products from.
- Product count — Choose how many products to display.
- Use recommendations — Enable this to switch the section into Shopify's product recommendations mode instead of a fixed collection.
Star Ratings
Fan Favorites and product cards can optionally display a star rating next to the price. To enable star ratings for a product:
- Go to Shopify Admin > Settings > Custom data > Products and add a new metafield definition with namespace and key
reviews.rating. - Set the rating type so it accepts a decimal value.
- On each product, enter a value such as
4.8in thereviews.ratingfield.
When a product has a value in reviews.rating, the star rating renders automatically next to the price. Products without a value simply hide the rating — no placeholder or broken layout appears.
Product Page
Reorderable Blocks
The product page is built from reorderable blocks that you can drag into any order in the theme editor: vendor, title, price, star rating, variant pills, quantity, buy buttons, description, collapsible tabs, and share.
Media Gallery
The product media gallery supports standard images as well as video and 3D models. Upload a 3D model file through the standard Shopify product media uploader and it will display automatically in the gallery — no extra configuration required.
Variant Pills
Variants use a rounded pill-style picker that matches the theme's overall design language. Selecting a pill for one option keeps every other option selector on the page in sync.
Dynamic Checkout & Structured Data
Dynamic checkout buttons (Shop Pay and other express checkout options) appear automatically below the buy buttons. The product page also outputs JSON-LD structured data for SEO and rich search results, with no extra setup needed.
Collapsible Tabs
Use the collapsible tabs block to organize shipping info, materials, care instructions, or any custom content into clean, expandable sections.
Collection Page
Sorting & Filters
Collection pages include a sort dropdown and Shopify's native storefront filters. To enable filters:
- Go to Shopify Admin > Search & Discovery.
- Open Filters and enable the filters you want to expose (product type, availability, tags, etc.).
- Meowhaus automatically renders enabled filters on the collection page, styled to match the warm, organic aesthetic.
Price Range
A price range filter is available alongside the standard storefront filters, letting customers narrow results to their budget.
Cart
Drawer or Page
Choose between a slide-in drawer cart or a traditional full page cart under Theme settings > Cart. The page cart includes a no-JS fallback so it functions even if JavaScript fails to load.
Free Shipping Bar
The cart drawer displays a free shipping progress bar based on the Free shipping threshold you set in Theme settings > Cart. Setting the threshold to 0 hides the bar entirely if you don't offer free shipping.
Order Notes
Customers can add an order note directly from the cart — useful for gift messages or delivery instructions. Cart totals are section-rendered, so quantity changes update instantly without a full page reload.
Customer Accounts & Gift Card
Meowhaus includes fully styled customer account templates: login, register, account, order history, and addresses. A gift card template is also included and styled to match the theme. A newsletter signup block is available to add anywhere on the homepage or footer.
Note: Meowhaus has no external JavaScript or CSS dependencies and requires no third-party apps for any of the features on this page. The theme is built to be responsive and accessible, with focus traps in the cart drawer and mobile menu, ARIA attributes throughout, and support for reduced-motion preferences.
License & Activation
License Terms
Each Meowhaus purchase grants you a single-store license. This means you may install and use the theme on:
- One (1) live production Shopify store
- One (1) development or staging store for testing purposes
Using the theme on additional production stores requires purchasing additional licenses. Contact our support team for multi-license pricing.
Entering Your License Key
After purchasing the theme, you will receive a license key via email. To activate:
- Install the theme on your Shopify store following the installation steps above.
- Open the theme editor and navigate to Theme settings > License.
- Enter your license key in the License key field.
- Click Save. The theme will verify your license against our server and activate all premium features.
Removing the Watermark
The unlicensed version of Meowhaus displays a small "Theme by beBriz" watermark in the footer. Once you enter a valid license key, the footer watermark is automatically removed and all premium sections become fully functional.
Need Help?
If you cannot find the answer to your question in this documentation, visit our support page to contact our team directly. We typically respond within 24 hours on business days.