@wix/agent-skills 1.12.0 → 1.14.0

package/skills/wix-manage/references/ecommerce/{setup-store-pickup-location.md → shipping/ecom-shipping-setup-pickup.md}

@@ -1,9 +1,11 @@
 ---
-name: "Setup: Store Pickup Location"
+name: "Shipping: Set Up Pickup / Local Delivery"
 description: Configures a pickup option for an online store so customers can choose in-store pickup at checkout. Uses the Delivery Profiles API to discover the Pickup carrier, add a delivery region, and attach the carrier with a free pickup rate.
 ---
 # Set Up Store Pickup Location
 
+> **Routing rule:** BEFORE taking any action, call `ReadFullDocsArticle` on [Shipping API Reference](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/shipping-api-reference). The endpoint shapes for List Installed Delivery Carriers, Query Delivery Profiles, Add Delivery Region, and Add Delivery Carrier all live there. Do NOT call any of these APIs without loading it first.
+
 ## Prerequisites
 
 - Wix Stores (or another eCommerce business solution) installed on the site
@@ -11,16 +13,16 @@ description: Configures a pickup option for an online store so customers can cho
 
 ## Required APIs
 
-- [List Installed Delivery Carriers](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping#list-installed-delivery-carriers)
-- [Query Delivery Profiles](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping#query-delivery-profiles)
-- [Add Delivery Region](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping#add-delivery-region)
-- [Add Delivery Carrier](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping#add-delivery-carrier)
+- [List Installed Delivery Carriers](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/shipping-api-reference#list-installed-delivery-carriers)
+- [Query Delivery Profiles](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/shipping-api-reference#query-delivery-profiles)
+- [Add Delivery Region](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/shipping-api-reference#add-delivery-region)
+- [Add Delivery Carrier](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/shipping-api-reference#add-delivery-carrier)
 
 ---
 
 ## Step 1: Discover the Pickup carrier
 
-Call [List Installed Delivery Carriers](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping#list-installed-delivery-carriers) to find the Pickup carrier's `id`.
+Call [List Installed Delivery Carriers](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/shipping-api-reference#list-installed-delivery-carriers) to find the Pickup carrier's `id`.
 
 **Endpoint**: `GET https://www.wixapis.com/ecom/v1/delivery-profiles/installed-carriers`
 
@@ -53,7 +55,7 @@ If no Pickup carrier appears in the list, the Pickup app is not installed on the
 
 ## Step 2: Find the default delivery profile
 
-Call [Query Delivery Profiles](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping#query-delivery-profiles) to retrieve the site's default delivery profile.
+Call [Query Delivery Profiles](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/shipping-api-reference#query-delivery-profiles) to retrieve the site's default delivery profile.
 
 **Endpoint**: `POST https://www.wixapis.com/ecom/v1/delivery-profiles/query`
 
@@ -72,7 +74,7 @@ The response contains an array of `deliveryProfiles`. Find the one where `"defau
 
 ## Step 3: Add a delivery region for the pickup country
 
-If no region exists for the user's country in the default profile, call [Add Delivery Region](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping#add-delivery-region) to create one.
+If no region exists for the user's country in the default profile, call [Add Delivery Region](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/shipping-api-reference#add-delivery-region) to create one.
 
 **Endpoint**: `POST https://www.wixapis.com/ecom/v1/delivery-profiles/{deliveryProfileId}/delivery-region`
 
@@ -130,7 +132,7 @@ Save the new region's `id` from the response.
 
 ## Step 4: Add the Pickup carrier to the region
 
-Call [Add Delivery Carrier](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping#add-delivery-carrier) to attach the Pickup carrier to the delivery region.
+Call [Add Delivery Carrier](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/shipping-api-reference#add-delivery-carrier) to attach the Pickup carrier to the delivery region.
 
 **Endpoint**: `POST https://www.wixapis.com/ecom/v1/delivery-profiles/add-delivery-carrier`
 
@@ -205,4 +207,4 @@ Call [Add Delivery Carrier](https://dev.wix.com/docs/api-reference/business-solu
 
 ## Related Documentation
 
-- [API: Shipping Delivery](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/api-shipping)
+- [API: Shipping Delivery](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/shipping-api-reference)

package/skills/wix-manage/references/ecommerce/{setup-shipping-rates.md → shipping/ecom-shipping-setup-rates.md}

@@ -1,7 +1,6 @@
 ---
-name: "Setup: Shipping Rates"
+name: "Shipping: Set Up Rates"
 description: Configures shipping option rates — rate types (flat, tiered, free), condition types and operators, free shipping threshold calibration, AOV sanity check, per-item penalty avoidance, and tier gap detection.
-layer: config
 ---
 # Shipping Rates
 

package/skills/wix-manage/references/ecommerce/{setup-shipping-regions.md → shipping/ecom-shipping-setup-regions.md}

@@ -1,7 +1,6 @@
 ---
-name: "Setup: Shipping Regions"
+name: "Shipping: Set Up Regions"
 description: Configures delivery profiles and regions — creating profiles, adding regions with destinations, assigning carriers, enabling backup rates, and handling externally managed regions.
-layer: config
 ---
 # Shipping Regions
 

package/skills/wix-manage/references/sites/query-sites.md

@@ -1,37 +1,43 @@
 ---
 name: "Query Sites"
-description: Lists and queries all sites associated with a Wix account using Sites API. Covers pagination with cursor-based navigation.
+description: Lists and queries all sites associated with a Wix account using the Sites API. Covers filtering, sorting, and cursor-based pagination.
 ---
 # Query Sites
 
-This recipe demonstrates how to list and query all sites associated with a Wix account.
+This recipe demonstrates how to list and query the sites associated with a Wix account.
 
 ## Prerequisites
 
-- Account-level API access
-- Authorization for site listing permissions
+- Account-level API access (authenticated as a Wix user or using an account-level API key)
+- Permission `SITE_LIST.READ` (scope `SCOPE.ACC-DC-OS.READ-SITE`)
 
 ## Required APIs
 
 - **Query Sites API**: [REST](https://dev.wix.com/docs/api-reference/account-level/sites/sites/query-sites)
 
+> Returns up to **100** sites per request. Use cursor paging (below) to retrieve more.
+
 ---
 
-## Query All Sites
+## Query Sites
 
 **Endpoint**: `POST https://www.wixapis.com/site-list/v2/sites/query`
 
+The request takes a `query` object that supports `filter`, `sort`, and `cursorPaging`.
+
 **Request Body**:
 ```json
 {
   "query": {
-    "cursorPaging": {
-      "limit": 50
-    }
+    "filter": { "editorType": "EDITOR" },
+    "sort": [{ "fieldName": "createdDate", "order": "ASC" }],
+    "cursorPaging": { "limit": 50 }
   }
 }
 ```
 
+All three fields are optional — `{ "query": { "cursorPaging": { "limit": 50 } } }` lists every site.
+
 **Request**:
 ```bash
 curl -X POST \
@@ -40,9 +46,9 @@ curl -X POST \
   -H 'Content-Type: application/json' \
   -d '{
     "query": {
-      "cursorPaging": {
-        "limit": 50
-      }
+      "filter": { "editorType": "EDITOR" },
+      "sort": [{ "fieldName": "createdDate", "order": "ASC" }],
+      "cursorPaging": { "limit": 50 }
     }
   }'
 ```
@@ -51,75 +57,141 @@ curl -X POST \
 
 ## Response Structure
 
+The response has the sites array plus **two** paging objects: a top-level `cursorPaging`
+(echoes the applied limit and the next cursor) and `metadata` (count, `cursors.next`, `hasNext`).
+
+> ⚠️ There is **no** `pagingMetadata` field. Read paging info from `metadata`.
+
 ```json
 {
   "sites": [
     {
-      "id": "site-id-123",
-      "name": "My Website",
-      "displayName": "My Website",
-      "siteUrl": "https://username.wixsite.com/mywebsite",
+      "id": "f6061c5f-6aa3-42f8-8822-36a4981dabb2",
+      "htmlAppId": "70df538d-906c-44ca-9f27-c186b62f2b2b",
+      "name": "my-site-47",
+      "displayName": "My Site 47",
+      "createdDate": "2023-02-01T14:56:09.831Z",
+      "updatedDate": "2026-06-22T03:55:49.031Z",
       "published": true,
-      "createdDate": "2024-01-15T10:30:00Z",
-      "updatedDate": "2024-06-20T14:45:00Z"
+      "premium": false,
+      "viewUrl": "https://username.wixsite.com/my-site-47",
+      "editUrl": "/editor/f6061c5f-6aa3-42f8-8822-36a4981dabb2?editorSessionId=...",
+      "thumbnail": "/site-thumbnail/f6061c5f-6aa3-42f8-8822-36a4981dabb2",
+      "ownerAccountId": "e6a89eda-d100-4b2d-8a47-3040e2134497",
+      "contributorAccountIds": [],
+      "editorType": "EDITOR",
+      "blocked": false,
+      "namespace": "WIX",
+      "domainConnected": false,
+      "parentChildRole": "NONE"
     }
   ],
-  "pagingMetadata": {
+  "cursorPaging": {
+    "limit": 50,
+    "cursor": "<cursor-for-next-page>"
+  },
+  "metadata": {
     "count": 50,
     "cursors": {
-      "next": "cursor-for-next-page"
+      "next": "<cursor-for-next-page>"
     },
     "hasNext": true
   }
 }
 ```
 
+### Site object fields
+
+Each entry in `sites` has these fields (from the `Site` schema):
+
+| Field | Type | Notes |
+|---|---|---|
+| `id` | string | Site ID — use for site-level API calls |
+| `htmlAppId` | string | Internal HTML app ID |
+| `name` | string | URL slug / internal name |
+| `displayName` | string | Human-readable site name |
+| `createdDate` / `updatedDate` | datetime | |
+| `trashedDate` | datetime | Present only if the site is in the trash |
+| `published` | boolean | Whether the site is published |
+| `premium` | boolean | Whether the site has a Wix Premium (paid) plan |
+| `viewUrl` | string | Public site address; empty string when unpublished. **There is no `siteUrl` field.** |
+| `editUrl` | string | Relative editor path; prefix with `https://manage.wix.com` to open |
+| `thumbnail` | string | Relative thumbnail path |
+| `ownerAccountId` | string | |
+| `contributorAccountIds` | string[] | |
+| `editorType` | string | e.g. `EDITOR`, `ODEDITOR` — also a valid `filter` field |
+| `blocked` | boolean | |
+| `folderId` / `parentId` | string | Set for sites organized in folders / parent-child setups |
+| `namespace` | string | e.g. `WIX` |
+| `domainConnected` | boolean | |
+| `parentChildRole` | string | e.g. `NONE` |
+
 ---
 
 ## Pagination
 
-For accounts with many sites, use cursor-based pagination:
+Cursor-based. Read the next cursor from `metadata.cursors.next` and stop when
+`metadata.hasNext` is `false`.
+
+> The cursor does **not** carry the page limit, and it already encodes the filter/sort
+> from the first request. On follow-up pages send **only** the cursor (plus `limit` if you
+> want a non-default page size) — do **not** repeat `filter` or `sort`.
 
-**First Request**:
+**First request**:
 ```json
 {
   "query": {
-    "cursorPaging": {
-      "limit": 50
-    }
+    "filter": { "editorType": "EDITOR" },
+    "sort": [{ "fieldName": "createdDate", "order": "ASC" }],
+    "cursorPaging": { "limit": 50 }
   }
 }
 ```
 
-**Next Page** (using cursor from response):
+**Next page** (cursor from `metadata.cursors.next`):
 ```json
 {
   "query": {
     "cursorPaging": {
       "limit": 50,
-      "cursor": "<cursor-from-previous-response>"
+      "cursor": "<metadata.cursors.next from previous response>"
     }
   }
 }
 ```
 
-Continue until `hasNext` is `false`.
+**Loop**:
+```javascript
+async function listAllSites() {
+  const sites = [];
+  let cursor = null;
+  do {
+    const cursorPaging = cursor ? { limit: 100, cursor } : { limit: 100 };
+    const res = await wixRequest({ query: { cursorPaging } }); // POST .../site-list/v2/sites/query
+    sites.push(...res.sites);
+    cursor = res.metadata.hasNext ? res.metadata.cursors.next : null;
+  } while (cursor);
+  return sites;
+}
+```
 
 ---
 
 ## Common Use Cases
 
-### List All Sites
-Retrieve all sites without filtering - useful for account dashboards or site selection interfaces.
+### List all sites
+Omit `filter` and page through with `cursorPaging` until `metadata.hasNext` is `false`.
 
-### Find a Specific Site
-After querying, filter results by name or ID to locate a specific site.
+### Find a specific site
+Prefer server-side `filter` (e.g. `{ "editorType": "EDITOR" }`) and `sort` over fetching
+everything and filtering client-side. Filterable fields match the site object (e.g. `name`,
+`displayName`, `editorType`, `published`).
 
 ---
 
 ## Next Steps
 
 After finding a site:
-- Use the site ID for site-level API calls
+- Use the site `id` for site-level API calls
 - Create new sites using [Create Site from Template](create-site-from-template.md)
 - Manage site settings and content

package/skills/wix-headless/references/astro/templates/Footer.astro

@@ -1,27 +0,0 @@
----
-// ── Composer skeleton: src/components/Footer.astro ────────────────────────────
-// Substitutions (see compose.mjs):
-//   {{brand.name}} — brand name for the wordmark + copyright.
-//   {{shell.footerTagline}} — short brand-voice tagline from data.shell.
-//   {{nav.links}} — same inlined Navigation links array (mirror/subset);
-//        one <a href={href}>{label}</a> per entry, labels VERBATIM. No cart,
-//        login, or account links.
-// Fixed bulk (keep literal): transition:persist, the year expression.
-const year = new Date().getFullYear();
----
-<footer class="site-footer" transition:persist="site-footer">
-  <div class="max-w-6xl mx-auto px-6 py-16 flex flex-col md:flex-row md:items-start md:justify-between gap-8">
-    <div class="flex flex-col gap-3 max-w-prose">
-      <span class="font-display text-lg text-ink">{{brand.name}}</span>
-      <p class="text-sm">{{shell.footerTagline}}</p>
-    </div>
-    <nav>
-      <ul class="flex flex-col gap-3 text-sm">
-        {{nav.links}}
-      </ul>
-    </nav>
-  </div>
-  <div class="max-w-6xl mx-auto px-6 pb-8 text-xs">
-    <p>© {year} {{brand.name}}. All rights reserved.</p>
-  </div>
-</footer>

package/skills/wix-headless/references/astro/templates/Navigation.astro

@@ -1,38 +0,0 @@
----
-// ── Composer skeleton: src/components/Navigation.astro ────────────────────────
-// Substitutions (see compose.mjs):
-//   {{shell.navBrandMark}} — brand mark / wordmark text from data.shell.
-//   {{nav.links}} — one <a href={href}>{label}</a> per entry in the inlined
-//        Navigation links array, labels VERBATIM (no editorial rebrands). Render
-//        each inside a <li class="site-nav-item">.
-// Fixed bulk (keep literal): transition:persist, the <!-- nav:links --> marker,
-// the empty <div class="nav-actions"> mount, the mobile hamburger toggle.
----
-<header class="site-nav" transition:persist="site-nav">
-  <nav class="max-w-6xl mx-auto px-6 flex items-center justify-between gap-6 py-4">
-    <a href="/" class="font-display text-lg tracking-tight">{{shell.navBrandMark}}</a>
-
-    <input type="checkbox" id="nav-toggle" class="peer hidden" aria-hidden="true" />
-    <label
-      for="nav-toggle"
-      class="md:hidden inline-flex flex-col gap-[5px] cursor-pointer"
-      aria-label="Toggle navigation"
-    >
-      <span class="block h-[2px] w-6 bg-ink"></span>
-      <span class="block h-[2px] w-6 bg-ink"></span>
-      <span class="block h-[2px] w-6 bg-ink"></span>
-    </label>
-
-    <div
-      class="hidden peer-checked:flex md:flex absolute md:static top-full left-0 right-0 md:right-auto
-             flex-col md:flex-row gap-4 md:gap-6 items-start md:items-center
-             bg-paper md:bg-transparent border-b md:border-0 border-rule px-6 md:px-0 py-4 md:py-0"
-    >
-      <ul class="flex flex-col md:flex-row gap-4 md:gap-6 items-start md:items-center">
-        {{nav.links}}
-        <!-- nav:links -->
-      </ul>
-      <div class="nav-actions"></div>
-    </div>
-  </nav>
-</header>

package/skills/wix-headless/references/astro/templates/index.astro

@@ -1,56 +0,0 @@
----
-// ── Composer skeleton: src/pages/index.astro ──────────────────────────────────
-// Home shell. Substitutions (see compose.mjs):
-//   {{shell.heroHeadline}}, {{shell.heroSub}} — brand-voice hero copy.
-//   {{shell.footerTagline}} is NOT used here.
-//   {{brand.name}} — used in the brand-story copy.
-//   {{home-markers}} — one `<!-- home:<pack> -->` marker per LOADED pack that
-//        contributes a home section (e.g. stores, gift-cards). Emit a marker
-//        ONLY for such packs; never emit a marker no pack will fill (e.g. no
-//        <!-- home:cms --> — CMS owns brand-story directly). Disabled packs
-//        (gift-cards) still get their marker; do NOT add hero CTAs / teasers
-//        pointing at disabled-pack routes.
-// Fixed bulk (keep literal): the Layout wrapper, hero/brand-story structure,
-// the data-decorative-slot="hero" and "about" placeholders (the orchestrator
-// injects <img> into these after Image Phase 1 — keep them empty).
-import Layout from '../layouts/Layout.astro';
----
-<Layout>
-  <section class="relative">
-    <div class="max-w-6xl mx-auto px-6 py-24 grid grid-cols-1 md:grid-cols-2 gap-16 items-center">
-      <div class="flex flex-col gap-6">
-        <h1 class="font-display text-4xl md:text-5xl leading-tight">{{shell.heroHeadline}}</h1>
-        <p class="text-lg text-mute max-w-prose">{{shell.heroSub}}</p>
-      </div>
-      <div
-        class="hero-image rounded-md"
-        data-decorative-slot="hero"
-        style="aspect-ratio: 4/5; background-color: var(--color-paper-warm);"
-      >
-        <!-- orchestrator injects <img src={decorativeImages.hero} …> here -->
-      </div>
-    </div>
-  </section>
-
-  {{home-markers}}
-
-  <section class="max-w-6xl mx-auto px-6 py-24 grid grid-cols-1 md:grid-cols-2 gap-16 items-center">
-    <div
-      class="about-image rounded-md order-last md:order-first"
-      data-decorative-slot="about"
-      style="aspect-ratio: 4/3; background-color: var(--color-paper-warm);"
-    >
-      <!-- orchestrator injects <img src={decorativeImages.about} …> here -->
-    </div>
-    <div class="flex flex-col gap-4 max-w-prose">
-      <hr class="editorial-rule w-16 ml-0" />
-      <h2 class="font-display text-3xl leading-tight">The story behind {{brand.name}}</h2>
-      <p class="text-ink leading-relaxed">
-        A short, brand-contextual paragraph about what makes {{brand.name}} distinct.
-      </p>
-      <p class="text-mute leading-relaxed">
-        A second paragraph adding warmth and detail to the brand story.
-      </p>
-    </div>
-  </section>
-</Layout>

package/skills/wix-manage/references/ecommerce/goal-reduce-cart-abandonment.md

@@ -1,147 +0,0 @@
----
-name: "Goal: Reduce Cart Abandonment"
-description: Maps cart abandonment reduction to recovery automation KPIs. Covers abandoned cart email automation activation, missing sales detection, and eligibility thresholds. Also references shipping flows that affect checkout drop-off.
-layer: goal
-references:
-  - name: "Flow: Fix Coverage Gaps"
-    path: ecommerce/flow-fix-coverage-gaps.md
-    load: false
-  - name: "Recipe: Apply Shipping Recommendations"
-    path: ecommerce/recipe-apply-shipping-recommendations.md
-    load: false
-  - name: "Setup Store Pickup Location"
-    path: ecommerce/setup-store-pickup-location.md
-    load: false
----
-# Goal: Reduce Cart Abandonment
-
-> **Related skills**:
-> - [Flow: Fix Coverage Gaps](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/flow-fix-coverage-gaps) — shipping coverage gaps block checkout entirely
-> - [Recipe: Apply Shipping Recommendations](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/recipe-apply-shipping-recommendations)
-> - [Setup Store Pickup Location](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/setup-store-pickup-location)
-
-Reduce checkout abandonment caused by shipping friction — coverage gaps, unexpected costs, and missing free shipping options — by optimizing the delivery step of the checkout funnel.
-
----
-
-## Business Goal
-
-The merchant wants to reduce the percentage of customers who abandon checkout, specifically at the delivery/shipping step. Shipping-related friction is the leading cause of checkout abandonment, and the delivery step conversion rate (delivery_step_cvr) is the primary metric.
-
-**Benchmark:** A healthy delivery_step_cvr is approximately 65%. Stores below this benchmark have significant shipping-related friction.
-
----
-
-## KPIs
-
-| KPI | Definition | How to measure | Benchmark |
-|---|---|---|---|
-| Delivery step CVR | Customers completing delivery step / customers reaching delivery step | Site metrics: delivery_step_cvr | 65% |
-| Cart abandonment rate | Carts created but not converted to orders / total carts | 1 - (orders / carts) | Industry avg ~70% |
-| Free shipping qualification rate | Orders qualifying for free shipping / total orders | Track orders meeting free shipping threshold | Higher is better |
-| Revenue from recovered checkouts | Incremental revenue from improved conversion | (new_cvr - old_cvr) * checkout_sessions * AOV | - |
-
----
-
-## Triggers
-
-Activate this goal when the merchant expresses any of the following intents:
-
-- "cart abandonment"
-- "checkout drop-off"
-- "shipping friction"
-- "delivery step"
-- "people are leaving at checkout"
-- "customers not completing orders"
-- "why are customers abandoning"
-- "checkout conversion"
-- Any request about reducing drop-off during the purchase flow
-
----
-
-## Diagnostic Questions
-
-Before recommending actions, assess the root cause of abandonment. Ask or investigate:
-
-1. **Where are buyers dropping off?** — Is it specifically the delivery step, or payment, or earlier in the funnel?
-2. **Are shipping costs visible before checkout?** — Surprise shipping costs are the #1 abandonment driver.
-3. **Is there a free shipping option?** — Free shipping (even with a threshold) dramatically reduces abandonment.
-4. **Are there shipping coverage gaps?** — Customers in unserved regions cannot complete checkout at all.
-5. **Are shipping rates reasonable?** — Rates above 10-15% of order value cause sticker shock.
-6. **Are payment methods adequate?** — Missing payment options can look like shipping-step abandonment in metrics.
-7. **Are recovery emails enabled?** — Abandoned cart emails can recapture 5-15% of abandoned carts.
-
----
-
-## Recommended Actions (Prioritized)
-
-Actions are ordered by impact. Address blocking issues first, then conversion drivers, then optimization.
-
-### Priority 1: Flow: Fix Shipping Coverage Gaps (Blocking)
-
-Coverage gaps are the most critical issue — if a customer's region is not covered by any shipping option, they literally cannot complete checkout.
-
-**When to use:** When delivery profiles show regions without active shipping options, inactive regions, or missing domestic coverage.
-
-**Impact:** Removes a hard blocker. Customers in uncovered regions have 0% conversion.
-
-### Priority 2: Flow: Add Free Shipping (Conversion Driver)
-
-Free shipping is the single most effective lever for reducing cart abandonment. Even with a minimum order threshold, offering a free shipping option significantly improves delivery step conversion.
-
-**When to use:** When the store has no free shipping option, or when the existing free shipping threshold is set too high relative to AOV.
-
-**Impact:** Typically improves delivery_step_cvr by 10-20 percentage points. The threshold should be calibrated to AOV (typically 1.2x-1.5x AOV).
-
-### Priority 3: Flow: Optimize Shipping Rates (Sticker Shock Reduction)
-
-High shipping rates cause sticker shock even when coverage exists. Rate optimization ensures pricing is competitive and proportional to order value.
-
-**When to use:** When shipping rates are disproportionately high relative to product prices, or when rates lack tiered/conditional pricing.
-
-**Impact:** Reduces abandonment from price sensitivity. Most effective when combined with free shipping at a threshold.
-
----
-
-## Measurement Plan
-
-### Before optimization
-
-1. Record baseline delivery_step_cvr from site metrics
-2. Record current cart abandonment rate
-3. Identify the specific shipping configuration state:
-   - Number of active regions with shipping options
-   - Presence/absence of free shipping
-   - Average shipping rate as percentage of AOV
-
-### During optimization (weekly monitoring for 30 days)
-
-1. Track delivery_step_cvr weekly
-2. Compare week-over-week trend
-3. Monitor free shipping qualification rate (if threshold was added)
-4. Check for new coverage gaps if regions were modified
-
-### After optimization (30-day assessment)
-
-1. Calculate CVR improvement: `new_delivery_step_cvr - baseline_delivery_step_cvr`
-2. Estimate revenue recovered: `cvr_improvement * checkout_sessions * AOV`
-3. Evaluate threshold effectiveness:
-   - Free shipping qualification rate > 40% = threshold well-calibrated
-   - Free shipping qualification rate < 10% = threshold too high, consider lowering
-4. Assess whether further optimization is needed:
-   - delivery_step_cvr >= 65% = healthy, monitor quarterly
-   - delivery_step_cvr 50-65% = improving, continue optimization
-   - delivery_step_cvr < 50% = investigate non-shipping causes (payment, UX)
-
----
-
-## Decision Matrix
-
-| Scenario | Priority Action | Rationale |
-|---|---|---|
-| Regions without shipping options | Fix Coverage Gaps (P1) | Hard blocker — 0% conversion in uncovered regions |
-| No free shipping option exists | Add Free Shipping (P2) | #1 conversion driver for delivery step |
-| Free shipping exists but threshold too high | Add Free Shipping (recalibrate) | Lower threshold to match AOV |
-| High shipping rates, free shipping exists | Optimize Shipping Rates (P3) | Reduce sticker shock for below-threshold orders |
-| delivery_step_cvr >= 65% | No immediate action needed | Already at healthy benchmark |
-| Abandonment not at delivery step | Investigate other causes | Payment methods, UX, trust signals may be the issue |