Collection Not Found
The Storefront API returned no collection for handle tees. Admin can look correct while the API still cannot see it (handle, publishing, or token).
- Exact URL handle: Shopify Admin → Products → Collections → open the collection → Search engine listing. The path must end with
/collections/tees(no extra suffix like-1). - Publish to your headless storefront: In the collection’s Publishing section, enable the same channel as your products (e.g. Sacrificial Conversations Frontend). Online Store alone is not always enough for the Storefront API.
- Storefront token: Use the private token from Sales channels → Headless → your storefront → Storefront API → Manage, and put it in
.env.localasSHOPIFY_STOREFRONT_ACCESS_TOKEN. Restartnpm run devafter changes. - Mock mode: If
USE_MOCK_PRODUCTS=true, remove it for real Shopify data.
