Store Filters & Shipment Filters
Intro
Filters decide what ShipManta does not work on. They are built from reusable Conditions and act at two moments:
| Filter | Where | When it runs | Actions |
|---|---|---|---|
| Store Filters | Advanced → Store Filters | On import, before the order exists in ShipManta | Skip Import — do not import the order at all · Skip Item — import the order without the matching lines |
| Shipment Filters | Shipping → Settings → Shipment Filters | When shipments are built from an imported order | Skip Shipment — no shipment for this order · Skip Item — leave the matching lines out of the shipment |
They are not list filters — for saved list queues see Orders → Views and Shipments → Views.
Purpose
- Keep gift cards, digital goods, wholesale channels or test orders out of the warehouse queue entirely
- Import an order for reporting but ship only part of it (skip drop-shipped lines)
- Hold back orders that need review before a shipment is created
Create a store filter
- Open Advanced → Store Filters and click New Store Filter.
- Name it, add a Description, and pick the Condition (a saved condition from Conditions).
- Under Actions, click New Action and choose Skip Import or Skip Item. Several actions may be combined.
- Switch it Active and save.
The list shows each filter as a card — When → condition → Then → action badges (Skip import red, Skip item amber) — with an inline Active switch for managers, Edit and Delete. Use Search and All statuses / Active / Inactive to find one.
Shipment filters are created the same way from Shipping → Settings → Shipment Filters (Add Filter; action types Skip Shipment / Skip Item).
How filters evaluate
- Skip Item only removes lines that a Product item row in the condition selected. A condition made only of order-level rows matches or not as a whole, but drops nothing — pair it with a product-item row (the AI assistant's
orders_diagnosesays skip_item matched but dropped no lines when this happens). - Active filters run in creation order and every matching filter applies — a skip-item filter and a skip-import filter can both fire on the same order.
- Filters are not retroactive: activating a store filter changes future imports only; existing orders and shipments stay. What happens to an already-built shipment when a shipment filter later matches on an order update is governed by Delete Existing Shipment When Filter Applied in Shipment settings.
- Shipment-entity conditions (status, tags, printed documents) never match in a store filter — there is no shipment yet at import.
- Active Skip Import filters are also pushed to Shopify as a webhook delivery filter. The reconcile poll, the unfulfilled sync, the fulfilled sync, and the date-range backfill ask Shopify only for the orders those filters would keep — a large shop that imports one slice (for example a Collective supplier importing one retailer's orders) is never walked in full.
orders:sync-unfulfilled-from-shopify --previewprints that search string and how many orders Shopify returned, without importing them. The local filter remains the real gate; rules Shopify's search cannot express simply widen to "ask for everything". A multi-word name such as a retailer is sent as a quoted prefix (source_identifier:"Top Shelf Aquatics"*), which still matches identifiers that continue after the name (Top Shelf Aquatics - #141683). When several rows must all hold for an order to be imported (source and retailer), connect the not-rows with OR — "skip when source is not Collective or the identifier is not this retailer" — otherwise any Collective order from any retailer passes and Shopify-side scoping cannot be derived.
Why did this order not get a shipment?
Open the order and check its activity, or ask the AI assistant to diagnose it: it replays every store and shipment filter in order and names the filter and action that blocked the order, or the status gate that did. The assistant can also dry-run draft filters against a real order before you activate them.
Who can use it
Store Filters are a Pro and Enterprise feature with permissions View Store Filters / Manage Store Filters. Shipment Filters use the Settings → Shipping view / manage permissions.
Related
- Conditions — the logic filters are built from
- Shipment settings — what happens to existing shipments when a filter applies
- Automation Rules — act on matches instead of skipping them