Troubleshooting Label Printers — Advanced

If persistent issues remain after completing our Basic Printer Troubleshooting guide, local workstation data may be corrupt or incompatible with the current version. This article provides instructions for clearing this data to restore app functionality.

Step 1: Open the Developer Tools on the Workstation App

• Click on the ShipHero app tray icon to open the ShipHero workstation app (if you don't have the ShipHero workstation app, you can download it from How to Set Up a Workstation).
• Type Option + Cmd + i (on macOS) or Ctrl + Shift + i (on Windows) to bring up the Developer Tools.

Mac View

Windows View

Step 2: Change how the Developer Tools are displayed

Select the three-dot icon at the top right of the app page.

Choose the view that will undock the Developer Tools into a separate window.

If the window becomes hidden while switching between applications, return to the Workstation app and use the keyboard shortcut. You may need to activate the shortcut twice to toggle the window back to the foreground.

Step 3: Navigate to the Application tab to clear the app data

• Inside the Developer Tools window, navigate to the Application tab.
• Click on Clear Storage on the left side of the screen.
• Click on Clear Site Data under the purple circle. (Once you click it, data should be cleared quickly. It is okay to click the button more than once.)

Step 4: Close out the Developer Tools and refresh the workstation app

• Close the Developer Tools window.
• Refresh the workstation app by closing and then reopening the app:
  1. Right-click on the ShipHero tray icon.
  2. Click on Exit.
  3. Open the app again.
  4. You can also refresh without closing the app by clicking the ShipHero tray icon and typing Cmd + R (for macOS) or Ctrl + R (for Windows).

Escalation Process

In the event that you have completed the troubleshooting steps in our basic and advanced troubleshooting articles, please create a ticket for ShipHero Support with the following information so that we can do further troubleshooting:

• The printer model.
• The OS being used by the user (Mac or Windows).
• Confirm if the user can print correctly outside of the ShipHero application (for example, a Microsoft Word document).
• Confirm if the user can print a PDF file from ShipHero (for example, an invoice).
• Provide error logs from the workstation app:
  1. Right-click on the ShipHero tray icon:
     
  2. Select Open log directory.
  3. Attach logs to your support ticket.