Basic Setup

Quick start guide for basic widget configuration.

This guide covers the essential configuration needed to get the Weevio Shopify Widget up and running quickly with default settings.

Minimal Configuration

The widget works out-of-the-box with the code generated by Weevio Cloud. Here's what's included by default:

window.weevioWidgetConfig = {
  // Required - Auto-configured
  shopifyDomain: '{{ shop.permanent_domain }}',
  teamID: 'your_team_id',
  baseURL: 'https://cloud.weevio.co',
  productId: '{{ product.id | json }}',
  variantId: '{{ product.selected_or_first_available_variant.id | json }}',
  productType: '{{ product.type | json }}',
  widgetType: 'product-page',

  // Feature flags - Customize these
  enableCrossSell: false,
  enableImprovedVariantSelection: false,

  // Feature configuration
  shippingEstimates: {
    enableDeliveryEtas: true,
    enableLocalPickupEtas: true,
    useStaticZipCode: false
  },
};

Step 1: Enable Cross-Sell (Optional)

If you've purchased cross-sell recommendations:

enableCrossSell: true,  // Change false to true

Step 2: Enable Improved Variant Selection (Optional)

If you want the enhanced variant selector:

  1. Get your Storefront API token from Shopify Custom App
  2. Add to configuration:
enableImprovedVariantSelection: true,
storefrontAccessToken: 'shpat_xxxxxxxxxxxxxxxxxxxxx',

Step 3: Enable B2B Pricing (Optional)

For logged-in B2B customers:

customerId: '{{ customer.id | json }}',

This Liquid variable automatically provides the customer ID when logged in.

Step 4: Configure Shipping Estimates

Adjust based on your plan:

For Premium Shipping (zip-based):

shippingEstimates: {
  enableDeliveryEtas: true,
  enableLocalPickupEtas: true,  // If you have physical locations
  useStaticZipCode: false  // Let customers enter zip
},

For B2B with Static Zip:

shippingEstimates: {
  enableDeliveryEtas: true,
  enableLocalPickupEtas: false,  // Usually not needed for B2B
  useStaticZipCode: "90210"  // Your warehouse/office zip
},

Complete Basic Configurations

Option A: B2C Store (All Features)

window.weevioWidgetConfig = {
  shopifyDomain: '{{ shop.permanent_domain }}',
  teamID: 'your_team_id',
  baseURL: 'https://cloud.weevio.co',
  productId: '{{ product.id | json }}',
  variantId: '{{ product.selected_or_first_available_variant.id | json }}',
  productType: '{{ product.type | json }}',
  widgetType: 'product-page',

  // Enable all features
  enableCrossSell: true,
  enableImprovedVariantSelection: true,
  storefrontAccessToken: 'your_storefront_token',

  // Dynamic shipping for retail customers
  shippingEstimates: {
    enableDeliveryEtas: true,
    enableLocalPickupEtas: true,
    useStaticZipCode: false
  },
};

Option B: B2B Store (Basic)

window.weevioWidgetConfig = {
  shopifyDomain: '{{ shop.permanent_domain }}',
  teamID: 'your_team_id',
  baseURL: 'https://cloud.weevio.co',
  productId: '{{ product.id | json }}',
  variantId: '{{ product.selected_or_first_available_variant.id | json }}',
  productType: '{{ product.type | json }}',
  widgetType: 'product-page',

  // B2B customer pricing
  customerId: '{{ customer.id | json }}',

  // Enable useful B2B features
  enableCrossSell: true,
  enableImprovedVariantSelection: true,
  storefrontAccessToken: 'your_storefront_token',

  // Static zip for warehouse location
  shippingEstimates: {
    enableDeliveryEtas: true,
    enableLocalPickupEtas: false,
    useStaticZipCode: "60601"  // Your warehouse zip
  },
};

Option C: Minimal (Shipping Only)

window.weevioWidgetConfig = {
  shopifyDomain: '{{ shop.permanent_domain }}',
  teamID: 'your_team_id',
  baseURL: 'https://cloud.weevio.co',
  productId: '{{ product.id | json }}',
  variantId: '{{ product.selected_or_first_available_variant.id | json }}',
  productType: '{{ product.type | json }}',
  widgetType: 'product-page',

  // Only shipping estimates, no other features
  enableCrossSell: false,
  enableImprovedVariantSelection: false,

  shippingEstimates: {
    enableDeliveryEtas: true,
    enableLocalPickupEtas: true,
    useStaticZipCode: false
  },
};

Verification

After configuration, verify everything works:

  1. Visit a product page in your live store
  2. Check for widget display
  3. Test feature functionality:
    • Change variants (if enabled)
    • Enter zip code for shipping (if Premium)
    • Add to cart (check cross-sell if enabled)
  4. Open browser console (F12) and check for errors
  5. Test on mobile device

Common Adjustments

Disable Local Pickup

If you don't have physical locations:

enableLocalPickupEtas: false,

Use Static Zip for All Customers

For consistent experience:

useStaticZipCode: "12345",

Disable Cross-Sell

If you don't want post-cart recommendations:

enableCrossSell: false,

Next Steps

Need Help?

Need Help?

For assistance, please send a message to our Support page.