ShipStation knows if you can't print your labels, your shipping operation is at a standstill. This overview provides helpful information and an index of troubleshooting articles specifical to printing-related issues. We want you to get printing again as soon as possible!
This overview includes the following sections (click to jump to section):
- General Printing Process Information
- Printing preferences and configuration
- Possible sources of interference
- Index of available troubleshooting articles
- Error messages you may encounter.
General Printing Process
Print from ShipStation in one of two ways:
- Using ShipStation Connect
- Printing a PDF.
Using ShipStation Connect
The most common way uses ShipStation Connect to send your documents to your printer. This requires ShipStation Connect to be installed and running on the printer workstation (the computer to which your printer is directly connected).
When you tell ShipStation to print, ShipStation sends the document through the cloud to Connect. Connect passes it on to your printer driver, and that in turn passes the document on to the printer hardware.
This entire process happens behind the scenes when you click print! This process allows you to also share your printers through Connect with any other user on your ShipStation account.
Wherever they may be signed in, sharing printers gives other users the option to print to that workstation from a warehouse, an office, or a remote location in another state! As long as your printer workstation is awake, and Connect is registered, ShipStation can pass documents to your printer workstation via Connect.
NOTE: The What Connect Scenario Works for You? PDF attached at the end of this article provides more information about how ShipStation Connect works in different account setups.
Printing a PDF
View and print your documents in PDF format, either directly from your browser or by downloading the PDF to your hard drive. In this instance, the printing process happens outside of ShipStation, and ShipStation Connect is not involved. Think of it like ShipStation passing the PDF to your browser's PDF viewer (or your hard drive, if you download it). Then your computer passes the PDF to your printer driver and on to your printer.
While printing via the PDF method is not as versatile or efficient as using Connect, it's useful to have a backup print method should you need one. Also, the PDF method is a good troubleshooting step to help identify where an issue may be in the printing process.
Printing Preferences and Document Options
There are two settings that determine how documents are printed:
- Your operating system Printer Preferences
- The Document Options within ShipStation
In Windows, go to Control Panel > Devices & Printers.
In MacOS, configure preferences through CUPS.
Preferences that are configured at this level include:
- Paper size
- Print speed
- Other options that tell your printer how to print the files it receives
The most important of these is paper size. The size configuration must match the actual size of the paper the printer users (i.e. either 4in x 6in or 8.5in x 11in).
To get to the Document Options in ShipStation, go to Settings > Printing > Printing Setup.
Click Document Options to tell ShipStation in which format to create labels and packing slips. Again, these should always match the paper size of the printer you are printing to.
- Documents sent to a 4x6 label printer should be set to the 4x6 layout.
- Documents sent to a standard 8.5x11 printer should be set to the 8.5x11 layout.
Keep in mind that all labels in ShipStation are created as 4x6 labels. Selecting the 8.5x11 layout will tell ShipStation to rotate the label to fit the standard size paper.
- A mismatch between the selected document options and the printer preference paper size can have unexpected results, like the document printing too large or too small.
Possible Sources of Interference
Printing relies on communication between multiple elements. Since ShipStation is a browser-based application, it relies on your network connection to receive the label from the carrier. It then sends that label from our servers to ShipStation Connect, a locally-installed application. Connect then sends the document file to the printer driver, which sends it to your printer hardware.
Anything that interferes with this communication could cause your printing process to stop working as expected. For example, security applications or plugins that scan or block communication to/from a browser or to/from different applications can interfere with the successful transmission of a document from ShipStation to the printer.
- Temporarily disable security apps or plugins to help eliminate a possible source of interference in the communication chain. It may also tell you if you need to whitelist your ShipStation domain or add Connect to the security app's list of "safe" programs.
- Additionally, a device that gets disconnected from the workstation while Connect is running could break the link between Connect and your printers. This can occur if the printer is physically disconnected from the USB port, or if your Windows power-save preferences are set to put the USB ports to sleep after a period of inactivity. Should this happen, deactivate Connect, reconnect the printer, and then activate Connect again to re-establish communication.
Index of Printing Help Articles
Provides steps to print a test label outside of ShipStation and determine whether Connect is running properly on either Windows or Mac platform.
Provides steps to ensure Connect is installed, running, and communicating correctly with your workstation (both Windows and Mac platforms).
Provides steps to troubleshoot communication issues with Connect on Windows workstations.
Provides steps to troubleshoot communication issues with Connect on Mac workstations.
Provides troubleshooting steps for devices that disappear intermittently from the Connect settings on Windows workstations.
Provides steps to troubleshoot labels printing at the incorrect size on Windows workstations.
Provides steps to troubleshoot labels printing at the incorrect size on Mac workstations.
Provides steps to troubleshoot various print quality issues on both platforms.
Error Messages You May Encounter When Printing
Print job failed to download - Something has blocked communication between ShipStation and ShipStation Connect. Check for security apps, browser plugins, or other printing apps (like UPS Worldship) that can claim the printing process and make it unavailable to ShipStation Connect.
Print job failed to start - ShipStation Connect received the label from ShipStation successfully but was unable to transmit it to the printer driver. Check for stuck jobs in the print queue, or security apps that may need to Connect added to their list of "safe" programs.
Uncaught Node.JS error - This can occur when you attempt to launch ShipStation Connect after a printer was physically disconnected from the USB port while Connect was running.
- First, disconnect the printer.
- On Windows, end the nw.exe task in the Task Manager, plug in the device, and relaunch connect.
- On a Mac, end the ShipStation Connect item in Activity Monitor, plug in the device, and relaunch Connect.
- If the issue persists, see the uninstall and reinstall instructions in the Index of Printing Help articles above.
Application Connect cannot be launched, please contact the manufacturer - Temporarily disable any security apps and try to open Connect. For Windows users, also be sure all updates have been installed on your OS. Connect relies on certain Windows components to be up to date in order to launch Connect successfully.
If Connect shows the print job was sent successfully, but nothing prints and no error appears... This could mean you have a default printer configured, but set to an inactive instance of the device. Go to Settings > Printing > Printing Setup and reset your default printer by clicking on the option in the Print To column. Select the device you want to use as the default printer. Then test print with this new connection.