---
title: "Customer portal — Excel and CSV order export — what, why and how."
description: "A new Export button on the customer portal lets portal users download their filtered order list as CSV or Excel using admin-enabled export templates."
url: https://help.qargo.com/us/articles/764910-customer-portal-excel-and-csv-order-export-what-why-and-how
locale: us
updated: 2026-08-05
---

# Customer portal — Excel and CSV order export — what, why and how.

Portal users can download their order list as a _CSV_ or _Excel_ file using any export template a Super Admin has enabled for the portal.

## Summary {#h_690f094d02}

**What?**

-   A new **Export** button is available on the customer portal **Orders** list and **Dashboard**.
-   Portal users select from templates enabled for the portal and download a CSV or Excel file matching their current filter.

**Why?**

-   Previously, portal users could only download PDF documents. Customers who needed to export order data for their own systems had to take screenshots or ask the carrier's operations team to run exports manually.

**How?**

-   A Super Admin enables an export template for the portal with the **Available on customer portal** toggle in **Configuration > Templates > File exports/downloads**. Once it is enabled, the **Export** button becomes visible to portal users.

## Prerequisites {#h_1b61a68f96}

-   _Super Admin:_ At least one order export template must have **Available on customer portal** switched on under **Configuration > Templates > File exports/downloads**. Nothing appears on the portal until this step is complete.

## Use cases {#h_f8e0946790}

-   A freight forwarder with portal access exports filtered orders for a specific date range directly to Excel to include in its own management reporting.
-   A shipper downloads a CSV of all confirmed orders for the week to reconcile them against purchase orders, without needing to contact the carrier.

## Terminology {#h_838946e788}

| **Term** | **Definition** |
| --- | --- |
| _Customer portal_ | The Qargo web interface available to a carrier's customers for tracking and managing their shipments |
| _Export template_ | A configurable file export definition in **Configuration > Templates > File exports/downloads** |
| **Available on customer portal** | The toggle on an order export template that makes it visible to portal users |
| _Async delivery_ | Delivery of large exports by email instead of direct browser download, used when the export exceeds the direct-download size limit |

* * *

## Enabling portal exports (admin setup) {#h_84b6ccf278}

1.  **Navigate** to **Configuration > Templates > File exports/downloads**.
2.  **Select** an order export template to make available to portal users.
3.  **Enable** the **Available on customer portal** toggle on the template.
4.  **Save** the template. The **Export** button now appears on the customer portal for users of that tenant.

**Note:** Only **_order_ export templates** can be enabled for the portal. Only columns visible to portal users will contain data. Internal-only fields such as cost and margin are excluded.

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

## Using the export (portal user) {#h_5d93b78c35}

1.  **Open** the **Orders** list on the customer portal.
2.  **Apply** any required filters to narrow down the order list.
3.  **Select** the **Export** button.
4.  **Choose** the export template from the list of available templates.
5.  **Download** the file. Small exports download immediately in the browser; larger exports are delivered by email.

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

* * *

## Troubleshooting {#h_df2db72a8e}

| **Issue** | **Resolution** |
| --- | --- |
| No **Export** button visible on the portal | A Super Admin must enable **Available on customer portal** on at least one order export template |
| Template not visible in the portal export picker | Verify that **Available on customer portal** is toggled on for that specific template |
| Some fields appear blank in the export | The field is internal-only and is not exposed to portal users; adjust the export template to use portal-visible fields only |
| Export delivered by email instead of direct download | The export exceeds the direct-download size limit. This is expected behavior; check the inbox associated with the portal account |


## Related articles

- [Customer portal: How to create orders in bulk from an Excel or CSV file](https://help.qargo.com/us/articles/879687-customer-portal-how-to-create-orders-in-bulk-from-an-excel-or-csv-file.md)
- [Customer portal: create orders from templates](https://help.qargo.com/us/articles/685597-customer-portal-create-orders-from-templates.md)
- [How to configure custom export files](https://help.qargo.com/us/articles/202699-how-to-configure-custom-export-files.md)
- [How to: Generate invoice XLS/CSV export](https://help.qargo.com/us/articles/211159-how-to-generate-invoice-xls-csv-export.md)
- [Customer portal: Giving access to the customer portal](https://help.qargo.com/us/articles/133781-customer-portal-giving-access-to-the-customer-portal.md)
