Web Client - Configuration for Printing


Part of: WebClientConfiguration


Printing in the web client can be handled in two ways - using the standard browser print dialog or the Hatch plugin.

Standard browser print dialog

Clicking Print or Ctrl+P within the web client, the browser launches a print dialog box asking you to confirm or change printer, pages to print, and other print options. This standard browser print dialog will open everytime you print, and you will need to click print to send the job to the printer.

This option will work if you do not print from Evergreen often, you have only one or two printers, and you do not mind manually clicking Print.


Hatch is a program that supports more complex, auto-print options when specific types of print requests need to go to specific printers. For example, if you want all circulation-related slips to print to a receipt printer, but the Pull List for Hold Requests to print to a regular printer without having to select the printer and click through the print dialog, you need to use Hatch.

This option is best if you have frequent print jobs sent to different types of printers.

Configuring Hatch requires installing several applications, including Java, the Hatch Web Client extension, and the Hatch pluigin for Chrome.

Installing Hatch components

  1. Check to see if Java Runtime Environment (JRE) is installed on your computer, and make sure you have Version 8, Update 171 at minimum
    1. Install Java Runtime Environment (JRE) if not already installed on your computer, or your version is older than v.18/171 - https://java.com
  2. Run the Windows Hatch Installer (0.15) - https://evergreen-ils.org/egdownloads/ > Web Staff Client Extension ("Hatch")
  3. Install the Chrome plugin - Hatch Native Messenger

Hatch Print Service Configuration

  1. Open the web client and go to Adminsitration > Workstation
  2. Click Print/Storage Service ("Hatch")
  3. Check "Use Hatch for Printing"


ALERT! DO NOT check Store Local Settings in Hatch or Store Offline Transaction Data in Hatch - these can cause the web client to fail, aka the "white screen of death"

"White screen"

A known issue related to Hatch and Java is the "white screen of death" - staff is able to log in to the web client, but instead of opening to a normal home screen, the screen displays only the green menu bar and a blank, white page. To fix this issue follow these steps.

  1. Clear stored data
    1. Open the staff client
    2. On the keyboard, press the F12 key (this opens a side panel with developer tools)
    3. Select the Application tab - click the >> if it is not visible
    4. Click Clear Storage, verify that you are looking at the Evergreen web client, click Clear site data
    5. Close Chrome
  2. Check your installed applications
    1. Open your computer's Control Panel
    2. Under Programs, click Uninstall a program
    3. Scroll through the list of programs to verify that Evergreen ILS - Hatch - Java Based Print Service... is installed
    4. Scroll through the list of programs to verify that Java is installed, for both 32- and 64-bit versions
  3. Verify that Hatch is installed on Chrome
    1. Open Chrome
    2. Click the hamburger menu, then select More Tools > Extensions
    3. Look for Hatch Native Messenger
  4. Login to the web client and reconfigure the Hatch settings
Topic Subject Web Client
Service Evergreen
Documentation type None

Includes RT Form? No

Topic revision: r10 - 28 Aug 2018 - 09:19:11 - LindsayStratton
Evergreen.WebClientConfigurationPrinting moved from Evergreen.WebClientConfigurationPrintingHatch on 15 Aug 2018 - 15:49 by LindsayStratton - put it back

This site is powered by the TWiki collaboration platformCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding PLUM? Send feedback