Background jobs are automated system tasks that BMS runs behind the scenes — scheduled imports, index updates, billing cycles, and other operations that do not require user input. Navigate to Admin → Background Jobs to view the current job queue and history.
The Background Jobs Screen
The screen displays a list of queued and completed jobs. Each row shows: Description (what the job does), User (the admin or system account that triggered it), Result (outcome of the last run), Log (link to the detail log), Errors (error count), Warnings (warning count), Progress (completion percentage), Status (current state), Queued (when the job was queued), Completed (when the job finished).
Job Statuses
Jobs can have the following statuses:
Queued — waiting to start, behind other jobs in the queue
Working — currently running
Completed — finished successfully
Failed — encountered an error and did not complete
Reading the Queue
Most background jobs complete quickly and appear as Completed with a green result. A long list of Queued or Working jobs may indicate the system is processing a large batch — this is normal during billing runs, nightly imports, or after bulk data changes. The queue will clear once processing is done.
Identifying Failed Jobs
If a job shows a Failed status or a non-zero Errors count, click the row to view the log. Common causes include:
Data validation errors in an import file
A third-party service being temporarily unavailable (for example, Xero or SendGrid)
A configuration issue in the process that triggered the job
Most failed jobs can be re-triggered once the underlying issue is resolved. If a job fails repeatedly without a clear cause shown in the log, escalate to your BMS administrator or contact support.TODO