Important: Yuzu Print Extension is not the primary print integration method for most Yuzu customers using ShipHero. The recommended ShipHero setup is usually the Swap Invoice Flow Action, where Yuzu replaces the ShipHero invoice and ShipHero's own print flow handles printing. Start with the published guide: ShipHero Integration. Use this Print Extension guide only when your Yuzu team has specifically chosen the extension workflow.
Use this guide to print Yuzu documents while your team works in ShipHero. ShipHero supports printing from selected orders in the order list and from a single ship order screen.
Before you start
Install the Yuzu Print Extension in Chrome.
Sign in to ShipHero in the same Chrome profile where the extension is installed.
Confirm that your team should use Yuzu Print Extension for ShipHero. If your team uses Yuzu invoice swaps in ShipHero, follow ShipHero Integration instead.
Set up your Yuzu API key and App ID. See the shared guide: Create a Yuzu API key and choose an App ID.
Set up printer routing if you need documents to go to a specific printer. See the shared guides: Find printer IDs and set a printer override and Set up tag-based printer routing in Yuzu Print Extension.
If you need to copy the same settings to another packing bench, see the shared guide: Share Yuzu Print Extension configuration between benches.
If operators need help understanding success, warning, or error messages, see the shared guide: Understand Yuzu Print Extension notifications.
Supported workflows
ShipHero workflow | What it is for | Manual print | Auto-print |
Batch Order Selection | Print Yuzu documents for one or more selected orders from the ShipHero order list. | Yes | No |
Single Ship Order | Print Yuzu documents while shipping one order. | Yes | Yes |
3PL mode: No. ShipHero does not currently support Yuzu 3PL merchant mappings in the extension.
Custom domains: No. Use the standard ShipHero domains supported by the extension.
Choose the right App ID
Use the App ID pattern that matches how your ShipHero order IDs are stored in Yuzu.
Use the source app ID when the order IDs shown or opened in ShipHero match the source IDs for that app in Yuzu.
Use the org/team ID when the IDs being printed from ShipHero are unique within your Yuzu team.
If you are not sure which one applies, run a test print on one known order and confirm that Yuzu finds the expected order. For the full setup flow, see the shared guide: Create a Yuzu API key and choose an App ID.
Configure Yuzu settings for ShipHero
Open the Yuzu Print Extension settings.
Confirm ShipHero is selected as the platform.
Confirm your Yuzu API key and App ID are saved.
If every ShipHero document should go to one printer, use Specify Printer Override with Static Printer ID. See Find printer IDs and set a printer override.
If different document types should go to different printers, use Specify Printer Override with Tag-Based Routing. See Set up tag-based printer routing in Yuzu Print Extension.
Save the settings.
Common document tags are Invoice, Gift message, and Sticker.
Print selected orders from the ShipHero order list
Use this workflow when you want to print documents for more than one order, or when your team prints from the ShipHero order list.
Open the ShipHero order list your team uses.
Select the orders you want to print.
Click the Yuzu print button in the ShipHero order actions area.
Wait for the extension notification that confirms the print request was sent.
Check the printer output or Yuzu print history if you need to confirm the result.
Auto-print is not currently supported for the ShipHero order list workflow. Operators need to select the orders and click the Yuzu print button.
Print from a single ShipHero ship order
Use this workflow when an operator opens one ShipHero order to ship it.
Open the ShipHero single ship order screen.
Confirm you are on the order you want to print.
Click the Yuzu print button next to the ShipHero print action, or let auto-print run if your team enabled it.
Wait for the extension notification that confirms the print request was sent.
Check the printer output before completing the shipment if your process requires it.
Enable auto-print for Single Ship Order
Auto-print is available for the ShipHero Single Ship Order workflow.
Open the Yuzu Print Extension settings.
Confirm ShipHero is selected as the platform.
Find Auto-print on Single Ship Order.
Turn it on.
Optional: turn on Disable auto-print for order after a successful print if operators may revisit the same order and should not print it again automatically.
Save the settings.
Open a known ShipHero single ship order and confirm the expected Yuzu documents print.
Use auto-print only where the single ship order screen is a reliable point in your warehouse process to print Yuzu documents. If operators may open orders for checking or editing without wanting to print, keep auto-print off and use the manual button.
Test the setup
Choose one ShipHero test order that already exists in Yuzu.
Confirm the order has the Yuzu documents you expect, such as
Invoice,Gift message, orSticker.Test the order list workflow by selecting the order in ShipHero and clicking the Yuzu print button.
Test the single ship order workflow by opening the order in ShipHero and clicking the Yuzu print button.
If auto-print is enabled, reload or reopen the single ship order and confirm the document prints once.
Confirm the document reaches the expected printer.
If using tag-based routing, confirm each document tag reaches the intended printer.
Troubleshooting
The Yuzu print button does not appear in ShipHero: Refresh the ShipHero page, confirm the Yuzu Print Extension is installed and enabled, and confirm ShipHero is selected in the extension settings. If the page was already open before installing or changing settings, close and reopen the ShipHero tab.
The order does not print: Confirm the Yuzu API key and App ID are saved correctly. Then test with a known order that already exists in Yuzu.
Yuzu cannot find the order: Recheck the App ID choice. Use the source app ID when ShipHero IDs match the source IDs in Yuzu, or the org/team ID when the printed IDs are unique within the Yuzu team. See Create a Yuzu API key and choose an App ID.
Documents print to the wrong printer: Check Specify Printer Override. For one printer, confirm the Static Printer ID is correct. For multiple printers, confirm each Document Tag and printer match your setup. See Find printer IDs and set a printer override or Set up tag-based printer routing in Yuzu Print Extension.
Only some document types print: Confirm the order has those documents in Yuzu and that the tag names match exactly, including spaces and capitalization.
Auto-print runs when the operator does not expect it: Turn off Auto-print on Single Ship Order, or turn on Disable auto-print for order after a successful print if repeat visits are causing duplicate prints.
A printer is offline or unavailable: Check the printer status in Yuzu and retry after the printer is online. See Understand Yuzu Print Extension notifications for common notification meanings.
Your team uses ShipHero invoice replacement: Use the ShipHero Integration guide. That flow uses Yuzu's Swap Invoice Flow Action and ShipHero's own print app, rather than Yuzu Print Extension.
Your team uses 3PL merchant routing: ShipHero does not currently support Yuzu 3PL mode in the extension. Use a non-3PL setup for ShipHero or confirm the required workflow with Yuzu support before rollout.
Your ShipHero account uses a custom domain: Custom-domain setup is not currently supported for ShipHero. Use the standard ShipHero domain supported by the extension.