Skip to main content
Eptura Knowledge Center

Set up PrintNode for Mail Label Printing

  1. Last updated
  2. Save as PDF

Early Access

The PrintNode section is only visible when Cloud Printing is enabled for your organization.

Level: Administrator

Your Administrator can set up the automatic mail label printing through PrintNode, a cloud-based print service. When PrintNode is enabled, labels are sent directly to your printer, eliminating manual printing or server-side print queue management. If PrintNode is not configured for your organization, or if the service is temporarily unavailable, Eptura Workplace will automatically provide a PDF label in the browser for printing via the standard print dialog. This PDF fallback supports customers who choose not to integrate PrintNode.

Contents

Prerequisites

Before setting up PrintNode in Eptura Workplace, make sure you have the following:

  • PrintNode account and API key - Your organization may already have a PrintNode account, we recommend that you heck with your IT team or facilities management before creating a new one. If you need to create an account, visit https://www.printnode.com/ and subscribe to a plan that meets your printing needs.
  • PrintNode Client installed - Download and install the PrintNode Client on the computer connected to your label printer. This is available for Windows, macOS, and Linux, and runs as a background service that connects your local printer to the PrintNode cloud.
  • Connected label printer - Your label printer must be installed and working on the computer running the PrintNode Client. When connected, the printer will appear in your PrintNode dashboard.
  • API key - Log in to your PrintNode account at app.printnode.com, then navigate to Account > API Keys. Copy your existing key or create a new one, then keep this key secure, as it provides access to your printers.
  • Printer ID - In the PrintNode dashboard, navigate to Printers, select your label printer, and write down the Printer ID (a numeric value, such as 12345678).

Set up PrintNode in Mail Preferences

Administrators can configure PrintNode in the Mail Preferences to set up the PrintNode API Key and Routing Label Printer ID, and optionally adjust label rotation and size to match their physical label stock.

Step 1. Complete the PrintNote settings

From Eptura Workplace, complete the following:

  1. Log in to Eptura Workplace as an Administrator.
  2. Navigate to Admin > Mail > Preferences.
  3. Scroll down to the PrintNode (Mail Labels) section.

clipboard_4ef178bf-d620-4a89-bc4c-a2669a288e4b.png

  1. In the PrintNode API Key, enter the API Key from your PrintNote account. If you prefer to use browser-based PDF printing instead of automatic printing, leave this field blank.
  2. In the Routing Label Printer ID field, enter the numeric Printer ID from your PrintNode dashboard. This printer will be used for all mail routing labels.

Step 2. Optional - Adjust Print Rotation

If your labels print in the wrong orientation, you can adjust the rotation.

We recommend starting with the default setting. Only change the rotation if labels are consistently printing sideways or upside-down.

clipboard_4c423a5c-3b15-419a-b770-08f672f505c6.png

  • In the Rounting Print Rotation drop-down, the default displays as Use printer default. This setting will work correctly for most printers. The other settings are 0, 90, 180, or 270 degrees.

Step 3. Optional - Adjust Label Size

If needed, you can customize the label size and orientation.

We recommend using the default settings as these work with most label printers. Only change the setting if you experience sizing or orientation issues.

clipboard_31cda055-ff56-4f83-9c2c-27c5ac30f1fa.png

  1. From the Routing Label Size drop-down, the default displays as Use template dimensions. The other settings are 59 x 102 mm, 62 x 100 mm, 4 x 6 in, or other presets.
  2. From the Routing Label Orientation drop-down, the default displays as Use template orientation. The other settings are Portrait, or Landscape.

Step 4. Save your Settings

  1. Scroll to the bottom of the Mail Preferences page.
  2. Click the Apply Button to save the settings. 

Step 5. Test your PrintNote Integration

After saving your configuration, test it by printing a label:

  1. Navigate to Mail > Search for a Mail Item.
  2. Select a mail item.
  3. Click the Actions button.
  4. Select Print Label.

clipboard_74923703-ed7f-4f2e-a3e1-88560fb0b012.png

If everything is configured correctly, the label will print automatically and you will see the message "Label sent to printer."

If you choose not to use PrintNode, or if the service is temporarily unavailable, Eptura Workplace automatically provides a PDF for browser-based printing.

Troubleshooting

Situation Resolution
Labels are not printing
  • Verify that the PrintNode API key is correct and has not expired.
  • Confirm the Printer ID matches the printer in your PrintNode dashboard.
  • Make sure the PrintNode client is running on the computer connected to the printer.
  • Check that the printer is online and loaded with labels.
  • Review the print job status in the PrintNode dashboard.
Labels print in the wrong orientation
  1. Navigate to Admin > Mail > Preferences.
  2. Adjust the Print Rotation setting and try different values (0, 90, 180, 270 degrees).
  3. Save your changes and test again.
Labels print at the wrong size
  1. Navigate to Admin > Mail > Preferences.
  2. Change the Label Size setting to match the physical labels loaded in your printer.
  3. Common sizes: 4 x 6 in (standard shipping), 59 x 102 mm, or 62 x 100 mm.
PDF opens instead of automatic printing

This occurs when:

  • The PrintNode API key or Printer ID field is blank.
  • The PrintNode service is unreachable.
  • The API key is invalid or expired.

To resolve this, verify that your API key and Printer ID are entered correctly, and check your PrintNode account status.