Wix eCommerce (Checkout & Orders): Side Cart
The following slots and APIs are available when building a site plugin for the Side Cart.
Important: Some plugins may not support automatic addition upon installation, even with autoAddToSite enabled. In that case, you must:
- Create a dashboard page to manage your site plugin that calls
addSitePlugin()to let users add the plugin to the checkout slot. - Release at least 1 version of your app so the site plugin extension is registered with Wix for
addSitePlugin()to work properly.
Slots
The following image shows slots in the Side Cart, into which users can add plugins.
Each slot is identified by a unique placement slot ID. Declare the slots your plugin can be added to by listing their IDs in the placementsSlotIds array in your plugin's configuration:
The following table lists the placement slot ID for each slot in the Slots diagram:
| Slot | Placement slot ID |
|---|---|
side-cart:header:after-1 | ac85529f-da44-4619-a034-eb58ac00a935 |
side-cart:line-items:after-1 | 466203bb-a4e4-45fa-9d00-74a9ca212285 |
side-cart:customer-input:after-1 | e26daf2c-dcaf-4379-b303-6069a9910eca |
side-cart:footer:actions:before-1 | 0a011896-b109-451a-ac33-4e5fe51e9626 |
side-cart:footer:actions:after-1 | 4f2f403d-90e4-49fd-a828-012a16bebb24 |
For example, to allow your plugin to be placed after the header in the Side Cart:
Note: The legacy placements format isn't deprecated, and plugins that haven't been migrated continue to work. We still recommend migrating your code to placementsSlotIds.
Legacy placements values
The slots are represented by the following placement object:
Provide the following values for each property:
| Key | Value |
|---|---|
appDefinitionId | "1380b703-ce81-ff05-f115-39571d94dfcd" |
widgetId | "49dbb2d9-d9e5-4605-a147-e926605bf164" |
slotId | ID of the slot you want as displayed in the image above. Supported values:
|
For example, for your widget to appear before the header in the Side Cart use the following object in your configuration:
Side Cart plugin APIs
Use the following APIs to integrate with the plugin's host:
The Current Cart API allows you to manage and get information about the current cart. The eCommerce frontend API allows you to interact with the cart's UI elements.
Code example
Related Wix backend APIs
Side Cart plugins usually need to integrate with Wix eCommerce's Cart and Checkout APIs, as well as other backend APIs.
In your site plugin or in your app's server code, you may want to perform actions or implement logic that is dependent on the state of the current cart or related data.
The following Wix APIs may be useful:
Design guidelines
When you create a Side Cart plugin, we recommend following these design guidelines:
-
Make sure your design is responsive for all screen sizes.
-
The Side Cart uses a
4pxbaseline grid for aligning all elements, typography, and spacing between elements. Don't add extra spacing around your plugin design. The slot automatically handles spacing to maintain the Side Cart's uniform layout. -
Give your designs an appropriate height, depending on the slot you use.
Slot Recommended height Max height side-cart:header:after-130px70pxside-cart:line-items:after-150px150pxside-cart:customer-input:after-124px150pxside-cart:footer:actions:before-150px70pxside-cart:footer:actions:after-150px70px
Last updated: 13 October 2026