--- title: Fulfillment Hub USA – Troubleshooting Product Barcodes in ShipHero description: Keep barcodes running smoothly with Fulfillment Hub USA’s ShipHero guide. Learn best practices, fix scanning and printing issues, and know when to contact support. --- [Skip to content](https://knowledgebase.fulfillmenthubusa.com/fulfillment-hub-usa-troubleshooting-product-barcodes-in-shiphero#main-content) English Show submenu for translations ![FHU-LOGO-DESKTOP.png\]](https://knowledgebase.fulfillmenthubusa.com/hs-fs/hubfs/FHU-LOGO-DESKTOP.png?height=43&name=FHU-LOGO-DESKTOP.png) Open main navigation Close main navigation - English Show submenu for translations - Go to fulfillmenthubusa.com Go to fulfillmenthubusa.com Hello. How can we help you? - There are no suggestions because the search field is empty. 1. [Fulfillment Hub USA Knowledge Base](https://knowledgebase.fulfillmenthubusa.com/?hsLang=en) 2. [Troubleshooting](https://knowledgebase.fulfillmenthubusa.com/troubleshooting?hsLang=en) # Fulfillment Hub USA – Troubleshooting Product Barcodes in ShipHero When working with **product barcodes** in ShipHero, you may occasionally see: - Barcodes that don’t scan - Barcodes that scan but don’t pull the right product - Labels that print sideways, too small, or unclear This guide walks through: 1. Best practices for barcode management 2. Troubleshooting **scanning** issues 3. Troubleshooting **printing** issues 4. What to send when you contact **ShipHero Support** --- #### Best Practices for Barcode Management To reduce barcode-related issues in daily operations, we recommend: - **Regularly audit barcode associations** - Make sure each barcode is linked to the correct SKU in ShipHero. - **Maintain label quality** - Print at proper resolution and apply labels to clean, flat surfaces. - **Keep scanners in good condition** - Clean lenses and check for physical damage. > **Tip:** Periodic **cycle counts** help catch barcode mismatches or bad labels early, before they affect live orders. --- #### Troubleshooting Barcode Scanning Problems If a barcode **won’t scan** or **doesn’t populate the expected product**, follow these steps. ### 1. Check the Label Itself - Confirm the barcode is **clean and intact**. - Avoid labels that are **faded, smudged, wrinkled, or torn**. - Make sure the barcode type is **supported** by your scanners and ShipHero. ### 2. Confirm Barcode Association in ShipHero - Open the product in ShipHero and confirm the barcode is **assigned to the correct SKU**. - If you use different barcodes (eaches, cases, lots, serials), verify they’re **configured in the right place**. > **Note:** If a SKU has multiple barcodes, scanning a **lot** or **serial** barcode may not open the product page if that barcode is not mapped as a product barcode. ### 3. Test the Scanner and Device - Gently **clean the scanner lens**. - Check scanner **settings and calibration**. - Test with **several different barcodes**: - If *no* barcodes work, the issue is likely the scanner or device. - If only some barcodes fail, the issue is likely **label quality or SKU association**. --- #### Troubleshooting Barcode Printing Issues If barcodes are printing **sideways, too small, or unclear**, use these checks. ### A. Barcodes Printing Sideways from ShipHero Mobile If labels print sideways when triggered from ShipHero Mobile: #### 1. App Versions - Confirm you’re on the **latest version** of: - The **ShipHero Workstation App** (“Check for Updates” inside the app). - The **ShipHero Mobile App** (App Store / Play Store). - Perform a **hard reset** of the mobile app (fully close and reopen it). #### 2. Hardware Compatibility - Make sure your **printer** and **barcode scanner** are on ShipHero’s recommended hardware list. #### 3. Printer Settings - Review ShipHero’s **Basic** and **Advanced Printer Troubleshooting** steps. - **Mac users:** Confirm the **CUPS** network printing service is enabled. #### 4. Product Barcode Settings in ShipHero In ShipHero Web: 1. Go to **My Account \> Settings \> Product Settings**. 2. Under **Product Barcode**, verify: - **Barcode Orientation** is set correctly (portrait or landscape). - **Barcode Width** and **Barcode Height** match your label size. - **Adjust barcode elements to the label** is selected if needed. --- ### B. Barcode Font Too Small If the barcode and/or text is too small on printed labels: 1. Go to **My Account \> Settings \> Product Settings**. 2. Under **Product Barcode**, adjust: - **Barcode Width** - **Barcode Height** 3. Print a **test label** and tweak until the barcode is readable and fits the label well. --- ### C. Barcodes Printing Unclear on Mac If barcodes look blurry or low-quality on macOS: - This is often due to the lack of **native Zebra drivers** for Mac. - Barcodes may still scan, but print quality can be sub-optimal. - A common solution is to install a **third-party driver or utility** designed for label printers on macOS (for example, tools provided by vendors like Peninsula Group). --- #### When to Contact ShipHero Support If you’ve followed the relevant troubleshooting steps and still can’t resolve the issue, it’s time to contact **ShipHero Support**. Providing detailed information up front will help them resolve your case faster: | **Issue Type** | **Information to Provide** | | --- | --- | | **Scanning Problems** | - SKU number(s) affected and the **exact barcode value(s)** \- Clear description of what happens when you scan (no result, wrong product, error message, etc.) \- Screenshots if possible (product page, barcode config, error) \- List of troubleshooting steps already tried (e.g., checked associations, tested other scanners/labels) | | **Printing Problems** | - Example **Product Barcode** that is not printing correctly \- Photos or screenshots showing **expected** vs **actual** printed output \- Printer model, connection type (USB/network), and OS (Windows/Mac) \- Steps already taken (updated apps, checked orientation/size, printer settings, installed/changed drivers) | With this information, ShipHero Support can more quickly identify whether the root cause is **configuration**, **hardware**, or a **platform bug**, and help Fulfillment Hub USA keep barcode workflows running smoothly.         - [FAQs](https://knowledgebase.fulfillmenthubusa.com/faqs?hsLang=en) - [Troubleshooting](https://knowledgebase.fulfillmenthubusa.com/troubleshooting?hsLang=en) - [General](https://knowledgebase.fulfillmenthubusa.com/general?hsLang=en) - [Reports](https://knowledgebase.fulfillmenthubusa.com/reports?hsLang=en) - [Integrations](https://knowledgebase.fulfillmenthubusa.com/integrations?hsLang=en) - [Return Management](https://knowledgebase.fulfillmenthubusa.com/return-management?hsLang=en) - [Store Integration](https://knowledgebase.fulfillmenthubusa.com/store-integration?hsLang=en) - [Platform User Guides](https://knowledgebase.fulfillmenthubusa.com/platform-user-guides?hsLang=en) - [Inventory Management](https://knowledgebase.fulfillmenthubusa.com/inventory-management?hsLang=en) - [Order Management](https://knowledgebase.fulfillmenthubusa.com/order-management?hsLang=en) [![Chill listening crop-3](https://knowledgebase.fulfillmenthubusa.com/hs-fs/hubfs/FHU_big_scaled-05.png?width=56&height=24&name=FHU_big_scaled-05.png "Chill listening crop-3")](https://fulfillmenthubusa.com) Reach out, if you need more information. Copyright © 2026, Fulfillment Hub USA