Ecwid Troubleshooting: Common Issues and Fixes

Common issues you may encounter with your Ecwid store and how to diagnose and fix them.

Performance Issues

Ecwid performance affects user experience and conversions.

Largest Contentful Paint (LCP)

LCP measures loading performance. Ecwid-specific LCP issues include:

• Slow store widget initialization
• Large product images
• Host website blocking Ecwid load
• Too many products on category pages

Target: LCP under 2.5 seconds

Cumulative Layout Shift (CLS)

CLS measures visual stability. Ecwid-specific CLS issues include:

• Store widget container without dimensions
• Dynamic product loading
• Category navigation changes

Target: CLS under 0.1

General Performance Best Practices

Store Configuration:

• Limit products per page
• Optimize product images before upload
• Use Ecwid's built-in image optimization

Host Website:

• Ensure host website loads quickly
• Don't block Ecwid with slow scripts
• Use lazy loading for store below fold

For general performance concepts, see the global performance hub.

Tracking & Analytics Issues

Events Not Firing

Common causes of tracking failures on Ecwid:

• Analytics not configured in Ecwid admin
• Plan limitations (analytics requires Venture+)
• Cross-domain tracking not configured
• Ad blockers
• SPA navigation not tracked

Tracking Best Practices

Verify Configuration:

• Check analytics settings in Ecwid admin
• Verify correct GA4 Measurement ID
• Confirm plan includes analytics features

Test Thoroughly:

• Use GA4 DebugView
• Check Network tab for tracking requests
• Test in incognito mode
• Verify across store navigation

For general tracking concepts, see the global tracking issues hub.

Common Ecwid-Specific Issues

Cross-Domain Tracking

Problem: Sessions breaking between host site and Ecwid.

Cause: Ecwid may load from different domain than host.

Fix:

1. Configure cross-domain tracking in GA4
2. Add domains to linker configuration
3. Test session continuity

SPA Navigation Not Tracked

Problem: Page views not firing when navigating store.

Cause: Ecwid is a single-page application.

Fix: Use Ecwid's JavaScript API:

Ecwid.OnPageLoaded.add(function(page) {
  gtag('event', 'page_view', {
    page_title: page.name,
    page_location: window.location.href
  });
});

Embedded Widget Not Loading

Problem: Store widget doesn't appear on host website.

Diagnosis:

1. Check browser console for errors
2. Verify embed code is correct
3. Check for JavaScript conflicts

Fix:

• Re-copy embed code from Ecwid
• Check host website for blocking scripts
• Contact Ecwid support

Purchase Tracking Missing

Problem: Purchase events not appearing in GA4.

Causes:

• Thank you page not loading properly
• Cross-domain tracking issues
• GA4 not connected properly

Fix:

1. Verify GA4 Measurement ID in Ecwid
2. Test complete checkout flow
3. Check GA4 DebugView during purchase

Debugging Tools

Ecwid Tools

Ecwid Admin > Reports: View native analytics and sales data.

Store Dashboard: Check for configuration issues and alerts.

Browser Developer Tools

• Console: Check for JavaScript errors
• Network: Filter for "analytics" or "collect"
• Application: Check cookies for _ga values

Analytics Tools

• GA4 DebugView
• Google Tag Assistant
• Meta Pixel Helper

Getting Help

• Ecwid Help Center
• Ecwid Community Forum
• Ecwid Support (chat available in admin)