Theme Configuration Guide

12 minute readLast updated: December 2025

This guide shows you how to enable the Facetify app embed and add blocks to your Shopify theme. These instructions work across all supported themes.

In this guide

App Embed (Required)
Product Grid Block
Product Recommendations Block
Tested Themes
Troubleshooting

Prerequisites

Before configuring your theme, make sure you have:

Installed Facetify and waited for product sync
Access to your Shopify theme editor

App Embed (Required)

The app embed is required for Facetify to work. It loads the core search system and enables header search replacement.

How to Enable

Open Theme Editor

Go to Online Store → Themes → Customize

Find App Embeds

In the left sidebar, scroll down and click App embeds

Enable Facetify

Find "Facetify Search/Filter" and toggle it ON

Save

Click Save in the top right corner

App Embed Settings

Click on the Facetify app embed to configure its settings:

Setting	Options	Description
Header Search	`replace`, `disabled`	Replace your theme's header search with Facetify search, or keep native search
Search Behavior	`autocomplete`, `auto_search`, `manual`	How search responds to typing. Autocomplete shows suggestions, auto_search searches immediately
Color Scheme	`auto`, `light`, `dark`	Color theme for the search overlay. Auto inherits from your theme
Debug Mode	On/Off	Enable console logging for troubleshooting

Product Grid Block

The Product Grid block displays products with filtering, sorting, and pagination. Use it on both collection pages and search pages.

On Collection Pages

Add the Product Grid to your collection template to enable filtering and sorting.

Navigate to Collection Template

In the theme editor, use the page dropdown and select Collections → Default collection

Add Section

Click "Add section" and select "Facetify Product Grid" from the Apps section

Position the Section

Drag the section below the collection banner/header

Hide Theme's Native Grid

Find your theme's default "Product grid" section and click the eye icon to hide it

Save

Click Save to publish your changes

Recommended Collection Settings

Search Display: disabled (no search input needed)
Filter Layout: standard (shows filter bar with drawer)
Desktop Columns: 4 (matches most themes)
Products Per Page: 24

On Search Pages

Add the Product Grid to your search template with search display enabled.

Navigate to Search Template

In the theme editor, use the page dropdown and select Search

Add Section

Click "Add section" and select "Facetify Product Grid"

Enable Search Display

Set Search Display to enabled_with_header to show search input and results heading

Hide Theme's Native Search Results

Find and hide your theme's default search results section

Save

Click Save to publish your changes

Recommended Search Settings

Search Display: enabled_with_header (shows "Search results for..." heading)
Filter Layout: standard
Desktop Columns: 4 (match your collection pages)
Products Per Page: 24

Product Grid Settings Reference

Display Settings

Setting	Options	Description
Search Display	`disabled`, `enabled`, `enabled_with_header`	Show search input above results (use on search pages only)
Filter Layout	`none`, `drawer`, `standard`	How filters are displayed: none, drawer only, or full filter bar
Show Filter Counts	On/Off	Display product counts next to filter options
Show Filter Chips	On/Off	Display active filters as removable chips
Color Scheme	`auto`, `light`, `dark`	Color theme for the grid

Grid Settings

Setting	Range/Options	Description
Desktop Columns	2-5	Number of product columns on desktop
Products Per Page	12-48	Products displayed per page

Product Card Settings

Setting	Default	Description
Show Brand	On	Display vendor/brand name
Show Title	On	Display product title
Show Price	On	Display product price
Show Like Button	On	Display heart/favorite icon

Product Recommendations Block

Display product recommendations to help customers discover related items. Use this on product pages and the homepage.

On Product Pages

Show related products below the main product information.

Navigate to Product Template

In the theme editor, select Products → Default product

Add Section

Click "Add section" and select "Facetify Product Recommendations"

Position Below Product

Drag the section below the main product section

Configure Source

Set Show Products From to same_vendor or same_type for relevant suggestions

Save

Click Save to publish

On Homepage

Feature products from a specific collection on your homepage.

Navigate to Homepage

Select Home page from the page dropdown

Add Section

Click "Add section" and select "Facetify Product Recommendations"

Set to Collection Mode

Set Show Products From to collection

Pick a Collection

Use the collection picker to select your "Featured" or "Bestsellers" collection

Save

Click Save to publish

Recommended Homepage Settings

Section Heading: "Featured Products" or "Shop Bestsellers"
Show Products From: collection
Number of Products: 8
Desktop Columns: 4

Recommendations Settings Reference

Setting	Options	Description
Section Heading	Text	Custom heading above recommendations (leave empty to hide)
Show Products From	`any`, `same_vendor`, `same_type`, `collection`	Filter recommendations by source
Collection	Collection picker	Select collection (when using collection mode)
Number of Products	2-25	How many products to display
Desktop Columns	2-6	Product columns on desktop

Tested Themes

Facetify is designed to work with any Shopify theme. The following themes have been specifically tested and verified:

Theme	Status	Version Tested	Notes
Dawn	Baseline	—	Shopify's default theme. Reference implementation, fully tested.
Refresh	Supported	—	Works out of the box with no special configuration.
Sense	Supported	—	Works out of the box with no special configuration.
Spotlight	Supported	15.4.1	Same codebase as Dawn. Works out of the box.
Craft	Supported	15.4.1	Same codebase as Dawn. Works out of the box.
Studio	Supported	15.4.1	Same codebase as Dawn. Works out of the box.
Ride	Supported	15.4.1	Same codebase as Dawn. Dark theme supported.
Prestige	Supported	—	Uses a different search pattern. Fully working.
Horizon	Supported	3.1.0	Uses dialog-component pattern. Fully working.
Savor	Supported	3.1.0	Same codebase as Horizon. Works out of the box.
Tinker	Supported	3.1.0	Same codebase as Horizon. Works out of the box.
Other themes	Fallback	—	Generic detection is used for unknown themes.

Status Legend

Baseline - Reference implementation, fully tested
Supported - Tested and working, no special configuration needed
Fallback - Generic detection used for unknown themes

Using a theme not listed above? Facetify uses automatic detection that works with most themes. If you encounter any issues, contact us and we'll help get it working.

Troubleshooting

Filters not appearing?

Check that the app embed is enabled in App embeds
Verify products have synced (check Facetify dashboard for "All products synced")
Make sure Filter Layout is set to standard or drawer, not none

Products showing twice?

Hide your theme's default "Product grid" section (use the eye icon, don't delete)
Check you don't have multiple Facetify grid sections on the same page

Styling looks off?

Set Color Scheme to auto to inherit your theme's colors
Facetify uses Shadow DOM for style isolation - this prevents conflicts but means your theme's custom CSS won't affect Facetify components

Search not working in header?

Verify Header Search is set to replace in the app embed settings
If using an untested theme, the search replacement may need adjustment - contact support

Need help with your theme?

If you're having trouble with any theme, contact our support team. We're happy to help get Facetify working on your store.

Previous← Admin Guide More GuidesAll Guides →