View and retry failed print jobs in WooCommerce with the BizPrint Print Job Queue

This page shows you how to use the Print Job Queue of the BizPrint plugin for WooCommerce: see which print jobs are waiting to be sent to BizPrint, and retry or remove the ones that failed. It is for WooCommerce store owners and the staff who manage printing in WordPress.

What the Print Job Queue holds

The Print Job Queue is a list, kept in WordPress, of print jobs that the plugin is tracking or trying again.

If a print request could not reach BizPrint, the plugin may keep it in the Print Job Queue and try again later. The Print Job Queue only fills when Background Print Processing or Queue Failed Jobs is turned on. Both are off by default. If your orders are not printing, see WooCommerce orders are not printing automatically with BizPrint.

The queue only shows whether the plugin managed to send a job to BizPrint. It does not show whether the job came out of the printer. To check that, look at the printer and at the job’s print job status in the BizPrint dashboard.

Open the Print Job Queue

1. Sign in to WordPress as an administrator.
2. Go to WooCommerce > Print Manager.
3. Open the Support tab.
4. Scroll to Print Job Queue.

Queue Status shows how many jobs are in each state:

• Pending: waiting to be sent, either for the first time or for their next try.
• Processing: being sent right now.
• Completed: sent to BizPrint.
• Failed: every try failed, and the plugin has stopped trying.

If there are failed jobs, the Failed Jobs table lists the most recent ones, with the Order, the number of Attempts, and the Last Error. Click the order number to open the order.

The plugin also removes old jobs from the queue by itself after a while.

Check before you retry or process the queue

Retrying a job, or clicking Process Queue Now, sends jobs to the printer again. A job’s state in the queue alone does not tell you whether paper came out of the printer. Do these checks first, every time:

1. Look at the printer. Make sure the order really did not print, and that the printer has paper and shows no error.
2. Check the order’s print job status in the BizPrint dashboard. done means the station reported that it printed the job.
3. Wait for the station to finish anything it is still printing, whatever status the job shows.
4. Check Queue Status in the Print Job Queue.
5. Wait for any jobs that are Processing to finish. The plugin is sending them right now.

When you print an order by hand, you first wait for pending jobs, because the plugin may still send them. Here it is different: you do not need to wait for Pending jobs to finish, because they are the jobs that Process Queue Now sends. A job you click Retry on is Pending and due to be sent right away. The plugin may send it in its next background run, even before you click Process Queue Now. So do checks 1 to 3 for each order before you click Retry, and before you send any pending job.

If the order did print, click Delete for that job instead of Retry. Never place an order again, or take a payment again, to get a printout.

Retry a failed job

1. Do the checks in Check before you retry or process the queue.
2. Find the job in the Failed Jobs table.
3. Click Retry. The job leaves the table and goes back to Pending, with a fresh set of tries. The plugin may send it in its next background run.
4. Reload the page, so Queue Status and the Process Queue Now button show the job you retried.
5. Check the printer for the printout. The plugin may already have sent the job.
6. Check Queue Status. If the job is still Pending, follow Send waiting jobs now to send it, including the checks.

Send waiting jobs now

Process Queue Now sends a batch of the jobs that are Pending and due to be sent. One click may not send every pending job. Jobs that are waiting for a later retry are not sent early. The button can only be clicked when there are pending jobs.

1. Do the checks in Check before you retry or process the queue.
2. Click Process Queue Now.
3. Check the Pending count in Queue Status when the page reloads.
4. Check the printer for the printouts.
5. Do all the checks in Check before you retry or process the queue again, if jobs are still Pending and due to be sent.
6. Click Process Queue Now again.
7. Repeat steps 3 to 6 until no jobs that are due to be sent are Pending, doing the full checks before each click.

Delete or clear jobs

Deleting jobs from the queue only removes the plugin’s record of them. It does not cancel anything that already reached BizPrint or the printer, and it does not change the order.

• Delete, in the Failed Jobs table, removes one failed job after you confirm. The plugin will not try it again. Use it when you have checked that the order already printed, or you no longer need the printout.
• Clear Completed Jobs removes all jobs that were sent successfully. Nothing is printed or cancelled.
• Clear All Jobs removes every job in the queue: completed, pending, processing and failed. Pending jobs are then never sent, so those orders may not print. Check the Pending count before you use it.

To delete one failed job:

1. Click Delete next to the job in the Failed Jobs table.
2. Click OK when you are asked “Are you sure you want to delete this job?”.
3. Reload the page, if it did not reload by itself.
4. Check Queue Status.

To clear several jobs at once:

1. Check the Pending count in Queue Status.
2. Click Clear Completed Jobs or Clear All Jobs. There is no confirmation message.
3. Check Queue Status when the page reloads.

Related pages

• Reprint a print job from the BizPrint dashboard
• Orders print twice or more with BizPrint
• WooCommerce orders are not printing automatically with BizPrint

Need help? Contact BizPrint support at https://getbizprint.com/support/.