Delivery zones & postcode logic
How a postcode determines delivery and installation availability.
Delivery zones & postcode logic
👤 Ops · 🛠 Dev
When a customer enters their postcode, the site determines what's available in that area — delivery and/or at-home installation — and adjusts the messaging and call-to-action accordingly.
How it works
The postcode is sent to the backend (/v1/postcode/{postcode}), which matches it against the
postcode_capabilities metaobjects and returns that area's capabilities. The storefront
receives delivery and installation_service as booleans (plus the suburb/state and an
installer calendar URL) and updates the UI — it doesn't decide eligibility itself.
So coverage is data, managed in the Shopify admin — not a hard-coded list. See the postcode capabilities appendix for the metaobject fields, and The backend API for the matching.
To open or close delivery/installation for an area, edit its postcode_capabilities entry under
Shopify Admin → Content → Metaobjects — no code change required. See Metaobjects.
For developers
The postcode lookup calls /v1/postcode/{postcode}; capabilities are resolved server-side from the
postcode_capabilities metaobjects. Selected postcode data (including the delivery and
installation_service booleans) is persisted in the browser — see
Where data lives.