30 days free. No credit card. Full access from the moment you connect your site.

Start free trial

List Shipping Zones

store/list-shipping-zones lists the shipping zones on the store with the regions each covers and the methods offered in each, plus the “rest of the world” fallback.

That fallback is the part worth checking.

At a glance

Abilitystore/list-shipping-zones
ToolsetWooCommerce — toolset/woocommerce
GroupWooCommerce › Store Configuration
RequiresWooCommerce, active on the site
Capabilitymanage_options
SafetyRead-only — changes nothing
RepeatableIdempotent — running it twice leaves the same result
Ships inAcrossAI Abilities Manager 0.0.34 and later

How it works

A customer whose address matches no zone is offered the methods in the rest-of-the-world zone. When that zone is empty — which is extremely common, because it is created automatically and rarely touched — they are offered nothing, and cannot complete checkout at all.

The checkout does not explain this. The customer sees no shipping options and, usually, gives up. The shop owner hears “your site is broken” with no detail, and nothing in WooCommerce points at the cause.

So this listing reports that zone explicitly alongside the configured ones. An empty rest-of-the-world zone with international customers is a diagnosis, not a detail.

Zones are matched in order, and the first match wins — so a broad zone sitting above a narrow one means the narrow one never applies.

Input

This ability takes no input.

What comes back

NameTypeWhat it is
zonesarrayEach zone with its regions and methods.
rest_of_worldobjectThe fallback zone and what it offers.
countintegerHow many zones are configured.
notestringAny warning about the fallback.
successbooleanWhether the call completed.
messagestringA one-line summary of what happened, suitable for showing a human.
error_codestringPresent only on failure — a stable machine-readable reason, such as a missing field, a wrong field type or an unmet confirmation.

Example

Ask your assistant:

A customer says they could not check out — what are our shipping zones?

It resolves to one call:

{
  "ability": "store/list-shipping-zones",
  "parameters": {}
}

Worth knowing

  • An empty rest-of-the-world zone means unmatched customers cannot check out.
  • Zones match in order; the first match wins.
  • A zone with regions but no methods behaves the same as an empty one.

Related abilities


Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager

Browse the rest: Every ability, by category


Keep reading