Install the storefront widget
Add the storefront script, map a product, and verify a real virtual try-on.
Reviewed by Closku documentation team ·
Before you start
Store owners should first:
- set up Your Widget
- prepare an active product with a usable image
- authorize the exact storefront origin
Ask an integrator for help if you cannot edit the theme or product template.
For a real test, the store needs an eligible subscription and available allowance or enabled extra try-ons with sufficient balance. Obtain the installation line from Your Widget and the matching Closku product UUID.
Add the script and product target
- In Your Widget, copy the installation line. Add it once to the storefront template, before the closing body tag, and publish.
- On each product page, render an element whose
data-product-idis the matching Closku product UUID.
<div data-product-id="11111111-1111-4111-8111-111111111111"></div>
<script src="https://closku.com/widget/your-store-slug.js" defer></script>Replace the example UUID with the active catalog ID and use the actual line copied from the workspace, not the example slug. The loader also detects certain cart forms; their native product or variant IDs are not necessarily Closku UUIDs. Avoid ambiguous or duplicate targets and check theme-specific behavior with your integrator.
Shopify, WooCommerce, and custom storefronts need a script and template integration. This is not an app installation or automatic catalog sync. Dynamic theme updates may need a theme-specific review; do not assume the loader remaps a page after a re-render.
Check the result
- Open the published product page on an authorized origin. Confirm the script loads and a try-on control appears beside the intended target.
- Compare the target UUID with the active product returned by the products API, including its name and image.
- Complete a real try-on using a suitable shopper photo. Confirm the AI-generated preview uses the intended garment.
Button appearance confirms placement only. If it is absent or the garment is wrong, check domains, mapping, and troubleshooting. Review shopper photos and privacy before launch.