Set up and tune how a store ships — what rates to charge, which regions are covered, pickup/local-delivery options, free-shipping thresholds, and diagnosing wrong or missing shipping at checkout.
Routing rule (READ FIRST). This dispatcher owns shipping setup — rates, regions, pickup, free-shipping thresholds, and diagnosing wrong/missing shipping at checkout. Post-purchase / order-execution work (mark shipped, update tracking, partial/bulk fulfill, shipping labels, packing slips, invoices, "find unshipped orders") is not yet in the routing tree — fall back to the relevant API docs or Dashboard guidance for those.
Shipping is NOT:
Before dispatching — confirm MerchantContext is loaded. If siteData.country is not in your conversation context, load it via Load Merchant Context. Skip if already loaded.
Promotion dispatch. Score each entry below by (a) the merchant's query → intent:* tags, (b) MerchantContext → context tags. Load the highest-scoring entry with ReadFullDocsArticle. Ties → highest priority. No match → follow the base recipe at the bottom.
Do not fall back to legacy flow-* slugs. The skills below replaced earlier …/skills/flow-<name> articles (e.g. flow-add-free-shipping) during the routing-tree migration. If a slug below returns a transient 404 from the docs backend (rawdocs ingestion delay on a freshly-renamed slug), retry the same URL after a brief pause — do NOT load the legacy flow-* version, which carries stale pre-migration content that contradicts this dispatcher.
API reference. All shipping endpoints (Shipping Options + Delivery Profiles) are documented inline in Shipping API Reference — there is no public dev.wix.com docs page for them, so that file is the authoritative spec. The recipes below link to it where needed.
Routing rule: After identifying the matching skill above, call ReadFullDocsArticle on it BEFORE making any API calls or offering a configuration. The exact endpoint shapes, field names, and guardrails live in the recipe — do not configure shipping from training knowledge alone. If the URL returns a 404, retry once; then try the next-best match from the list above.
[intent:setup-rates] · priority 0[intent:setup-regions] · priority 0[intent:setup-pickup] · priority 0[intent:free-shipping] · priority 0[intent:optimize-rates] · priority 0[intent:fix-coverage] · priority 0[intent:rate-incorrect] · priority 0 · audit rates via the Rate Pricing Sanity guardrail, then correct the rate structureThe agent matches the merchant's natural-language query to an intent:* tag (cues are in each file's description), AND matches MerchantContext to any context tags (e.g. country, region). All of an entry's tags must be satisfied for it to be eligible; highest tag-count wins; ties → priority.
| Merchant query | MerchantContext | Match |
|---|---|---|
| "Set up free shipping over $50" | any | ecom-shipping-free-shipping via [intent:free-shipping] |
| "How much should I charge for shipping?" | any | ecom-shipping-setup-rates via [intent:setup-rates] |
| "I want customers to pick up from my shop" | any | ecom-shipping-setup-pickup via [intent:setup-pickup] |
| "Some regions have no shipping option" | any | ecom-shipping-fix-coverage via [intent:fix-coverage] |
| "A customer was charged the wrong shipping" | any | ecom-shipping-optimize-rates via [intent:rate-incorrect] (runs rate-sanity guardrail first) |
If nothing matches, the merchant's intent is unclear. Ask one clarifying question:
"Do you want to set up shipping (rates, regions, or pickup), add free shipping, optimize your existing rates, or fix a region with no shipping option?"
Map the answer to one of the intent:* tags above and re-dispatch. Order-fulfillment requests fall outside this dispatcher — use the Order Fulfillments API or Wix Dashboard.
Last updated: 25 June 2026