Understanding the Jobs Queue

Monitor and manage activities as they move from your Google Sheet into BuddyBoss.

The Jobs Queue is BuddyActivity's internal processing pipeline. When a sync runs, rows from your Google Sheet are converted into jobs and placed in the queue. BuddyActivity then works through the queue, creating each activity in BuddyBoss in the correct order.

Viewing the Jobs Queue

To view the current queue:

  1. Go to BuddyActivity → Jobs Queue.
  2. The table shows all jobs and their current status.
  3. Use the status filter to view only pending, failed, or done jobs.

Job Statuses

StatusDescription
pendingThe row has been read from the sheet and queued for processing, but has not yet been sent to BuddyBoss.
processingBuddyActivity is currently creating the activity in BuddyBoss. Rows typically pass through this state quickly.
doneThe activity was created successfully. The sheet row's status column has been updated.
failedThe activity could not be created. An error message is recorded in the Sync Logs. The row will not be retried automatically.
skippedThe row was skipped — usually because its scheduled_at time has not yet passed, or because it has already been processed.

Job Ordering

Jobs are processed in scheduled_at order — earliest first. This ensures that parent posts are always created before the comments and replies that depend on them, even if the rows are not in strict chronological order in your sheet.

Info: If two jobs have the same scheduled_at time, BuddyActivity processes them in the order they appear in the sheet (top to bottom).

Retrying Failed Jobs

Failed jobs are not retried automatically. To retry a failed job:

  1. Go to BuddyActivity → Jobs Queue.
  2. Find the failed job and check the error message in the details column.
  3. Fix the underlying issue (incorrect user ID, invalid group ID, etc.).
  4. Click Retry on the failed job, or update the row in your sheet and run a sync.
Tip: Check the Sync Logs for detailed error messages — the Jobs Queue shows a summary, but the logs contain the full error output.

Clearing the Queue

You can clear completed jobs from the queue to keep the list manageable. Clearing done jobs is safe — it only removes the queue records, not the actual BuddyBoss activities that were already created.

Warning: Do not clear pending or processing jobs unless you intentionally want to cancel them. Clearing a pending job means that row will not be processed, and its status in the sheet will remain unchanged.

Was this article helpful?

Menu