Enable hat products
Open the App in Shopify Admin. Review the detected products, enable products individually, or use Enable all detected products.
Help center
Get Hat Try-On live on your store
Install the app, enable your hat products, turn on the storefront widget, and test a virtual try-on. Setup time depends on the store theme and product catalog.
Setup
Review your plan
Start with Free or select Starter, Growth, or Pro. Paid plans and usage charges are approved and billed through Shopify.
Enable the App Embed
From the setup checklist, open the theme editor. Under App embeds, enable Hat Try-On and click Save. Theme editor setup requires a desktop browser.
Test a product
Open an enabled hat product in the storefront. Select a product photo, click Try On, upload a clear front-facing selfie, and generate the preview.
Photo and product requirements
Shopper photo
- One clearly visible face
- Front-facing or nearly front-facing
- Good lighting without heavy obstruction
- JPG, PNG, or WEBP under 10 MB
Hat product media
- A clear image showing one hat design and color
- Multiple views of the same design and color in one image are supported
- Current image must belong to the product
- Images are supported; video and 3D media are not
- The widget follows the image the shopper is viewing
Common questions
The Try On button does not appear
Confirm that the product is enabled in the App, the Hat Try-On App Embed is enabled and saved in the published theme, and the current media is an image rather than video or 3D. Refresh the storefront after saving theme changes.
Why is a product not detected automatically?
Automatic detection is a setup aid. Product titles, types, tags, and descriptions may not clearly identify every hat. You can manage supported products from the App’s product list.
Why was a shopper photo rejected?
The App rejects photos with no detectable face, multiple faces, a face that is too small, or a severe side angle. Ask the shopper to use a clear, well-lit, front-facing photo.
What counts toward usage?
Only a result that is successfully generated and displayed is counted. Failed validation or generation attempts do not consume successful try-on usage.
What is the shopper limit?
Each pseudonymous browser visitor can complete up to seven successful try-ons in a fixed seven-day period. This operates separately from the Merchant’s plan allowance.
How do additional try-ons work?
Starter, Growth, and Pro use Shopify App Pricing tiers. When additional try-ons are enabled, successful usage beyond the included tier is billed at the plan’s per-unit rate. Turn the setting off to stop generation at the included limit.
Are shopper photos stored?
No. Shopper photos, selected hat images, and generated results are processed in transient memory and are not stored in our Firestore database or Cloud Storage. See the Privacy Policy.
Can I use the theme editor on a phone?
Shopify’s theme editor setup should be completed in a desktop browser. Shoppers can use the Try On widget on supported desktop and mobile browsers after setup.
Contact support
Email: jackguokai@gmail.com
Include your .myshopify.com store domain, the affected product, browser/device, the approximate time of the issue, and a screenshot of any error. Do not email shopper selfies, Base64 image data, passwords, access tokens, or payment details.