---
title: "FAQ: How does the QZ printer function work in Qargo?"
description: "Qargo now supports direct printing. Configure local printers, set different printers for document types, and print from lists and orders."
url: https://help.qargo.com/us/articles/354869-faq-how-does-the-qz-printer-function-work-in-qargo
locale: us
updated: 2026-05-28
---

# FAQ: How does the QZ printer function work in Qargo?

**Q: Can documents be printed directly from Qargo? Each time a document needs to be printed, it downloads to the computer and has to be printed from there. Is it possible to print directly from the platform?**

**_A: Printing directly from the Qargo platform is possible. This feature allows local printers to be configured within the Qargo platform._** Multiple printers can be added, and different printers can be set for different document types.\
For example, if there is a local printer in the accounts office, it can be configured for documents that need to be printed for accounts. Documents required for the planning office can be set to print on that office's local printer. Specifying local printers for individual documents makes printing convenient and efficient for users. There is no more need to track down printed documents across the business.

:::callout{tone="note"}
‼️ **Chrome 147 update:** Users on Chrome 147 or newer may see a new browser pop-up when Qargo tries to connect to QZ Tray.\
**_Click 'Allow' when prompted; this is a one-time step._**
:::

* * *

## Configuration {#h_c0877fff80}

:::callout{tone="info"}
📚 Printers are configured at the **user level**, so users can set the printer that is most convenient for their needs.

-   Check the printer status regularly to make sure it is online and properly connected.
-   Update printer drivers to the latest version to avoid compatibility issues.
:::

#### Step 1: Download and install QZ Tray {#h_bcc7076cf0}

-   QZ Tray is an application used to print from web browsers to local printers. It is required to configure printing in Qargo.

    -   Use [this link](https://qz.io/download/) to download it.

#### Step 2: Add printer configuration {#h_2cb67d346e}

-   Go to **Configuration > Printer configuration**

    ![](https://help.qargo.com/media/dc4a00b175a8-image.png)


-   In the pop-up, allow access to connect Qargo with QZ Tray.

    -   Click **Remember this decision** and click **Allow**

        ![](https://help.qargo.com/media/85054ec26314-image.png)


#### Step 3: Add or modify printers {#h_6013d7fffc}

-   **Required: _edit_** the default printer. Click the edit icon to open the configuration screen.
-   From the **Printer** field, select a default printer.
-   Modify the default number of copies printed and the printing properties (color/grayscale) as preferred.
-   Click **Save**.

::video{src="/media/video/e3c6c93fb5e5-2025-07-08_13-25-15-1-.mp4"}

-   **_To add_** and configure a printer for specific documents, click **Add printer configuration**
-   Select a local printer for a specific document or set of documents.

    -   From **Document type overrides**, select the documents associated with the specified printer. Multiple document types can be selected.

![](https://help.qargo.com/media/7c535fd51409-image.png)

:::callout{tone="info"}
💡 **Pro tip:**\
If multiple copies of a specific document are **_always_** required, configure a specific profile that includes the number of copies needed. When this document is selected for printing, the specified number of copies prints automatically.
:::

### Remove printer configuration {#h_5bdf0b0689}

-   A **Remove all printer configurations** button has been added so users can reset the printer configurations.

![](https://help.qargo.com/media/e6cbff57ee7b-image.png)

:::callout{tone="warning"}
‼️ Using this function removes **all** configured printers.
:::

* * *

## Printing documents {#h_029d7dc3bd}

### Auto-printing {#h_4360af944d}

If a workflow requires specific documents, such as labels or shipment notes, to be printed immediately after an order is created, automatic printing can be configured.

1.  **Go to printer configuration:**

    -   Go to **Settings**
    -   Select **Printer configuration**
2.  **Locate the auto-print section:**

    -   Scroll down the **Printer settings** page to the new section titled **"Auto-print documents after order creation"**

    ![](https://help.qargo.com/media/f0f90b97ad99-image.png)

3.  **Add document types:**

    -   This new section includes an option to add document types. Click the **Add document** button (or similar).
    -   A list of available document types that meet the auto-completion prerequisite appears.

    ![](https://help.qargo.com/media/48b0de0123e7-image.png)

    -   Select the specific **document type(s)** to print automatically.
    -   Repeat this step for every document to auto-print.

### Manual printing {#h_85704c6501}

-   From various **list view** pages, select the **Print** option and the document types to print (existing functionality).
-   Instead of only downloading the selected documents, users can choose to download them or print them directly to the configured printers.

![](https://help.qargo.com/media/18b30cee4024-image.png)

![](https://help.qargo.com/media/34154b5f2d98-image.png)

-   A quick action to print the task documents is now available on the order list page:

![](https://help.qargo.com/media/83b92ec6c601-image.png)

:::callout{tone="note"}
📚 If no printer is configured, the printer icon does not appear. The skip task icon appears instead.
:::

-   A new print icon has been added to the order details. Using the print button prints the document immediately.

    -   Using the execute task button only downloads the document.

![](https://help.qargo.com/media/84e6f66e2bbd-image.png)

:::callout{tone="note"}
📚 If no printer is configured in the printer configuration, this printer icon does not appear.
:::

-   Once the task has been executed and the user tries to re-trigger it, there are 2 options:

    -   **Re-trigger:** the document is simply generated again and downloaded without printing.
    -   **Re-trigger + print:** the document is regenerated and printed again.

![](https://help.qargo.com/media/c66f09047b01-image.png)

* * *

## Troubleshooting {#h_02bac4b0ab}

:::callout{tone="warning"}
‼️ ‼️ **Chrome 147 update:** Users on Chrome 147 or newer may see a new browser pop-up when Qargo tries to connect to QZ Tray.\
**_Click 'Allow' when prompted; this is a one-time step._**
:::

![](https://help.qargo.com/media/4e5787e0474c-image.png)

To **reset permissions** after the message was dismissed by mistake, use the filter icon and reset the permissions.

![](https://help.qargo.com/media/bbb722a88a92-image.png)

If documents are not printing, check the following to resolve the issue:

1.  Is the QZ client installed?
2.  Is the QZ client running?

    1.  Make sure it is set to start when the computer starts up.
3.  Is Qargo allowed to connect to QZ?

    1.  Is a setting permanently set to **Block**?

        1.  To undo the block, click the QZ menu bar icon, go to **Advanced > Site Manager** and remove the Qargo entry.

    ![](https://help.qargo.com/media/db5176420297-image.png)

4.  **Is Chrome 147 or newer in use?** From Chrome version 147 onward, Chrome shows an additional security pop-up the first time Qargo tries to connect to QZ Tray. When this pop-up appears, click **Allow** to grant permission. This only needs to be done once. After allowing it, printing works as normal.
5.  Is the printer online?

    1.  Qargo does not track printing statuses. To check whether the printer is online, open the print queue on the computer:

        -   [![](https://help.qargo.com/media/b02acc6e840d-image.png)](https://support.microsoft.com/en-us/windows/view-a-printer-s-print-queue-in-windows-71505b3a-ba6b-14b2-b7f9-fd6204675ab5)


        -   [![](https://help.qargo.com/media/96b274f80d03-image.png)](https://support.apple.com/en-ke/guide/mac-help/mchl33bd189d/mac)

6.  Has the printer to be added to Qargo been added to the operating system? To add a printer to Qargo, it needs to be registered in the OS.

    -   [![](https://help.qargo.com/media/f5692140da5a-image.png)](https://support.microsoft.com/en-us/windows/add-or-install-a-printer-in-windows-cc0724cf-793e-3542-d1ff-727e4978638b)

    -   [![](https://help.qargo.com/media/43c4ee78129a-image.png)](https://support.apple.com/en-ke/guide/mac-help/mchl33bd189d/mac)

7.  Is the default printer configured and specified?

    1.  After downloading and installing QZ Tray, step 3 of the configuration (editing the default printer) is required.

        1.  From **Configuration > Documents > Printer configuration**, go to the **Printer configurations** panel. If no printer is showing, click the edit icon and add the printer from the dropdown. Click **Save**.

![](https://help.qargo.com/media/0c5e65be12ed-image.png)

* * *

## Troubleshooting QZ Tray connection issues in Qargo for label printing {#h_0f4976fba8}

QZ Tray is essential for label printing in Qargo. However, users may encounter issues such as "no printers available," "could not connect to QZ Tray," or repeated prompts to install QZ Tray. This guide provides a complete troubleshooting approach to resolve these problems.

### Common causes of QZ Tray connection issues {#h_a84c54c579}

1.  **Browser permissions**: Chrome or other browsers may block QZ Tray because permissions were denied.
2.  **QZ Tray configuration**: Incorrect settings in QZ Tray, such as blocked entries, can prevent the connection.
3.  **Printer configuration**: Qargo may not detect printers that are not properly set up in the operating system.
4.  **Environment blockers**: VPNs, remote desktops, or security tools may interfere with QZ Tray.

### Step-by-step troubleshooting guide {#h_04e8ea080e}

### 1\. Check browser permissions {#h_35ab449866}

-   **Chrome permissions**: - Open Chrome and go to chrome://settings/content/localNetwork. - Remove any blocked entries related to localhost or Qargo. - Reload Qargo and try to print. - When prompted, allow the one-time pop-up for local network access and check **Remember this decision**.
-   **Reset site permissions**: - Click the lock icon in the browser's address bar. - Reset the site permissions for Qargo. - Refresh the page and try printing again. Allow any pop-ups that appear.

### 2\. Verify that QZ Tray is running {#h_cff5b6b54e}

-   On Windows, check the system tray (bottom-right corner). If QZ Tray is not running, open it from the **Start** menu.
-   Make sure Qargo is allowed in QZ Tray: - Go to **QZ Tray > Advanced > Site Manager**. - Remove any Qargo entries that are **Blocked**/**Denied**, or delete old entries. - Try printing again and, when prompted, click **Allow** and select **Remember this decision**.

### 3\. Refresh the printer configuration in Qargo {#h_3dc79a8d81}

-   In Qargo, go to **Configuration > Documents > Printer configuration**.
-   Click **Refresh printers**.
-   Edit the **Default** printer configuration, choose the printer from the dropdown, and click **Save**.
-   Perform a hard refresh of the page (e.g., Ctrl+F5 on Windows) if needed.

### 4\. Verify the printer setup in Windows {#h_38c3b238fd}

-   In Windows, open **Settings > Bluetooth & devices > Printers & scanners**.
-   Make sure at least one printer exists and can print a Windows test page.
-   If needed, add a printer (even a virtual one such as "Microsoft Print to PDF").

### 5\. Restart the QZ Tray and Qargo connection {#h_1163be1bc7}

-   Close all Qargo tabs.
-   Quit QZ Tray (right-click the QZ icon > **Exit**).
-   Restart QZ Tray and reopen Qargo.
-   Go to **Printer configuration**, click **Refresh printers**, and allow any prompts.

### 6\. Address environment blockers {#h_65daa79171}

-   When using remote or virtual desktops (e.g., RDP, AVD, Citrix), make sure printers are installed or redirected in that environment.
-   Temporarily disable VPN and security tools, and make sure local loopback connections for the browser and QZ Tray are permitted.

### Additional notes {#h_e8e97e037e}

-   If Chrome blocks the connection between Qargo and QZ Tray because of a previously denied permission pop-up, Qargo shows "no printers available." Make sure to allow the connection when prompted.
-   For detailed steps on resetting Chrome permissions, refer to the QZ Tray help page.

These steps resolve most QZ Tray connection issues and enable smooth label printing in Qargo.


## Related articles

- [FAQ - Install Qargo and system requirements](https://help.qargo.com/us/articles/595820-faq-install-qargo-and-system-requirements.md)
- [Print documents in bulk](https://help.qargo.com/us/articles/133836-print-documents-in-bulk.md)
- [Label generation](https://help.qargo.com/us/articles/143909-label-generation.md)
- [FAQ: Slow system performance](https://help.qargo.com/us/articles/250630-faq-slow-system-performance.md)
- [FAQ – Why is the Qargo email add-in not working?](https://help.qargo.com/us/articles/253925-faq-why-is-the-qargo-email-add-in-not-working.md)
