---
title: "Configurable fields for ADR"
description: "This article shows how to activate and configure ADR fields so they can be used during order capture and when editing goods on a load."
url: https://help.qargo.com/us/articles/217684-configurable-fields-for-adr
locale: us
updated: 2026-05-11
---

# Configurable fields for ADR

Carriers that haul hazardous materials (HazMat) often need additional criteria when creating orders. A hazardous materials (HazMat) section can be configured in both the **Create order** screen and the **Edit goods** (freight) screen. Once this section is fully configured, all enabled fields in the ADR section are available during **Create order** and **Edit goods**.\
The **Edit columns** feature on the order list view lets users show dedicated ADR details on the list view page, giving better visibility of key data

This also applies to the customer portal. Restrictions are available so that customers who submit an order that includes hazardous materials can be required to complete the ADR fields before saving the order.

## Terminology {#h_c2db67edcd}

| **Term** | **Definition** |
| --- | --- |
| _ADR_ | The international agreement governing road transport of hazardous materials |
| _UN number_ | A four-digit code assigned by the United Nations to identify a specific hazardous substance or article (e.g., UN 3082) |
| _LQ (limited quantity)_ | A classification for hazardous materials transported in quantities below the threshold that triggers full ADR requirements |
| _Packaged item_ | A line-level item within a good on an order, used to record detailed freight information including ADR data and custom fields |
| _Customize panel_ | The column-selection interface on list views in Qargo, used to toggle which columns are visible |

### Use cases {#h_cc8db8b549}

-   Operations teams managing hazardous materials transport can isolate all ADR orders at a glance with the ADR yes/no filter, without opening each order individually.
-   Teams handling multiple ADR classes can filter by a specific UN number to locate orders with a particular substance.
-   Companies tracking waste or compliance-sensitive data at the packaged item level can show those custom fields as columns on the **Orders** list.

* * *

## Step 1: Activation of the ADR field {#h_a06493e362}

-   Navigate to **Configuration**
-   **Additional fields**
-   Select **Freight** in the left-hand menu
-   Click the edit icon (pencil) next to **ADR** and set it to **Active**.
-   Include the transportation services that ADR should show on.
-   Toggle whether ADR fields are always visible on the order
-   Toggle whether ADR is required as a mandatory field, if selected.

::video{src="/media/video/f897a1bc05bc-2024-11-23_14-18-50-1-.mp4"}

## Step 2: Configure additional ADR order capture fields.  {#h_1e462dad4f}

Once the ADR option is set to active under **Freight**, a second section titled **ADR** appears in the left-hand menu. This is where additional specific fields can be configured to show in the ADR section on the order.

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

Select the additional fields that are required on the order. Available options include:

-   ADR
-   Packaging type
-   Description
-   Emergency phone number
-   Packaging quantity
-   Technical name
-   Volume
-   Weight

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

These fields show in the ADR section that appears on the **Create order** / **Edit goods** screens.

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

## \
Optional / required field settings {#h_dd71007630}

:::callout{tone="note"}
When **Set field as required** is toggled on, users creating orders in the system get a warning if required fields are **not** filled in, but **can** still **save** orders.
:::

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

If the order is saved with missing ADR details, a **Missing** note appears next to the ADR icon in the shipment on the order page.

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

### \
Customer portal {#h_d521d764ce}

If ADR fields are required on the order, customers submitting an order via the customer portal must enter the details before the order can be saved. If required data is missing, the portal user sees an error indicating what needs to be completed.

:::callout{tone="warning"}
When the **Set field as required** option is toggled on, **customer portal** users are **blocked** from creating orders with ADR items if the required fields are not filled in.
:::

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

* * *

## Viewing ADR information {#h_bcc084dc6d}

Three options on the **Orders** list:

-   A dedicated _ADR + UN number_ column displaying the ADR status, the limited quantity flag and the UN number(s) per order.
-   New _ADR_ filters: filter orders by ADR yes/no or by one or more specific UN numbers.
-   _Packaged item custom fields_ available as toggleable columns and filters on the **Orders** list.

Operations and compliance teams handling hazardous materials, waste shipments or compliance-sensitive workflows can check ADR status or packaged item details for each order right from the **Orders** list.

-   Enable the _ADR + UN number_ column via the _Customize_ panel.
-   Use the filter panel to filter by ADR presence or UN number.
-   Add packaged item custom field columns via the _ADR & packaged items_ section in _Customize_.

### Edit columns structure {#h_19daaf4cc3}

The **Edit columns** panel on the **Orders** list has been restructured into grouped sections:

-   **Goods**: contains _Product_ and _Goods description_.
-   **Freight dimensions**: contains _Quantity_, _Packaging type and quantity_, and freight dimension fields.
-   **ADR & packaged items**: contains _ADR + UN nr_ and any packaged item custom fields.

* * *

## Enabling the ADR + UN number column {#h_2ad73a67de}

-   Navigate to **Orders > Orders**
-   Open the **Edit columns** icon
-   Locate the **ADR & packaged items** section in the panel
-   Enable the **ADR + UN nr** toggle
-   View the new column on the **Orders** list. Each order displays the ADR icon (◇), the LQ icon where applicable, and the associated UN number(s).

    -   Hovering over the icon shows the full ADR details: class, UN number, packing group and HazMat points.
    -   When an order has multiple packaged items with different UN numbers, all UN numbers are shown comma-separated (e.g., ◇ 3082, 1993, 1263).

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

## Filtering by ADR {#h_7018d48ea8}

-   Select the **ADR** filter to filter orders by ADR yes/no. This quickly isolates all orders containing hazardous materials.
-   Select the **ADR number** filter to filter by one or more specific UN numbers.
-   Apply the filter. The **Orders** list updates to show only matching orders.

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

## Adding packaged item custom field columns {#h_d13a0089cd}

-   Open the **Edit columns** icon.
-   Locate the **ADR & packaged items** section.
-   Enable the custom field columns relevant to the workflow. These must first be configured as custom fields at the packaged item level in **Configuration**.
-   View the values on the **Orders** list. When an order has multiple packaged items with different values for the same custom field, the values are shown comma-separated.

* * *

## Troubleshooting {#h_300a291f63}

| **Issue** | **Possible cause** | **Solution** |
| --- | --- | --- |
| Packaged item custom field columns not visible in the Customize panel | _Packaged items_ feature flag not enabled on the tenant | Contact a Qargo admin to enable the _Packaged items_ feature flag |
| ADR column not showing UN numbers | No packaged items with ADR data exist on the order | Check that ADR information is entered at the packaged item level on the order |
| Multiple UN numbers shown for one order | Order has packaged items with different ADR substances | Expected behavior: each distinct UN number is listed comma-separated |
| LQ icon visible but no standalone LQ filter available | LQ filter not included in this release | The LQ icon is visible in the ADR column but cannot be filtered on directly in v1 |
| ADR filter not available in the filter panel | Page may need a refresh | Refresh the page and check the filter panel again |


## Related articles

- [Orders – Adding multiple packaged items on orders.](https://help.qargo.com/us/articles/567870-orders-adding-multiple-packaged-items-on-orders.md)
- [Configure a product and a product type](https://help.qargo.com/us/articles/133833-configure-a-product-and-a-product-type.md)
- [ADR: Configuration for cost/revenue charges](https://help.qargo.com/us/articles/217685-adr-configuration-for-cost-revenue-charges.md)
- [ADR 1,000 HazMat points system for planning](https://help.qargo.com/us/articles/251715-adr-1000-hazmat-points-system-for-planning.md)
- [Orders: orders list view functions](https://help.qargo.com/us/articles/133839-orders-orders-list-view-functions.md)
