API key or quota errors

API key and quota problems — keys not working, quotaExceeded, restriction errors — are covered in depth in the Connecting to YouTube section, including how to fix each cause and how to plan around Google’s daily limit.

The channel can't be found

1. Double-check the channel handle or ID you entered.
2. Confirm the channel is public (private or terminated channels can’t be read).
3. Test your API key against another known channel to rule out a key problem.

My recurring sync isn't running (Pro)

Recurring schedules run on WP-Cron, which fires on site traffic:

1. Low-traffic sites — WP-Cron may run late if no one visits. Consider a real server cron hitting wp-cron.php.
2. WP-Cron disabled — If DISABLE_WP_CRON is set in wp-config.php, schedules won’t fire unless a server cron is configured.
3. Rule disabled — Confirm the rule is enabled and saved with a schedule selected.

I'm seeing duplicate posts

Video Sync de-duplicates on the YouTube ID stored in _wpbuoy_video_sync_video_id, _wpbuoy_video_sync_playlist_id, or _wpbuoy_video_sync_channel_post. Duplicates usually mean those meta keys were removed, or the items were imported once by hand and once by Video Sync. Avoid editing or deleting the _wpbuoy_video_sync_* ID meta on synced posts.

A sync overwrote my manual edits (Pro)

Update actions refresh post data from YouTube by design. To protect a post, enable Video Protection on it — protected posts are skipped by sync rules. Alternatively, use an “update specific” action to refresh only the fields you choose.

I can't activate my license

1. Invalid license key — Copy-paste carefully and check for extra spaces.
2. Site limit reached — Deactivate the license on another site first.
3. Expired license — Licenses are annual; check your purchase date.
4. Server can’t connect — Your server must reach the WPBuoy license server. Check for a firewall or security plugin blocking outbound requests.

How to get support

• Free version — Community support via the WordPress.org plugin forum.
• Pro — Priority email support at support@wpbuoy.com.

When submitting a request, include:

• Your license key (Pro users)
• WordPress and PHP version
• A description of the issue and steps to reproduce
• The relevant sync error log entry, if any
• Screenshots if applicable