Web Components Integration (Beta)

Add FactFinder search and navigation components to a Shopify Horizon theme.

Web Components integration is in Beta. It is not ready for customer use.

It is optimized for Shopify Horizon themes. Other OS 2.0 themes may not have full layout or styling compatibility.

FactFinder Web Components replace the standard Shopify search and collection filtering with FactFinder components directly inside the Shopify Theme Editor. Add them through Shopify Theme App Extensions (App Embeds and App Blocks), without writing custom code.

Before you begin

Before adding blocks:

• Publish products to the correct sales channel and catalog.
• Configure the translations your storefront requires.

The app exports the default value when a translation is unavailable.

Enable the core library

Enable the library before adding interface blocks.

1

Open your theme

In Shopify Admin, open Online Store. Select Edit theme for your active Horizon theme.

2

Enable the library

Open App embeds in the sidebar. Turn on FactFinder Web Components Library.

3

Save your changes

Click Save in the top-right corner.

The library loads required bundles and handles search-query URLs. Configure the FactFinder API key first.

Add and place blocks

Add a FactFinder block from the Shopify Theme Editor. Select it to configure its settings.

Component	Purpose	Use it on	Configure	Default
FactFinder Searchbox	Show a search input with suggestions, categories, brands, and product previews.	Header, home, or search template	Placeholder, width from 200px to 800px, and suggestion headings	Search our store...
FactFinder Filter ASN	Show facets and active filters. Choose a vertical sidebar or horizontal top-bar layout.	Search or collection template	Active filter cloud and reset-button text	Clear all
FactFinder Record List	Display the product grid with dynamic variant prices and images.	Search results template	Two to five desktop columns, product descriptions, and details-button text	Four columns and View Details
FactFinder Sortbox	Let customers sort results.	Above the product grid on search results templates	Label and left, center, or right alignment	Sort by:
FactFinder Per Page List	Let customers select results per page.	Above or below the product grid on search results templates	Comma-separated values, prefix, suffix, and alignment	10,20,30, Show:, and per page
FactFinder Paging	Show first, previous, page-number, next, and last controls.	Above or below the product grid on search results templates	Left, center, or right alignment	—