skills.rest
ESSSoWhat
ESSSoWhatCOMMUNITY
Explore all skills by this author →
GitHub

wix-cli-service-plugin

Implements Wix service plugin extensions that inject custom backend logic into eCommerce and Bookings flows.

Updated Feb 21, 2026
Search Tags:#typescript#spi#checkout#ecommerce#wix#wix cli#service plugin
One-click install
npx skills add https://github.com/ESSSoWhat/live-translate-realtime-dubbing --skill wix-cli-service-plugin-esssowhat
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wix-cli-service-plugin
Source: https://github.com/ESSSoWhat/live-translate-realtime-dubbing/tree/main/wix-app/np/.agents/skills/wix-cli-service-plugin
Command: npx skills add https://github.com/ESSSoWhat/live-translate-realtime-dubbing --skill wix-cli-service-plugin-esssowhat

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Building Wix service plugins (SPIs) requires precise handler signatures, response structures, and a two-step extension registration process that is easy to get wrong. This Skill guides the creation of complete, working service plugin extensions for Wix CLI apps so custom backend logic actually activates in Wix business flows. ## Core Features & Use Cases - SPI Implementation Guidance: Step-by-step checklist for creating plugin.ts handlers with provideHandlers() and extensions.ts builder files with unique UUIDs. - Seven SPI References: Detailed reference docs for Additional Fees, Discount Triggers, Gift Cards, Shipping Rates, Tax Calculation, Validations, and Bookings Staff Sorting, each with imports, request/response schemas, and working examples. - Permission Elevation Patterns: Shows how to use auth.elevate from @wix/essentials when calling Wix APIs from service plugin handlers. - Use Case: A developer needs to add a configurable global handling fee to every checkout on a Wix store. The Skill directs them to the Additional Fees reference, generates the handler and builder files, and ensures registration in src/extensions.ts. ## Quick Start Ask the assistant to create a Wix service plugin, for example: "Create an additional fees service plugin that adds a $5 handling fee to every order."

Frequently Asked Questions about wix-cli-service-plugin

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Wix service plugin for custom shipping rates?▼

Create a plugin.ts file that imports shippingRates from @wix/ecom/service-plugins and calls provideHandlers with a getShippingRates function returning rate objects with code, title, logistics, and cost. Then register it with the ecomShippingRates() builder in extensions.ts using a unique UUID.

How do I add custom fees to Wix checkout orders?▼

Implement the Additional Fees SPI by providing a calculateAdditionalFees handler that returns an additionalFees array with code, name, and price as a string. Register it with the ecomAdditionalFees() builder and release a new version for it to take effect.

Why is my Wix service plugin not running after I created it?▼

Service plugins require two registration steps: a plugin-specific extensions.ts builder file and an import in the main src/extensions.ts file. You must also build and release a new version, since changes do not take effect until the project is released.

Can Wix service plugins call other Wix APIs like data collections?▼

Yes, but you must elevate permissions using auth.elevate from @wix/essentials before calling APIs such as items.query or cart.getCart. Wrap the API method with auth.elevate and then invoke the elevated function with your parameters.

What are the limitations of the Bookings staff sorting plugin?▼

The sortStaffMembers handler must return the exact same resource IDs from availableResourceIds, only reordered, and must respond within 5 seconds, with under 500ms recommended. Invalid responses cause Wix to fall back to random staff assignment.

Related Skills

Explore More Software Engineering Skills→
divinaarmueladivinaarmuela

wix-headless

Configures Wix Headless backends and generates SDK integration guides for frontend applications.

Community
Advanced
nirganonnirganon

wix-cli-service-plugin

Implements Wix service plugin extensions that inject custom backend logic into eCommerce and Bookings flows.

Community
Advanced
nirganonnirganon

wix-cli-extension-registration

Registers Wix CLI extensions with the app builder in src/extensions.ts.

Community
Basic
wixwix
25

wix-cli-service-plugin

Implement Wix SPI service plugins with TypeScript handlers and validation.

Official
Advanced