Search and filter shipments

Documentation Team · Updated

The Shipments list page supports two search modes and a filter panel. Use basic search for quick lookups by tracking number or order ID, and advanced query when you need to combine specific fields and operators.

For how to save a particular search + filter + column layout for repeat use, see Saved views, filters, and columns.

Shipments list with search and filter controls

Type into the search box and click Search (or press Enter). Basic search matches on:

  • Shipment tracking number
  • The order’s external ID

For example, typing 1Z999 returns shipments whose tracking number starts with 1Z999.

Advanced query

Click the </> icon at the right of the search box to switch to advanced mode. The advanced field accepts a Lucene-style query — for example:

state:new AND tracking_number:1Z*

Combine fields with AND, OR, and NOT. Wildcards (*) are supported on text fields.

Advanced query field

Filter panel

Click Filter by to open the filter menu. Each filter is a separate facet that ANDs with the search query.

Filter by dropdown showing Status, Merchant, Sales Channel, Date

Filter What it does
Status One or more shipment states. See Shipment statuses.
Merchant Restrict to one merchant — useful in 3PL accounts that fulfill for multiple merchants.
Sales Channel Restrict to a single store (the source sales channel of the underlying order).
Date Filter on shipped_at — preset ranges (Today, Last 7 days, etc.) or a custom range.

Selecting a Status filter shows the available options:

Status filter options

Sort

Click a column header with a sort caret to toggle the sort direction. See List shipments for which columns are sortable.

To clear search, filters, and sort and return to the page’s built-in defaults, click the view selector at the right end of the toolbar and pick Default View.

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.