Quick Start

Use this path when you run a standard Shopify theme.

Before You Start

Make sure you have all of these:

• access to the Shopify admin
• the PSYKHE AI app installed
• the target theme ready for testing

Step 1: Install The App And Grant Permissions

Install the PSYKHE AI Shopify app and complete the required permission flow.

Read Required Permissions before you move on.

Step 2: Configure The Merchant-Level Settings

Configure visual settings for the app, such as pagination, filters, and card layout.

Step 3: Validate Collection And Search

Verify these pages on the target theme:

1. collection page with Collection
2. /search results page with collection-v2 in search mode
3. predictive search form or modal search experience
4. any enabled recommendation rail

Expected result:

• filters, sorting, results count, grid, and pagination work without custom code
• search results use the shared collection-v2 surface, not a separate search-results block
• predictive search submits to the real search route

What You Can Customize Without Theme Code

The stock setup supports:

• block settings in the theme editor
• app config and metafields for stock card defaults and custom card element wiring
• custom_css on collection-v2, injected as a raw <style> block
• theme-level CSS token and ::part() overrides

There is no generic block setting for custom JavaScript. Theme-owned JavaScript lives in theme assets or runtime hooks.