Manual Sync

Trigger a sync immediately from the WordPress admin without waiting for the next scheduled run.

Manual sync lets you run a sync on demand. This is useful when you have just added new rows to your sheet and want them processed immediately, or when you are testing your setup and do not want to wait for the auto-sync interval.

Triggering a Manual Sync

  1. Go to BuddyActivity → Sync (or BuddyActivity → Dashboard).
  2. Click the Sync Now button.
  3. Wait for the sync to complete — a status message will confirm whether the sync succeeded or if any errors occurred.
Info: Manual sync runs the same process as auto-sync. It reads all unprocessed rows whose scheduled_at time has passed, creates the activities, and marks rows as done.

When to Use Manual Sync

  • Testing your setup — after adding your first rows, run a manual sync to confirm everything is connected correctly.
  • Immediate publishing — if you have rows with past scheduled_at values and want them published now.
  • After a failed sync — if the previous sync failed and you have fixed the issue, run a manual sync to retry.
  • Low-traffic sites — if WP-Cron is not running reliably, manual sync ensures nothing is left unprocessed.

Rate Limiting

Manual sync can be run as often as needed, but be aware that each sync consumes Google Sheets API quota. Google provides a generous free tier, but extremely frequent manual syncs on large sheets may approach limits. If you need very high frequency, consider using WP-CLI instead.

Tip: After clicking "Sync Now", do not navigate away from the page until the sync status is displayed. Leaving the page mid-sync may interrupt the process on some hosting configurations.

WP-CLI Alternative

If you have server access, you can trigger a sync from the command line using WP-CLI. This is especially useful for automating syncs via server cron. See the WP-CLI Commands article for available commands.

Was this article helpful?

Menu