Try-on links and the button
A try-on link opens your storefront with one product already picked. One link per product, built from the product's own image, is the whole integration.
Link format#
https://app.viztunr.com/s/YOUR-SHOP?op=wheels&ref=PRODUCT_IMAGE_URL&label=PRODUCT_NAME
YOUR-SHOP is your storefront address, shown in Settings → Branding under Public URL.
| Parameter | Required | What it is |
|---|---|---|
op | Yes | The try-on type: wheels, color, spoiler, or exhaust. |
ref | Yes | The product photo, as a full https address on one of your allowed image domains. URL-encode it. |
label | No | The product name, shown to the shopper and in your leads. URL-encode it. |
finish | No | Only with op=color: gloss, matte, satin, pearl, metallic, carbon, or chameleon. Use it when the swatch alone could be read either way. |
The fastest way to get a finished link is the link builder in Storefront, step Build your try-on links: paste the product image's address and copy the result.
Example#
A wheel with the image https://yourshop.com/images/forged-r1.jpg named "Forged R1 20":
https://app.viztunr.com/s/yourshop?op=wheels&ref=https%3A%2F%2Fyourshop.com%2Fimages%2Fforged-r1.jpg&label=Forged%20R1%2020
The button#
Paste this next to Add to cart on each product page, swap in the product's image and name, and style it like your other buttons:
<a href="https://app.viztunr.com/s/YOUR-SHOP?op=wheels&ref=PRODUCT_IMAGE_URL&label=PRODUCT_NAME"
target="_blank" rel="noopener">
Try on your car
</a>
The Storefront page shows this snippet with your own shop address filled in.
Let an AI agent add it#
If an AI agent or a developer maintains your site, the Storefront page has a ready prompt in step Put the button on your shop. It contains your link format, your try-on types with the right photo for each, and your allowed image domains. It reads like this:
Add a "Try on your car" button to the product pages of my shop.
The button is a plain link that opens my VizTunr try-on studio in a new tab. Link format:
https://app.viztunr.com/s/YOUR-SHOP?op=<category>&ref=<product-image-url>&label=<product-name>
Rules:
- ref must be an HTTPS image URL hosted on one of my allowed domains. URL-encode it.
- label is optional: the product's display name, URL-encoded.
- The link opens in a new tab (target="_blank" rel="noopener").
- Style it like the shop's existing secondary buttons and place it near "Add to cart".
- Do not change anything else about the pages.
Copy the version on your Storefront page rather than this one: it has your real shop address and domains.
When a link doesn't work#
| What the shopper sees | Why | Fix |
|---|---|---|
| Open from a product page | op or ref is missing or misspelled, or ref isn't an https address | Rebuild the link in the link builder |
| Product image not allowed | ref is on a domain you haven't allowed | Add the domain in Storefront → Allow your image domains |
| You've used all your try-ons | The visitor reached your visitor limit | Raise it in Settings → Visitor limits if needed |