Documentation
How the Shopify version works
Photo Product Search for Shopify is built as a public embedded app with a theme app extension, Shopify-managed billing, and a hosted visual search backend.
Merchant setup flow
- Install the app from Shopify
- Approve required product scopes
- Let the app provision the backend store and start the trial
- Run the initial catalog sync from the embedded admin
- Enable the theme app extension in the theme editor
What gets synced
- Products, handles, tags, pricing, and stock status
- Product images required for visual similarity matching
- Incremental product updates via Shopify webhooks
1. Install
The embedded admin provisions the store automatically. No manual key copy/paste is part of the Shopify flow.
2. Sync
Run an initial sync once. After that, Shopify product webhooks keep the visual search catalog aligned with catalog changes.
3. Enable theme extension
Turn on the theme app extension so the storefront can show the “Search by photo” UI on collection and search pages.