Web Print Status Messages - and what they mean

“Help! I’m a PaperCut Administrator and my users report a specific error message when they try to submit print jobs through Web Print. What does this Status message mean and how do we get documents printing?”


PaperCut’s Web Print allows users to send their documents to a printer with just a browser, simply by logging in and choosing the file they want to print. However, occasionally it doesn’t work as expected and the user might see an error message after submitting their print job. Let this article show you what each of these status messages mean and how you can get things working again.

STATUS= Finished: Queued for printing

This means that the job has been successfully uploaded to Web Print and sent to the printer. If you’re not seeing the job after this, check to see if this issue happens without Web Print when simply printing from the server. For additional troubleshooting ideas, check out Missing Or Disappearing Print Jobs.

STATUS= Finished: Held in a queue

This means that the job has been successfully uploaded to Web Print, submitted to the printer, and is now held by PaperCut because Hold/Release or Find-Me Printing has been configured. In order to release the job, the user must authenticate at the release panel.

STATUS= Denied: [Reason for denial]

PaperCut may be configured to deny print jobs for a lot of different reasons. One common example is that the user has run out of balance and their account is set to restricted, which would result in the message “Denied: Not enough available credit”.

Print jobs may also be denied for being too large, for having too many pages, for having a disallowed file extension, or being in color or duplex. Usually this happens because the printer in PaperCut was configured this way on purpose. These settings are managed for each printer in PaperCut under Printers > [printer name] > Filters & Restrictions.

STATUS= Canceled: Canceled by print policy

Seen to happen when a print script is enabled and requires a pop-up. Web Print works with Print Scripting but does not support pop-up notifications. You will either need to disable Print Scripting for this printer, or rewrite the script to ignore documents when the source is Web Print.

STATUS= Failed: Printer ‘\\PaperCutSRV01\library-color’ is currently not available.

This means that Web Print is not able print the job because the printer cannot be found, which can happen for a few different reasons.

  • The print queue was deleted from the server
  • The print queue was renamed on the server
  • The print server was renamed
  • The print server name is longer than the supported NetBIOS name (no greater than 15 characters)
  • The no print queue with this exact name is set up on the Web Print Sandbox
  • Or an extremely specific issue resolved with PaperCut version 17.4 that affected Web Print Sandboxes on Windows Server 2008 R2 or Windows 8 and above using Client-Side Rendering (CSR)

In most of those scenarios Web Print is unable to submit the print job, because the name of the “printer” in PaperCut does not actually match the name of a print queue that exists on the server or Sandbox.

To resolve, log onto the PaperCut server running the Web Print Service or workstation running the Web Print Sandbox application and make sure that the print queue still exists and that the name matches what is in PaperCut. If the print queue or print server was renamed recently, then follow these steps in How to Rename a Printer to make sure the printer has also been renamed in PaperCut.

STATUS= Failed: Timed out

This message will be preceded by “Rendering successful. Preparing job for processing” finally the it will be replaced by this message after a few minutes.

It has been seen to happen in a couple situations:

  • The PaperCut Print Provider service is not started. In this case the print job may still print successfully but users will see the “Failed: Timed out” error.
  • On the Web Print Sandbox there may be an Office application like Word with an open dialog box which is preventing the job from printing. keep the job from printing.
  • More than one Known Issue (specifically PC-15889 affecting PaperCut 19.0.4 and PC-9941 affecting PaperCut 16.2) resulted in Web Print jobs failing with this error message.

To resolve, log onto the PaperCut server running the Web Print Service or workstation running the Web Print Sandbox application and make sure that the “PaperCut Print Provider” service is started following these steps. Also if you are encountering this message with an older version of PaperCut, try upgrading.

If this is a Web Print Sandbox, log on as the workstation as the Web Print user account and ensure that you can print an Office document normally and there are no prompts or dialog boxes blocking the application from printing.

STATUS= Error: Unable copy print data file when preparing print job

The WebPrint Service or Sandbox is supposed to copy the print job to the %TEMP% directory but fails for these reasons that we’ve seen:

  • the computer running Web Print has run out of disk space
  • the Web Print Sandbox user account doesn’t have write permissions to the %TEMP% directory

The exact steps to get this working will depend on whether this is the Web Print Service or Web Print Sandbox. If this is the Web Print service running as SYSTEM, then this directory will be located in C:\Windows\Temp\web-print. Whereas if this is the Web Print service running as a service account or the Web Print Sandbox, then the path will be %TEMP%\web-print.

Check the server where Web Print is running to ensure there is adequate disk space. Also if Web Print is running as a service account or if this is the Web Print Sandbox then check the permissions on the %TEMP% directory to ensure that this user account has read, write, and modify privileges.

STATUS= Failed: Unable to start handler to render print job

This has been seen to happen for the same reason as the Unable copy print data file when preparing print job error, but when an image file is uploaded to Web Print instead of a PDF. We believe this happens when the “image handler” used by Web Print for images (like .png and .jpeg files) fails to print the job for some reason. We know from testing that you can encounter this error if the Service or Sandbox is unable to write to the Windows %TEMP% directory as described above. Reach out to us through the link at the bottom of this article and let us know if you encounter this message for another reason.

STATUS= Failed: Cannot access network printer ‘\\server\printer’ from ‘system’ account

Cannot access network printer - Reason #1

This happens when the Web Print Service, which runs as local system by default, tries to submit a print job to a queue hosted on another print server but lacks permission. In the world of Windows the local system account has full admin rights on the local server, but cannot interact with anything on the network, including a print queue on another server, hence the error.

Resolving this error depends on whether your PaperCut implementation is supposed to be using the Web Print Service (default) or Web Print Sandbox.

  • If you use the Web Print Service… There are at least two ways to fix this. The hard way to resolve this is to configure the Web Print Service to run as a domain user or Service Account with permissions to send print jobs to the print queue on the other print server. The easy way to resolve this is to simply make sure that any print queues published through web print are hosted on the print server that is running PaperCut.
  • If you use the Web Print Sandbox… This error should never be seen for print jobs submitted through a Web Print Sandbox because this application doesn’t use the system account and must run as a logged-in user. If you are seeing this error, it means that the Web Print Service was not disabled on the PaperCut server and is still running. Disable the Web Print Service by opening services.msc, right-click on the service PaperCut Web Print Server, choose Properties, then make sure that the service is stopped and that the startup type is Disabled.

Curiously, you may also see that Office documents will succeed but PDFs and image files won’t. This is because office documents are printed through the Web Print Sandbox which runs as a domain user account, and PDFs fail because are printed by the Web Print Service which might be running as local system.

Cannot access network printer - Reason #2

This also has been seen to happen when someone edits the line ServerName= in the Print Provider configuration file, print-provider.conf. If this is the case, this change must be reverted as it is not compatible in most Web Print implementations.

An admin might have made this change deliberately because they wanted to hide the name of the print server in Web Print for security reasons or to make things simpler for users. A better method for hiding the name of the print server in Web Print is described on our page about using Javascript to customize the User Web interface.

Seeing something else?

Are you encountering a totally different error message with Web Print that isn’t documented here? Let us know! We love chatting about what’s going on under the hood. Please visit our Support Portal to get a support ticket started. We may ask you to help us gather the Web Print debug logs for analysis.


Categories: Troubleshooting Articles, Web Print

Keywords: Web Print, WebPrint, Sandbox

Comments