Quick Start

The PSYKHE AI Shopify integration is delivered as a tenant-scoped Custom Application. PSYKHE AI installs and operates the app on the merchant's store through a collaborator account.

Integration Flow

The integration has three stages:

1. Collaborator access - merchant shares the *.myshopify.com domain and collaborator request code. PSYKHE AI sends the collaborator request, and the merchant approves it in Settings → Users and permissions → Collaborators.
2. Custom app install - PSYKHE AI installs the tenant-scoped Custom Application through the approved collaborator account. The app provisions API credentials, the PSYKHE AI Web Pixel, and webhook subscriptions. The first sync is a full catalog backfill; webhooks keep the index in sync afterward.
3. Theme configuration - merchant duplicates the live theme. PSYKHE AI enables the Collection, Search, and Carousels blocks on the theme copy, configures merchant settings, validates the storefront, then the merchant publishes the copy.

See What Is Indexed for the catalog data model and sync cadence.

Validation Checklist

Before publishing the theme copy, confirm:

• collection filters, sorting, results count, grid, and pagination behave as expected
• search and predictive search return results
• enabled recommendation rails return products

Customization

The default app config covers filters, sort orders, card layout, and CSS without any code changes. See Customization for the available knobs.

For storefronts that want to extend the default blocks, the PSYKHE AI UI component library is available on request and lets you customize via web components. This is the same library used by the headless integration.

Tracking

Tracking is handled by the PSYKHE AI Web Pixel. It honours Shopify's Customer Privacy API and the merchant's consent banner. See Tracking for the event list and consent model.