Agent Skill · Wix

wix-manage

Wix business solution management recipes — REST API operations for configuring and managing Wix business solutions. Routes to: stores, bookings, get-paid, CMS, contacts, events, forms, media, app-installation, pricing-plans, restaurants, rich-content, sites, blog, calendar, domains, site-properties, ecommerce.

View SKILL.md on GitHub → Source repository Provider profile

Provider: Wix Path in repo: skills/wix-manage/SKILL.md

Skill body

Management Recipes Index

Standard call shape for every curl example across these recipes. The <AUTH> placeholder in example curls is shorthand for the Authorization header only; every actual call ALSO needs wix-site-id: <SITE_ID> and Content-Type: application/json. POST/PATCH against wix-data/*, form-schema-service/*, stores/v3/*, blog/v3/*, and other site-scoped REST families return 403 without wix-site-id — observed seeder regression cost ~100 s rediscovering this on a 2026-05-24 run. Mint the token via npx @wix/cli token --site "$SITE_ID".

What Are Management Recipes?

Management recipes are for REST API operations that configure, set up, and manage Wix business entities on your site. These recipes use REST API calls and are designed for:

Site setup and configuration — Initial setup of stores, bookings, payments, and other business apps
Entity management — Creating, updating, and deleting products, services, staff members, pricing plans
Administrative operations — Bulk updates, contact labeling, data migrations
Backend integrations — Server-to-server automations, webhooks, data synchronization

These recipes do NOT cover frontend development or SDK usage for displaying data to users.

App Installation

Install Wix Apps

Technical: Installs Wix apps on a site using Apps Installer API. Covers enabling Velo (Wix Code), app installation, and common app definition IDs.

List Installed Apps

Technical: Lists all apps installed on a site using Apps Installer API. Useful for verifying app installations before making API calls and diagnosing authorization errors.

Blog

How to Create Blog Posts

Technical: Creates and publishes blog posts using Blog Posts API. Covers Ricos rich content format, image upload via Media Manager, category/tag assignment, and bulk post creation.

Bookings

Booking Service Policy Setup

Technical: Sets up booking policies, cancellation rules, and waitlist configuration using the Services API policy fields. Covers bookingPolicy, cancellationPolicy, and waitlist settings.

Booking System Integration Gaps

Technical: Documents undocumented API patterns for booking payments. Covers Bookings→Ecommerce integration, booking ID transformation to catalog items, and async payment confirmation flows.

Bookings Staff Setup

Technical: Creates staff members and configures custom working hours using Staff API + Calendar Events API. Critical two-step process: create staff → assign schedule → create working hours events.

Create and Update Booking Services

Technical: Full CRUD operations for Wix Bookings services using Services API. Covers service types (APPOINTMENT, CLASS, COURSE), pricing configuration, location setup, and schedule management.

End-to-End Booking Flow

Technical: Complete booking flow from service discovery to payment. Query services, check availability with Time Slots V2, create bookings, and process payment via eCommerce checkout.

External Calendar Integration

Technical: OAuth-based integration with Google Calendar, Microsoft Outlook, and Apple Calendar. Covers authentication flows, sync configuration, and bidirectional event management.

Multi-Resource Service Creation

Technical: Creates resource types and individual resources using Resources API. Enables services that require multiple resources (rooms + equipment + staff) with automatic allocation.

Calendar

Configure Default Business Hours

Technical: Uses Calendar Events API to create WORKING_HOURS events on the business schedule. Covers the critical distinction between Calendar Events API (correct) vs Site Properties API (incorrect) for setting base availability.

CMS

CMS Data Items CRUD

Technical: Add, query, update, and delete items in CMS collections. Use this to insert content, bulk insert/update/patch/delete items, query with filters, and manage collection data. Key endpoints: /wix-data/v2/items, /wix-data/v2/bulk/items/*.

CMS Data Operations Extended

Technical: Additional CMS data operations including count, upsert (bulk save), and update by filter patterns.

CMS eCommerce Catalog Integration

Technical: The recommended way to sell existing CMS collection items (tickets, bookings, memberships) through Wix checkout. Add the CATALOG plugin to convert any CMS collection into purchasable products with cart and payment integration.

CMS References & Relationships

Technical: Add, replace, or remove items from MULTI_REFERENCE fields. Use insert-references, replace-references, remove-references endpoints. Required for managing multi-reference relationships - these CANNOT be set via regular insert/update/patch operations. Also covers single references and querying with expanded references.

CMS Schema Management

Technical: Create and modify CMS collection structures. Covers listing collections, creating collections with fields, adding/removing fields, and updating collection settings.

Contacts

Bulk Delete Contacts

Technical: Deletes multiple contacts using filter-based bulk delete. Covers safe deletion patterns, GDPR compliance, soft delete alternatives, and batch processing strategies.

Bulk Label and Unlabel Contacts

Technical: Adds/removes labels from multiple contacts using Contacts API bulk operations. Covers label creation, contact filtering, batch processing, and rate limit handling.

Domains

Domain Search and Purchase

Technical: Search for available domains, get domain suggestions, and generate purchase links using Domain Search V2 API. Covers availability checks, TLD filtering, and connecting domains to Wix sites.

eCommerce

Routing — pick the right entry point:

Any sales/business improvement request (boost sales, promotions, help my business, holiday deals, improve revenue, discounts, shipping, coupons, clearance) → use Recommend: eCommerce Strategy. This is the default entry point — it analyzes ALL domains (discounts, shipping, future: gift cards, taxes) and generates cross-domain recommendations. Do NOT ask clarifying questions.
Apply previously generated shipping recommendations → use Recipe: Apply Shipping Recommendations
Store pickup configuration → use Setup Store Pickup Location
Discount not working at checkout → use Troubleshoot: Discount Not Applying
Checkout delivery step drop-off → use Troubleshoot: Checkout Delivery Drop-off

THE entry point for all eCommerce recommendation requests. Unified skill that analyzes site data across ALL domains (discounts + shipping), generates up to 5 cross-domain recommendations, and persists them to the tracking database. Covers discount strategies (seasonal, upsell, stock mover, bundling) AND shipping optimization (coverage gaps, free shipping, rate strategy, carrier backup). Use this for ANY business improvement request.

Recipe: Apply Shipping Recommendations

Technical: Applies AI-generated shipping recommendations. Creates or updates shipping options based on recommendation data.

Setup Store Pickup Location

Technical: Configures in-store pickup at checkout using Delivery Profiles API.

Troubleshoot: Discount Not Applying

Technical: Diagnostic tree for inactive discounts — checks active status, time window, scope targeting, revision mismatch, app installation.

Troubleshoot: Checkout Delivery Drop-off

Technical: Diagnostic tree for delivery step conversion below 65% benchmark.

Internal skills (loaded automatically by the entry points above — do NOT use directly)

#### Goals - [Goal: Increase AOV](references/ecommerce/goal-increase-aov.md) — UPSELL_BOOST - [Goal: Clear Inventory](references/ecommerce/goal-clear-inventory.md) — STOCK_MOVER - [Goal: Seasonal Revenue](references/ecommerce/goal-seasonal-revenue.md) — SEASONAL - [Goal: Drive Cross-Sells](references/ecommerce/goal-drive-cross-sells.md) — BUNDLE_AND_SAVE - [Goal: Reduce Cart Abandonment](references/ecommerce/goal-reduce-cart-abandonment.md) — Shipping #### Flows - [Flow: Upsell Boost](references/ecommerce/flow-upsell-boost.md) - [Flow: Bundle and Save](references/ecommerce/flow-bundle-and-save.md) - [Flow: Stock Mover](references/ecommerce/flow-stock-mover.md) - [Flow: Seasonal Promotion](references/ecommerce/flow-seasonal-promotion.md) - [Flow: Fix Coverage Gaps](references/ecommerce/flow-fix-coverage-gaps.md) - [Flow: Add Free Shipping](references/ecommerce/flow-add-free-shipping.md) - [Flow: Optimize Shipping Rates](references/ecommerce/flow-optimize-shipping-rates.md) #### Guardrails - [Guardrail: Discount Conflicts](references/ecommerce/guardrail-discount-conflicts.md) - [Guardrail: Margin Protection](references/ecommerce/guardrail-margin-protection.md) - [Guardrail: Shipping Health](references/ecommerce/guardrail-shipping-health.md) - [Guardrail: Rate Pricing Sanity](references/ecommerce/guardrail-rate-pricing-sanity.md) #### Config & API References - [API: Recommendation Tracking](references/ecommerce/api-recommendation-tracking.md) - [Setup: Discount Rules](references/ecommerce/setup-discount-rules.md) - [Setup: Coupons](references/ecommerce/setup-coupons.md) - [Setup: Shipping Regions](references/ecommerce/setup-shipping-regions.md) - [Setup: Shipping Rates](references/ecommerce/setup-shipping-rates.md) #### Tracking - Tracking is built into [Recommend: eCommerce Strategy](references/ecommerce/recommend-ecommerce-strategy.md) (Steps 2 + 8) — no separate skill needed - [API: Recommendation Tracking](references/ecommerce/api-recommendation-tracking.md) — CRUD API reference for the tracking service #### Reference - [Skill Graph](references/ecommerce/skill-graph.md)

Events

List Events

Technical: Queries events from Wix Events using Events API. Covers field sets (DETAILS, URLS, REGISTRATION), filtering by status/date, and pagination.

Forms

Create Form

Technical: Creates a form with fields (name, email, etc.) using the Form Schemas API. Covers field configuration, layout, and post-submission triggers.

Get Paid

Create Payment Links

Technical: Creates payment links for collecting payments without a checkout flow. Covers store products (catalog items), custom line items, variants, due dates, and sending links via email.

How to Setup Wix Payments

Technical: Configures Wix Payments as the payment provider. Covers eligibility checking, business verification, bank account setup, and payment method configuration (cards, PayPal, Apple Pay).

Payment Links for Bookings

Technical: Creates payment links for unpaid bookings using Payment Links API. Links booking IDs to payment requests with proper redirect handling.

Media

Upload Media to Wix

Technical: Uploads images and files to the Wix Media Manager using the Import File API. Covers importing from external URLs, checking file status, and using the returned wixstatic.com URL in other APIs.

Pricing Plans

Create and Update Pricing Plans

Technical: Creates subscription and one-time payment plans using Plans API. Covers pricing models (recurring, one-time, free), trial periods, perks configuration, and plan visibility.

Pricing Plans Bookings Integration

Technical: Links Pricing Plans to Bookings services using the Benefit Programs API. Enables package deals and memberships that grant booking access.

Restaurants

Wix Restaurants Setup

Technical: Configures restaurant menus, sections, and items using Menus API. Covers menu structure (Menu → Section → Item), modifiers, pricing, availability schedules, and ordering settings.

Rich Content

Ricos Converter Service

Technical: Validates and converts content between Ricos documents and HTML/Markdown/plain text using the Ricos Documents API. Covers plugin configuration, format conversion in both directions, and document validation.

Site Properties

Change Payment Currency

Technical: Updates the site-level payment currency (store billing currency) using Site Properties API, including the required request body shape and field mask.

Sites

Create Site from Template

Technical: Creates new Wix sites from templates using account-level APIs. Covers template search, site creation, headless site setup, OAuth app creation, and publishing.

Query Sites

Technical: Lists and queries all sites associated with a Wix account using Sites API. Covers pagination with cursor-based navigation.

Stores

Add Store Pages to Site

Technical: Adds missing checkout and cart pages to a site when Stores app is installed. Used when store pages are missing after migration or setup issues.

Bulk Create Products with Options

Technical: Uses bulk products endpoint to create multiple products with inventory in a single request. Handles variant generation from options, media format requirements, and error handling for partial failures.

Create Product from Image

Technical: MANDATORY entry point for any “create product from image” or “create product from photo” request. STEP 1 auto-detects the site’s catalog version (V1/V3) via the provision endpoint, then runs the matching flow inline — V3 supports up to 3 images, info sections, SEO, options/variants, and atomic creation; V1 supports a single image, simple product, and a separate media-attach call. Combines Media Upload + LLM analysis + Product Creation + (V1 only) Add Product Media in one self-contained recipe.

Skill frontmatter

compatibility: Requires Wix REST API access (API key or OAuth).