Skip to main content

Custom selectors & placement

productSelector

Tells the widget which image to attach the overlay button to.
Default selector (tried in order):
Platform examples:
How to find your selector: right-click the product image → Inspect → copy the class or id of the <img> or its parent. The widget skips images smaller than 150px wide to avoid injecting on thumbnails.

triggerSelector

Places the overlay button inside a specific container instead of next to the image:
The container must exist in the DOM at init time.

buyboxSelector

When using injectionMode: 'buybox' or 'both', this targets the anchor element near the Add to Cart button:
Shopify ATC selector examples:

overlayAnchorSelector

Override the anchor used to position the overlay button on the image:
Useful when the default image selector matches a wrapper rather than the image itself.