Shipment settings
Intro
Shipments → Settings holds the store-wide behavior behind your queues: when merges are suggested, how shipments are created and synced, which orders are kept out of the queue entirely, and what counts as local pickup. Most merchants set these once and revisit rarely.
Carriers in this menu opens Integration → Carriers — account credentials live there.
Merge Rules
Purpose: define when StoresBoost should suggest combining shipments (feeds Merge Suggestions → Suggested by Rule). Rules are conditions only — they say which shipments may be merged together; the merge itself is the same for every rule. Merge rules are a plan feature: on a plan without it, Suggested by Rule shows an Upgrade badge and the AI assistant's merge-rule tools are unavailable.
- Open Merge Rules and click New Merge Rule.
- Fill in Rule Name, Description, Priority, Match Mode (All conditions must pass / Any condition must pass), and Status.
- Add Condition rows. Each picks an entity, a field, and a comparison:
| Entity | Fields |
|---|---|
| Order | Customer, Order Label, Payment Status, Fulfillment Status, Channel, Source, Delivery Date |
| Order Shipment | Local Pickup |
| Customer | Customer ID, Email, Name, Phone |
| Shipping Address | Address Line 1 / 2, City, State/Province, Postal Code, Country |
| Product Item | Product Name, SKU, Type, Vendor, Tags, Collections, Meta Field (key plus an optional Namespace, default custom; reads the product metafield), Shipping Group (checkout), Checkout rate code, Checkout rate name — the last three come from the order's checkout summary written by Shipping Rates; lines without one have no value |
| Shipping Method | Service, Name, Code — currently these fields carry no values in the engine, so conditions on them never block a merge; use Shipping Method Exclusions in Merge Settings instead |
| Comparison | Meaning |
|---|---|
| Must be same | All shipments in the group share the value (e.g. shipping address). Shipments that have no value for the field are ignored; if none of them has one, the condition passes — so an Order → Delivery Date condition never blocks two orders that simply never picked a date. For Shipping Address fields, a group made only of local-pickup shipments compares the pickup location instead (same location passes, different fails) |
| Must have overlap | At least one value in common (e.g. tags). Fails if any shipment has no value |
| All must be in allowed set | Every value is on your list (e.g. shipping methods that may merge). Passes when no shipment has a value; fails with an empty list |
| None can be in excluded set | No value is on your list. Passes with an empty list |
| At least one must be outside the set | Each shipment has at least one line whose value is not on your list. A line with no value counts as outside |
All comparisons ignore case and surrounding spaces.
- Save. Start conservative — Same Customer Same Address — and expand once trusted.
Typical live-goods rule: product types all in Livestock / Live Food / Add-On, Order Shipment → Local Pickup same, the five Shipping Address fields same, and Order → Delivery Date same, so two orders booked for different delivery days stay in separate boxes.
With no active rules, shipments for the same customer are eligible to merge by default. Suggestions are recalculated every minute in the background for Awaiting shipments that still have items and share a customer.
How rules sort shipments into categories
Before any pair is compared, each shipment is put into one rule = one category: the highest-priority rule whose bucket conditions it satisfies. Only same-customer shipments in the same category are compared against each other — a livestock box and a dry-goods box never merge, however similar their addresses. Bucket conditions are Product Item rows on Type, Shipping Group (checkout) or a Meta Field with All must be in allowed set, None can be in excluded set or At least one must be outside the set; a rule without such a row is a general category that takes every shipment.
Bucket matching is stricter than pairwise matching: with Type / Shipping Group and All must be in allowed set, a shipment with no product types (or a line with no checkout group) never enters the category; with a Meta Field, lines missing the key are ignored — except under At least one must be outside the set, where a missing key counts as outside. Shipping groups match by slug (supplies) or display name (Supplies).
The Automation Rules Tester shows this end to end: add up to four extra orders and it reports each shipment's category and every condition's pass or fail.
Merge Settings
Purpose: global merge behavior — one page that affects every suggestion and auto-merge.
| Setting | What it does |
|---|---|
| Auto Merge | Execute pending rule suggestions automatically instead of waiting for someone to click Combine Shipments |
| Incremental Processing | Only evaluate shipments new or updated since the last run |
| Merge Split Shipments | Whether split shipments may merge again — None, Automatic Only, Manual Only, Both |
| Don't Merge Back to Parent / Don't Merge Sibling Shipments | Guardrails for split families (manual Merge Into This still works) |
| Warn When Merging Auto-Split Shipments | Show a warning in the confirm modal |
| Merge Local Pickup to Local Pickup | Allow pickup-to-pickup merges while Auto Merge is on (with it off, pickup shipments are left out of suggestions and Merge Into This on a pickup target is refused); without Auto Merge, pickup merges simply follow the merge rules. Pickup never merges with parcels |
| Tag Merged Orders on Store + Merged Order Tag | Write a tag (default Merged) to the Shopify orders — the one place merges touch Shopify tags |
| Target Selection Strategy | Which shipment survives: Newest, Oldest, Earliest Delivery, Latest Delivery, Most Items, Least Items |
| Delivery Date Strategy / Ship-By Date Strategy | Keep Earliest, Latest, the Target's, or the Source's date |
| Shipping Method Primary Strategy | Target Keeps, Earliest Order, or Latest Order decides the combined shipment's primary method |
| Shipping Method Exclusions | Configure Exclusions — methods that must never be merged (e.g. overnight live goods) |
| Tag Shipments That Should Have Merged + mapping rows | Flag same-customer shipments that a merge rule would have combined but for a specific mismatch — see Merge Conflict Tags |
Merge Conflict Tags
Purpose: catch the "these two should have gone in one box" cases before they ship separately — two orders from the same customer, same product category, that did not merge only because the address or the delivery date differs.
- Turn on Tag Shipments That Should Have Merged.
- Add a row per mismatch you want flagged: an entity, a field (or Any field for the whole entity), and the tag name to apply. Tag names are yours; a tag that does not exist yet is created in the library the first time it is used.
- Save.
| Entity | Field | Tag | Fires when |
|---|---|---|---|
| Shipping Address | Any field | Merge Error Address | Street, city, state, ZIP or country differ |
| Order | Delivery Date | Merge Error Date | The two orders are booked for different delivery dates |
How it decides, every time the merge sweep runs (about once a minute):
- Only same-customer shipments that landed in the same merge-rule category and got as far as rule evaluation are compared — different categories, pickup vs parcel, split-family guardrails, a shipment already in another pending suggestion, or a non-modifiable status are not conflicts and are never tagged. The failed conditions are taken from the category's rule.
- Tags that do not exist yet are created red and active in the tag library. The switch is off by default; with it on and no rows, nothing is tagged. The Tags column on both Merge Suggestions lists is where the dots show up.
- Every condition the pair failed is looked up in your rows. A row with the exact field wins over the entity-wide Any field row.
- If every failed condition has a row, both shipments get those tags (address and date differ → both tags). If even one failed condition has no row, nothing is tagged — the pair was not "supposed to merge" by your definition.
- The tags are managed for you: they disappear as soon as the pair merges, the mismatch is corrected, or one shipment ships, is cancelled or merged. A tag with the same name that a person or an automation rule applied is never removed by this.
Build a View on the tags to give CS a daily list to fix addresses or call the customer. The Order → Delivery Date row only does something if your merge rules actually contain a delivery-date condition.
Shipment Settings
Purpose: how shipments are created and synced for this store, and how the lists open.
- Shipments per page — how many rows Awaiting, On Hold, Shipped, All Shipments and Local Pickup open with (15, 25, 30, 50, 80, 100, 150 or 200; default 25). Changing Per page in a table footer lasts for that visit; the next visit uses this number again
- Import Fulfilled Items — bring already-fulfilled items into local records
- Sync Pending Shipments To Provider — push queues to a connected fulfillment provider
- Re-appear Dismissed Shipments When Updated — resurface dismissed work after changes
- Hold Shipments Until Paid — on by default. Awaiting shipments whose order still owes money are parked On Hold (reason Payment pending) so they cannot be packed or labelled, and released automatically the moment the store marks the order paid. Hold when payment status is picks which statuses count: Pending (no payment captured yet — invoices, manual payment, draft orders sent for payment) and/or Partially paid (the order was edited after checkout and the customer still owes the difference). A merged shipment stays held while any of its orders owes money. Shopify fulfillment holds still take precedence, and holds you set by hand are never touched. Turn it off to ship regardless of payment
- Create Shipments For Shipped Order — when a shipped shipment's fulfillment is cancelled on Shopify, build a new Awaiting shipment for it — but only for shipments (or Shopify orders) carrying the Required shipment tag (default
unfulfill-reopen; blank creates none). Works after splits and merges and for Shopify Collective orders - Delete Existing Shipment When Filter Applied — what to do when a shipment filter matches an order that already has a shipment: None, Delete Items If Merged, Delete Whole Shipment Even Contains Other Shipments, Delete Items If Contains Other Shipments, or Create Order Alert
Save, then verify behavior on the next synced order.
Shipment Filters
Purpose: keep certain orders or items out of the packing queue when shipments are built — different from the Filter button on lists and from Views.
- Open Shipment Filters → Add Filter.
- Give it a Name and Description, then pick a Condition from Advanced → Conditions (for example product type = Digital).
- Add an action: Skip Shipment (no shipment for matching orders) or Skip Item (drop only the matching lines).
- Save. All active filters run, in creation order, every time a shipment is created from an order.
Use them for digital goods, internal SKUs, gift cards, or anything that should never appear at the bench. To keep orders out of StoresBoost entirely, use Store Filters instead — they run at import.
| Store Filters | Shipment Filters | List Filter button | |
|---|---|---|---|
| Runs | At order import | When shipments are created | While you browse |
| Effect | Skip the order or item entirely | No shipment / dropped item | Changes only what you see |
Local Pickup rules
Purpose: decide which shipments are local pickup so they land in the pickup queues instead of the parcel bench. The same page opens from Advanced → Local Pickup.
| Setting | Match |
|---|---|
| Activate Local Pickup | Master switch — when on, matching shipments are flagged automatically |
| Fulfillment Order Delivery Method | Shopify marked the fulfillment order as pick-up |
| Shipping Address Empty | No shipping address on the order |
| Shipment Tags | Shipment carries any of the listed tags |
| Shipping Item Names / Codes / Services | The shipping line contains the text you list |
See Local Pickup for the workflow once shipments are flagged.
Related
- Split & merge — where merge rules surface
- Labels & rates — carrier / warehouse prerequisites
- Advanced → Conditions — the logic shipment filters reuse
- Integration → Carriers / Warehouses — connections these settings rely on
Local Pickup
Handle counter-pickup shipments from awaiting to picked up — rules, queues, the Picked By card, and the Local Pickup Slip.
Routines
Repeatable checklists that run over a saved shipment view — combine same-customer shipments, fetch weather, add tags, print documents, and manual checks — by hand or on a schedule.