Skip to content

Verification & Testing

Before You Begin

Section titled “Before You Begin”

⚠️ Important: This guide assumes you’ve already completed the Installation process, including:

  • Created a copy of your production site
  • Installed Commerce Connect plugin
  • Connected to BigCommerce
  • Migrated your WooCommerce data

If you haven’t completed these steps, start with the Installation Guide first.

What You’ll Accomplish

Section titled “What You’ll Accomplish”

In this guide, you’ll:

  1. Verify your products synced correctly (2 min)
  2. Create your first store page (5 min)
  3. Test the complete shopping experience (3 min)

Step 1: Verify Products Synced

Section titled “Step 1: Verify Products Synced”

After migration and sync, confirm your products are in Commerce Connect:

  1. Navigate to Commerce Connect → Products
  2. Verify: You see all your products listed
  3. Check: Product images, titles, and prices appear correct

Synced products in Commerce Connect

Expected result: All products from WooCommerce now visible in Commerce Connect.

Step 2: Create a Store Page

Section titled “Step 2: Create a Store Page”

Now display your products on your WordPress site:

Create the Page

Section titled “Create the Page”
  1. Navigate to Pages → Add New Page
  2. Page Title: “Store” (or “Shop”, “Products”, etc.)
  3. Click the + button to add a block
  4. Search for: “Commerce Connect Products”
  5. Insert the Commerce Connect Products Block
  6. Click Publish

Create store page with Commerce Connect Products block

Result: Your products now display in a grid layout!

View Your Store

Section titled “View Your Store”
  1. Click View Page or visit yourdomain.com/store
  2. Verify: Products display with:
    • Product images
    • Product titles
    • Prices
    • “Add to Cart” buttons

Step 3: Test the Shopping Experience

Section titled “Step 3: Test the Shopping Experience”

Confirm the complete customer journey works:

Add Product to Cart

Section titled “Add Product to Cart”
  1. On your store page, click Add to Cart on any product
  2. Verify: Cart icon updates (if using cart icon block)
  3. Cart confirmation appears

Test Checkout

Section titled “Test Checkout”
  1. Click Checkout or View Cart
  2. Verify redirect: You’re taken to secure.yourdomain.com (your checkout domain)
  3. Verify: BigCommerce checkout page loads
  4. Verify: Product appears in cart with correct:
    • Image
    • Title
    • Price
    • Quantity

Test checkout flow

✅ Success: If checkout loads and displays your product correctly, your Commerce Connect installation is working!

What’s Next?

Section titled “What’s Next?”

Now that basic functionality is confirmed:

Enhance Your Store Pages

Section titled “Enhance Your Store Pages”

Add more blocks to create a rich shopping experience:

Explore all 37+ available blocks →

Create Product Detail Pages

Section titled “Create Product Detail Pages”

Display individual product pages:

  1. Create a new page or template
  2. Add single product blocks:

Learn more about product page blocks →

Configure Analytics

Section titled “Configure Analytics”

Track your store’s performance:

  1. Set up Google Analytics 4 →
  2. Configure Google Tag Manager →
  3. Enable conversion tracking →

Customize Your Theme

Section titled “Customize Your Theme”

Make your store match your brand:

  1. Appearance → Editor (Full Site Editor)
  2. Customize:
    • Colors
    • Typography
    • Layout
    • Headers/Footers

Reminder: Commerce Connect requires a Full Site Editor theme.

Troubleshooting

Section titled “Troubleshooting”

Products Display But Images Missing

Section titled “Products Display But Images Missing”

Cause: Images didn’t sync or BigCommerce image URLs blocked

Solution:

  1. Check Commerce Connect → Products - do images show there?
  2. If yes: Clear WordPress cache
  3. If no: Go to Commerce Connect → Settings → Data and click Sync Products

Add to Cart Button Doesn’t Work

Section titled “Add to Cart Button Doesn’t Work”

Cause: JavaScript error or cache issue

Solution:

  1. Test in incognito/private browsing window
  2. Clear browser cache
  3. Check browser console for errors (F12 → Console tab)
  4. Disable other plugins temporarily to rule out conflicts

Checkout Doesn’t Load

Section titled “Checkout Doesn’t Load”

Cause: DNS not configured correctly for checkout domain

Solution:

  1. Verify DNS: Go to dnschecker.org
  2. Search for your checkout domain (e.g., secure.yourdomain.com)
  3. Type: CNAME
  4. Verify propagation across locations

If DNS not propagated:

  • Check DNS provider settings
  • Confirm CNAME record exists
  • Wait (propagation varies)

Products Not Syncing from BigCommerce

Section titled “Products Not Syncing from BigCommerce”

Cause: Webhooks not registered

Solution:

  1. Navigate to Commerce Connect → Settings → Webhooks
  2. Check status
  3. If inactive, click Register Webhooks
  4. Confirm: “Webhooks successfully registered”

Understanding the Data Flow

Section titled “Understanding the Data Flow”

Commerce Connect keeps WordPress and BigCommerce in sync:

BigCommerce (Source of Truth)
    ↓ (Webhooks - automatic)
Commerce Connect Plugin
    ↓ (Display)
WordPress Blocks
    ↓ (Customer clicks checkout)
BigCommerce Checkout (Hosted)

Key concept: Products display in WordPress, checkout happens on BigCommerce.

Why This Architecture?

Section titled “Why This Architecture?”
  • WordPress strengths: Content, SEO, page building, marketing
  • BigCommerce strengths: Commerce, checkout, payments, fraud protection, PCI compliance

Commerce Connect combines both platforms’ strengths.

Performance Tips

Section titled “Performance Tips”

First Page Load

Section titled “First Page Load”

Products load from BigCommerce on first view, then cache in WordPress.

Expected: First load may be slower, subsequent loads much faster.

Large Catalogs

Section titled “Large Catalogs”

If you have 1,000+ products:

  1. Use pagination (Products block supports this automatically)
  2. Add filters so customers can narrow results
  3. Consider separate category pages instead of showing all products

Image Optimization

Section titled “Image Optimization”

BigCommerce serves images, but you can optimize further:

  1. Enable Full Page Caching in WP Engine
  2. Use NitroPack for additional optimization (if available)
  3. Enable lazy loading (most modern themes do this automatically)

Need Help?

Section titled “Need Help?”

Ready to build? Explore all available blocks →