BigCommerce Integration

Installation Guide

Add the widget to your BigCommerce store via Script Manager — no coding required.

1 Add Script via Script Manager

Go to Storefront → Script Manager → Create a Script with these settings:

• Name: GunUpdate Widget
• Placement: Footer
• Location: Product Pages
• Script type: Script

Paste this code:

<script src="https://cdn.gunupdate.com/widget/gunupdate-widget.js"
        data-store="YOUR_API_KEY"
        data-platform="bigcommerce"
        data-auto-detect="true"
        defer></script>

The data-auto-detect="true" attribute lets the widget automatically find the product ID and name on BigCommerce product pages.

2 Save & Test

Save the script. Visit any product page — the widget appears below the Add to Cart button automatically.

Stencil Theme: Manual Placement

For precise placement, edit your Stencil theme. In templates/pages/product.html:

<div id="gunupdate-widget"
     data-store="YOUR_API_KEY"
     data-product-id="<?php echo e(product.id); ?>'"
     data-product-name="<?php echo e(product.title); ?>'"
     data-product-sku="<?php echo e(product.sku); ?>'"
     data-mode="compatibility"
     data-theme="light"
     data-platform="bigcommerce">
</div>

Widget Modes

compatibility

"Does this fit my gun?" — customer uploads photo or selects model, gets yes/no answer + compatible products from your store.

builder

Interactive gun builder — clickable hotspot zones on a gun silhouette. Customers explore accessory categories visually.

configurator

Full experience — build + compatibility check + smart recommendations. Best for stores with 50+ gun accessories.

Data Attributes Reference

Attribute	Required	Description
data-store	Yes	Your API key
data-product-id	Yes	Product ID on your platform
data-product-name	No	Product name for better matching
data-product-sku	No	SKU for precise matching
data-mode	No	compatibility \| builder \| configurator
data-theme	No	light \| dark \| auto
data-platform	No	Platform identifier for analytics
data-lang	No	Language code (default: en)