Troubleshooting

Plugin not connecting

Check:

• Plugin is installed and activated
• Secret key is saved in the WordPress Overedge panel
• Secret key matches your overedge.dev dashboard

window.Overedge is undefined

The CDN script hasn't loaded yet. Always wrap calls in onReady():

window.Overedge.onReady(function () {
  // Use API here
});

Or use the useOveredge hook which handles this automatically.

No content showing

Check:

• Content is published in WordPress (not draft)
• Content type slug is correct
• WordPress REST API is accessible: yoursite.com/wp-json/wp/v2/posts

CORS errors

Your WordPress host may be blocking cross-origin requests. The Overedge plugin sets CORS headers automatically. If issues persist, check your hosting provider's firewall settings.

Pages not displaying

WordPress pages display by slug. Make sure the slug in your React component matches the page slug in WordPress:

• WordPress page title: "About Us"
• WordPress slug: about-us
• React component: useWordPressPage('about-us')

CDN script returns invalid site key

Your CDN key may not be set up correctly. Check overedge.dev/dashboard/credentials and make sure your cdn_key has a value.