Subchapter 13.3
wix-business-solutions-taxonomy.mdMarkdown26 KBView on GitHub
rp-mapperThis file is a curated, mapper-oriented taxonomy of Wix business solutions and their primary entities.
Use it during rp-mapper to:
This is intentionally curated, not exhaustive. Prefer stable, first-party solutions and stable entity families that are relevant for migration planning.
This distinction must stay explicit in mapper output.
Wix eCommerce is the shared commerce platform layer.
It owns the purchase flow and operational commerce entities that are reused across multiple vertical apps.
Typical eCommerce entities:
Use eCommerce when the source data is about:
Wix Stores is a vertical app built on top of the commerce platform.
It owns the product catalog and store-specific merchandising model.
Typical Stores entities:
Use Stores when the source data is about:
Other business apps also sit above shared platform layers and bring their own domain model:
Bookings: services, staff, resources, schedules, bookingsEvents: events, ticket definitions, tickets, RSVPs, guestsRestaurants: menus, sections, items, modifiers, reservation locations, reservationsPricing Plans: plans and plan orders / subscriptionsIf the source platform mixes these layers together, separate them in the mapping plan instead of collapsing them into one Wix target.
| Solution | Role in Wix | Main docs |
|---|---|---|
ecommerce | Shared purchase-flow platform across commerce-enabled apps | eCommerce overview (opens in a new tab) |
stores | Product catalog and merchandising app for physical/digital goods | Wix Stores Catalog API (opens in a new tab) |
bookings | Service business app for appointments, classes, and courses | About Wix Bookings (opens in a new tab) |
events | Event management, ticketing, RSVP, and guest lifecycle | About the Wix Events API (opens in a new tab) |
restaurants | Food business apps for menus, ordering, and reservations | About the Menus API (opens in a new tab) |
pricing-plans | Memberships, subscriptions, plans, and plan orders | About Wix Pricing Plans (opens in a new tab) |
payments | Payment processing and transaction infrastructure | About Wix Payments (opens in a new tab) |
crm | Contacts, labels, and CRM extensions around customer identity | About the Contacts API (opens in a new tab) |
members | Site membership, profiles, badges, member custom fields | About the Members APIs (opens in a new tab) |
blog | Blog content model for posts, categories, and tags | About the Blog APIs (opens in a new tab) |
cms | Custom collections and custom items when native apps are insufficient | About the Wix Data APIs (opens in a new tab) |
Main page:
Short description:
Primary entities:
| Entity | What it does | Docs |
|---|---|---|
cart | First phase of the purchase flow; holds line items, buyer references, discounts, and pricing context before checkout | About the eCommerce Cart API (opens in a new tab) |
current-cart | Visitor/member scoped cart used in live purchase flows | About the eCommerce Current Cart API (opens in a new tab) |
checkout | Second phase of purchase flow; holds calculated prices, tax, billing, shipping, and discount state before order creation | About the eCommerce Checkout API (opens in a new tab) |
order | Final commerce record for completed or externally recorded purchases | About the Orders API (opens in a new tab) |
order-billing | Payment capture, void, and refund operations for eCommerce orders | About the Order Billing API (opens in a new tab) |
Mapper notes:
ecommerce.order and document missing pre-purchase state.Main page:
Short description:
Stores sits above the shared eCommerce purchase flow.Primary entities:
| Entity | What it does | Docs |
|---|---|---|
product | Core sellable item with media, pricing, metadata, and variants | About Products (opens in a new tab) |
category | Hierarchical merchandising structure for organizing products | About the Wix Categories API (opens in a new tab) |
product-tag | Labels attached to products via the global Tags API; products carry tags.publicTags.tagIds[] and tags.privateTags.tagIds[] | About the Tags API (opens in a new tab) · Create Tag (opens in a new tab) |
collection | Read-only CMS mirror of store collections for querying and display | Wix Stores Collections (opens in a new tab) |
inventory-item | Inventory state for store products and variants | About the Inventory API (opens in a new tab) |
stores-location | Inventory locations used by the store catalog | About the Stores Locations API (opens in a new tab) |
catalog-version | Identifies whether a site is on Stores Catalog V1 or V3 | About the Catalog Versioning API (opens in a new tab) |
Mapper notes:
stores for product catalog migration, not ecommerce.variant data is typically modeled under product APIs rather than as a standalone top-level app.category; use custom collections only when the source model exceeds Wix’s native merchandising structure.POST /tags/v1/tags with fqdn: "wix.stores.catalog.v3.product", crosswalk the IDs, and set tags.publicTags.tagIds[] when creating products. Max 100 tags per FQDN. Create tags before products.Main page:
Short description:
Primary entities:
| Entity | What it does | Docs |
|---|---|---|
service | Bookable offering such as an appointment, class, or course | About the Services V2 API (opens in a new tab) |
service-category | Organizes services for display and discovery | About the Bookings Services APIs (opens in a new tab) |
staff-member | Person providing services, including service assignments and working hours | About the Staff Members API (opens in a new tab) |
resource | Non-staff business asset needed to deliver a service, such as a room or equipment | About the Resource APIs (opens in a new tab) |
booking | Customer booking record and lifecycle state | About the Bookings APIs (opens in a new tab) |
time-slot | Availability window for bookable services | Time Slots V2 API (opens in a new tab) |
external-calendar-connection | Sync bridge between Bookings schedules and external calendars | About the External Calendars API (opens in a new tab) |
Mapper notes:
bookings, not stores.staff-member; rooms/equipment should map to resource.Main page:
Short description:
Primary entities:
| Entity | What it does | Docs |
|---|---|---|
event | Top-level event record with schedule, registration mode, and event metadata | About the Wix Events API (opens in a new tab) |
ticket-definition | Ticket type template such as General Admission or VIP | Event Management introduction (opens in a new tab) |
ticket | Purchased ticket with guest and check-in state | About the Tickets API (opens in a new tab) |
event-order | Ticket purchase and registration order lifecycle | About the Orders API (opens in a new tab) |
rsvp | RSVP response and attendance state for non-ticketed events | About RSVP API (opens in a new tab) |
event-guest | Unified guest record across ticketed and RSVP events | About the Event Guests API (opens in a new tab) |
events-registration | Registration layer connecting RSVP, ticketing, and guests | About Events Registration (opens in a new tab) |
Mapper notes:
event, ticket-definition, and ticket for ticketed-event catalogs.rsvp and event-guest for RSVP-only sources.Main pages:
Short description:
Primary entities:
| Entity | What it does | Docs |
|---|---|---|
menu | Top-level menu such as Breakfast, Lunch, or Dinner | About Menus (opens in a new tab) |
menu-section | Section within a menu such as Appetizers or Desserts | About the Menus API (opens in a new tab) |
menu-item | Individual dish or item sold by the restaurant | About the Menus API (opens in a new tab) |
item-modifier-group | Group of selectable modifiers such as toppings or sides | About the Menus API (opens in a new tab) |
item-variant | Size or other priced variant of a menu item | About the Menus API (opens in a new tab) |
reservation-location | Physical restaurant location and reservation configuration | Reservations Locations API (opens in a new tab) |
reservation | Reservation lifecycle record for a party at a restaurant | About the Reservations API (opens in a new tab) |
restaurant-time-slot | Availability window for reservation booking | Reservations API introduction (opens in a new tab) |
experience | Special dining experience such as chef’s table or tasting menu | Experiences API (opens in a new tab) |
restaurant-order-legacy | Legacy restaurant order model from the original Restaurants Orders app | About Wix Restaurants Orders (opens in a new tab) |
Mapper notes:
stores.product unless the migration intentionally flattens restaurant content into a generic catalog.Main page:
Short description:
Primary entities:
| Entity | What it does | Docs |
|---|---|---|
plan | Membership or subscription offering with pricing model and entitlement structure | About the Plans V3 API (opens in a new tab) |
pricing-plan-order | Purchase/subscription record for a plan | About the Orders API (opens in a new tab) |
benefit-program-linkage | Underlying credit/benefit program connection used by some plans | About Wix Pricing Plans (opens in a new tab) |
Mapper notes:
plan for memberships/bundles/subscriptions and pricing-plan-order for subscriptions purchased by members.Main page:
Short description:
ecommerce.order; it handles transaction processing.Primary entities:
| Entity | What it does | Docs |
|---|---|---|
payment-transaction | Authorization, capture, recurring charge, refund, void, and dispute lifecycle | Transactions API (opens in a new tab) |
wix-payments-provider | Payment provider integration surface for accepting supported payment methods | About Wix Payments (opens in a new tab) |
Mapper notes:
payments.Main pages:
Short description:
Primary entities:
| Entity | What it does | Docs |
|---|---|---|
contact | Core person/business contact record for site interactions | About the Contacts API (opens in a new tab) |
contact-label | Segment/tag for organizing contacts | About the Labels API (opens in a new tab) |
contact-extended-field | Additional fields stored on contacts. Contacts V5 (GA, verified 2026-08-04) carries values under extendedFields.namespaces.<ns> and routes definitions through the Data Extension Schema API with FQDN wix.contacts.*.contact (user-defined fields under _user_fields); persist the returned key from setup. CAVEAT: the Data Extension Schema intro’s supported-objects table does not list contacts yet — verify live during setup. The V4 Contacts Extended Fields API (info.extendedFields, Find Or Create Extended Field) pairs with the V4 write surface only; do not mix surfaces. | Contacts V5 Contact Object (opens in a new tab), About the Data Extension Schema API (opens in a new tab), About the Extended Fields API (opens in a new tab) |
pipeline | CRM process pipeline for leads/deals/workflow stages | About the Pipelines API (opens in a new tab) |
form-schema | Structured form definition often used to create leads and capture CRM data | About the Form Schemas API (opens in a new tab) |
Mapper notes:
crm.contact for person/company records even if the source platform calls them customers, clients, leads, or subscribers.Main page:
Short description:
Primary entities:
| Entity | What it does | Docs |
|---|---|---|
member | Site member account and profile identity | About the Members API (opens in a new tab) |
member-about | Rich profile “About” content | About the Members About API (opens in a new tab) |
member-badge | Badge definition assigned to members | About the Badges API (opens in a new tab) |
badge-assignment | Assignment of a badge to a member | About the Badge Assignments API (opens in a new tab) |
member-custom-field | Extra profile schema beyond the default member fields | About Custom Fields (opens in a new tab) |
Mapper notes:
member is not identical to a contact, though the two are related.member and broader person data to contact where appropriate.Main page:
Short description:
Primary entities:
| Entity | What it does | Docs |
|---|---|---|
blog-post | Published or draft article content | About the Blog APIs (opens in a new tab) |
blog-category | Topical grouping for posts | Categories API (opens in a new tab) |
blog-tag | Lightweight filterable tagging for posts | About the Tags API (opens in a new tab) |
Mapper notes:
cms instead.Main pages:
Short description:
Primary entities:
| Entity | What it does | Docs |
|---|---|---|
data-collection | Custom schema / table-like collection in the Wix CMS | About the Data Collections API (opens in a new tab) |
data-item | Row/document stored in a custom collection | About the Data Items API (opens in a new tab) |
wix-app-collection | Read-only CMS mirror of data owned by Wix business apps | About Wix App Collections (opens in a new tab) |
Mapper notes:
cms only when the source concept does not fit a stable native Wix business entity, or when the business requires custom structured data beyond the native app model.cms, explicitly explain why native stores, bookings, events, pricing-plans, crm, or members entities are insufficient.Use these heuristics before inventing custom targets:
stores.bookings.events.restaurants.pricing-plans.ecommerce.crm and members.blog.cms and document the gap.dev.wix.com for updates.eCommerce vs Stores distinction. That boundary is important for migration planning and import code generation.