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.

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.

ParameterRequiredWhat it is
opYesThe try-on type: wheels, color, spoiler, or exhaust.
refYesThe product photo, as a full https address on one of your allowed image domains. URL-encode it.
labelNoThe product name, shown to the shopper and in your leads. URL-encode it.
finishNoOnly 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.

What the shopper seesWhyFix
Open from a product pageop or ref is missing or misspelled, or ref isn't an https addressRebuild the link in the link builder
Product image not allowedref is on a domain you haven't allowedAdd the domain in Storefront → Allow your image domains
You've used all your try-onsThe visitor reached your visitor limitRaise it in Settings → Visitor limits if needed