General Guide: See Events Not Firing for universal debugging steps.
Weebly-Specific Causes
Plan Limitations
- Free plan: No header/footer code injection
- Cannot add custom JavaScript without paid plan
- App Center options are limited
Code Placement Issues
- Code not saved properly in Settings
- Code in wrong location (header vs footer)
- Special characters breaking code syntax
Page-Specific Loading
- Code only loading on some pages
- Blog pages have different structure
- Product pages (Performance plan) require separate handling
Conflicts
- Multiple tracking implementations
- App Center apps conflicting with manual code
- JavaScript errors from other sources
Diagnostic Steps
Step 1: Verify Plan Supports Code Injection
- Check your Weebly plan (Personal, Professional, or Performance required)
- If on Free plan, upgrade or use limited App Center options
Step 2: Check Code Placement
- Go to Settings > SEO
- Verify code is in Header Code section
- Confirm code is properly formatted
Step 3: View Page Source
- Visit your live site (not editor preview)
- Right-click > View Page Source
- Search for your tracking code (Ctrl+F)
- Confirm it appears in the
<head>section
Step 4: Check Browser Console
- Open DevTools (F12)
- Go to Console tab
- Look for JavaScript errors
- Check for blocked resources
Step 5: Test with Debugging Tools
- Install GA Debugger
- Check GA4 Realtime reports
- Install Meta Pixel Helper
- Check Events Manager Test Events
GTM:
- Use GTM Preview Mode
- Verify container is loading
Weebly-Specific Fixes
Fix 1: Republish Site
After adding or changing code:
- Go to Weebly editor
- Click Publish
- Wait for publish to complete
- Clear browser cache
- Test on live site
Fix 2: Remove Conflicting Apps
If using App Center tracking apps AND manual code:
- Choose one method only
- Remove App Center tracking apps
- Or remove manual code and use apps
Fix 3: Fix Code Syntax
Common issues:
<!-- Wrong: Smart quotes from copy/paste -->
<script>
fbq('init', '123456789'); <!-- These quotes are wrong -->
</script>
<!-- Correct: Straight quotes -->
<script>
fbq('init', '123456789');
</script>
Fix: Copy code to plain text editor first, then paste into Weebly.
Fix 4: Blog Page Tracking
Weebly blogs may need separate handling:
- Verify header code applies to blog pages
- Check blog-specific settings
- Test on individual blog posts
Fix 5: Ecommerce Events (Performance Plan)
For product tracking:
- Verify you're on Performance plan
- Check DOM selectors match your theme:
// Verify these selectors work on your theme
document.querySelector('.wsite-com-product-title')
document.querySelector('.wsite-com-product-price')
document.querySelector('.wsite-com-add-to-cart')
- Adjust selectors if your theme uses different classes
Common Issues & Solutions
| Issue | Cause | Solution |
|---|---|---|
| No events at all | Free plan | Upgrade to paid plan |
| Code not in source | Not published | Republish site |
| Partial tracking | Code syntax error | Check for special characters |
| Some pages only | Page-specific code | Use global Header Code |
| Ecommerce missing | Wrong plan | Upgrade to Performance |
| Duplicate events | Multiple implementations | Remove duplicates |
Verification Checklist
- On paid Weebly plan
- Code is in Header Code section
- Site is published (not just saved)
- Code appears in page source
- No JavaScript errors in console
- No conflicting App Center apps
- Events appear in platform dashboards
- Tested in incognito mode