> ## Documentation Index
> Fetch the complete documentation index at: https://www.zippendo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Search and filters

> Search and filter orders, shipments, and other lists — draft-then-apply Filters popover, status, type, brand, and empty results.

Most list headers use the same **Filters** popover: you draft values, then click **Add filters**. Nothing hits the URL until you apply. Tooltip on the sliders button: **Click to filter results**.

Orders journey: [Orders](/docs/tutorials/orders). Dashboard charts and CSV: [Dashboard](/docs/tutorials/dashboard), [Dashboard CSV export](/docs/how-to/dashboard-csv-export).

## How the popover works

Title **Filters**. Footer **Add filters**. **Clear all filters** appears only when something is already applied.

Each **FilterSelect** starts with **All** (unless that field overrides the label). Placeholder **Select…**. Search fields use label **Search**.

Counts on the trigger use **\{\{count}} selected**. Changing a control does **not** refetch until **Add filters**. Closing the popover without applying discards the draft.

Empty tables still use that screen’s empty copy (for example orders: **No orders found** / **Orders will appear here when they are synced from your order channels**).

## Dashboard has no search

The dashboard header is **Updated \{\{time}}**, **Refresh**, and **Export CSV** — not a search box. Refresh aria: **Reload dashboard data**. While fetching: **Refreshing data…**. Toasts: **Dashboard updated** / **Could not refresh dashboard**. The **Cargo shipping list** on the same page also has no search.

<Frame caption="Dashboard header — last updated, Refresh, and Export CSV; no Filters control">
  <img src="https://mintcdn.com/zippendo/OJ9RTi9o5Q3_r39V/images/how-to/search-and-filters/04-dashboard-no-search-light.png?fit=max&auto=format&n=OJ9RTi9o5Q3_r39V&q=85&s=f7de23dc442e145f16d0400f1c163afb" alt="Dashboard with Updated time, Refresh, and Export CSV in the header" className="block dark:hidden" width="2880" height="1800" data-path="images/how-to/search-and-filters/04-dashboard-no-search-light.png" />

  <img src="https://mintcdn.com/zippendo/OJ9RTi9o5Q3_r39V/images/how-to/search-and-filters/04-dashboard-no-search-dark.png?fit=max&auto=format&n=OJ9RTi9o5Q3_r39V&q=85&s=a9f430fec9f39b9becc543a8ae1636f8" alt="Dashboard with Updated time, Refresh, and Export CSV in the header" className="hidden dark:block" width="2880" height="1800" data-path="images/how-to/search-and-filters/04-dashboard-no-search-dark.png" />
</Frame>

## Orders

URL: `/{org}/dashboard/orders`. Channel from the sidebar is `?channel=` — **not** inside this popover.

<Frame caption="Orders Filters — Search and Status">
  <img src="https://mintcdn.com/zippendo/OJ9RTi9o5Q3_r39V/images/how-to/search-and-filters/01-orders-filters-light.png?fit=max&auto=format&n=OJ9RTi9o5Q3_r39V&q=85&s=4014fd298a437f9ef1bd71c5a8be4d9f" alt="Orders Filters popover with Search placeholder Search and Status All" className="block dark:hidden" width="2880" height="1800" data-path="images/how-to/search-and-filters/01-orders-filters-light.png" />

  <img src="https://mintcdn.com/zippendo/OJ9RTi9o5Q3_r39V/images/how-to/search-and-filters/01-orders-filters-dark.png?fit=max&auto=format&n=OJ9RTi9o5Q3_r39V&q=85&s=88167953e70d8aeb27e26904082d2262" alt="Orders Filters popover with Search placeholder Search and Status All" className="hidden dark:block" width="2880" height="1800" data-path="images/how-to/search-and-filters/01-orders-filters-dark.png" />
</Frame>

| Field      | Details                                                                                                                     |
| ---------- | --------------------------------------------------------------------------------------------------------------------------- |
| **Search** | Placeholder **Search…**. Matches **order number**, **customer name**, or **customer email** (case-insensitive contains).    |
| **Status** | **All**, **Pending**, **Processing**, **Partially Fulfilled**, **Fulfilled**, **Cancelled**, **Error**.                     |
| **Brand**  | House view only, when brands exist. **All brands**, **No brand**, or a brand. Brand-restricted members do not see a picker. |

When `?channel=` is set, the page description is **Showing orders from** that channel, with **View all orders**.

## Shipments

URL: `/{org}/dashboard/shipments`.

<Frame caption="Shipments Filters — Search, Status, and Type">
  <img src="https://mintcdn.com/zippendo/OJ9RTi9o5Q3_r39V/images/how-to/search-and-filters/02-shipments-filters-light.png?fit=max&auto=format&n=OJ9RTi9o5Q3_r39V&q=85&s=fb1345b4caf54d985db7e26b7a635994" alt="Shipments Filters popover with Reference or tracking number, Status, and Type" className="block dark:hidden" width="2880" height="1800" data-path="images/how-to/search-and-filters/02-shipments-filters-light.png" />

  <img src="https://mintcdn.com/zippendo/OJ9RTi9o5Q3_r39V/images/how-to/search-and-filters/02-shipments-filters-dark.png?fit=max&auto=format&n=OJ9RTi9o5Q3_r39V&q=85&s=efb4b514eb8d54e2eb705e07354d5dab" alt="Shipments Filters popover with Reference or tracking number, Status, and Type" className="hidden dark:block" width="2880" height="1800" data-path="images/how-to/search-and-filters/02-shipments-filters-dark.png" />
</Frame>

| Field      | Details                                                                                                                        |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------ |
| **Search** | Placeholder **Reference or tracking number**. Matches shipment **reference** **or** a parcel **tracking number**.              |
| **Status** | **All**, **Draft**, **Pending**, **Processing**, **Dispatched**, **Partly Dispatched**, **Error**, **Cancelled**, **On Hold**. |
| **Type**   | **All**, **Outbound**, **Inbound**.                                                                                            |
| **Brand**  | Same house-view picker as orders.                                                                                              |

<Frame caption="Applied search for a tracking number on the shipments list">
  <img src="https://mintcdn.com/zippendo/OJ9RTi9o5Q3_r39V/images/how-to/search-and-filters/03-shipments-tracking-search-light.png?fit=max&auto=format&n=OJ9RTi9o5Q3_r39V&q=85&s=c10c97431818e5b1c54f36c12f67f906" alt="Shipments list after applying a Reference or tracking number search" className="block dark:hidden" width="2880" height="1800" data-path="images/how-to/search-and-filters/03-shipments-tracking-search-light.png" />

  <img src="https://mintcdn.com/zippendo/OJ9RTi9o5Q3_r39V/images/how-to/search-and-filters/03-shipments-tracking-search-dark.png?fit=max&auto=format&n=OJ9RTi9o5Q3_r39V&q=85&s=9f31d3b3b95d1208dd0eaaeec00f83af" alt="Shipments list after applying a Reference or tracking number search" className="hidden dark:block" width="2880" height="1800" data-path="images/how-to/search-and-filters/03-shipments-tracking-search-dark.png" />
</Frame>

Empty: **No shipments found** / **Get started by creating your first shipment**, button **Create Shipment**.

## Other lists (same popover)

These screens share the control. Field-level pages cover the rest of each UI.

| Screen                               | Filter fields                                                                                                               | How-to                                               |
| ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
| **My Carriers** (`?tab=my-carriers`) | **Search** (**Search…**), **Brand** with scope toggle. **All Carriers** has **no** filter.                                  | [Carrier credentials](/docs/how-to/carrier-credentials)   |
| **Shipping Rules**                   | **Search**, **Carrier**, **Brand** (scope toggle)                                                                           | [Shipping rule fields](/docs/how-to/shipping-rule-fields) |
| **Pickups**                          | **Status** (**Pending**, **Confirmed**, **Failed**, **Cancelled**), **Carrier**, **Brand** (scope toggle). No search.       | [Schedule a pickup](/docs/how-to/schedule-a-pickup)       |
| **Automations**                      | **Search**, **Status** (**Draft**, **Active**, **Paused**), **Brand** (scope toggle)                                        | [Automations](/docs/how-to/automations)                   |
| **Printers**                         | **Search**, **Status** (**Active**, **Pending Approval**, **Disabled**), **Type** (**Label printer**, **Document printer**) | [Add a printer](/docs/how-to/add-a-printer)               |
| **Addresses** (Manage → Addresses)   | **Search**, **Country**, **Brand** (scope toggle)                                                                           | [Sender addresses](/docs/how-to/sender-addresses)         |
| **Team** (Manage → Team)             | **Search** only                                                                                                             | [Invite team members](/docs/how-to/invite-team-members)   |
| **Webhooks** (Manage → Webhooks)     | **Search**, **Active** (**Yes** / **No**), **Brand** (scope toggle)                                                         | [Webhooks](/docs/how-to/webhooks)                         |

**Carrier Requests** has no filter — [Request a carrier integration](/docs/how-to/request-carrier-integration).

### Brand scope (house vs brand session)

On lists that pass `scopeToggle` (carriers, shipping rules, pickups, automations, addresses, webhooks):

| Session              | Control                                                                     |
| -------------------- | --------------------------------------------------------------------------- |
| Organization (house) | **Brand**: **All brands**, **No brand**, or a brand                         |
| Inside a brand       | **Brand**: **All records**, **Only this brand**, **Organization-wide only** |

Orders and shipments never show the scope toggle — they always list that brand’s (or the house’s) rows. Locked members: [Switch organization and brand](/docs/how-to/switch-organization-and-brand).

## Related

* [Orders](/docs/tutorials/orders)
* [Dashboard](/docs/tutorials/dashboard)
* [Dashboard CSV export](/docs/how-to/dashboard-csv-export)
* [Inbound and returns](/docs/how-to/inbound-and-returns) — **Type** = **Inbound** on shipments
