Wix Stores: Shop Page
The following slots and APIs are available when building a site plugin for the Shop page.
Note: When selecting a slot for your plugin in the Shop page, you should select the same slot for the Gallery widget and the Category page. Different Wix sites may use any of these and making these slots available for your plugin allows users to add it to their site regardless of their setup.
Slots
The following images show the slots available in the Shop page, into which users can add plugins.
Mobile
Mobile Popup
Desktop
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 |
|---|---|
category-page-list-top | 2d87901c-966b-475f-b546-e680ef274611 |
gallery-filters-top | bfa2b619-c93e-4d16-bddf-ea0b0e8136a8 |
gallery-filters-bottom | 192ec269-e1e2-4bc4-b82f-1cafda2a30ab |
gallery-products-top | 322a509b-0712-4632-82e0-44488a1c0f50 |
gallery-products-bottom | 2cd07116-244b-4997-92e5-b7c053a732ff |
For example, to allow your plugin to be placed above the product gallery:
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 | "1380bba0-253e-a800-a235-88821cf3f8a4" |
slotId | ID of the slot you want as displayed in the image above. |
For example:
Category plugin API
Use the Category plugin API to integrate with the plugin's host.
The API provides data about the current category.
| Property | Type | Description |
|---|---|---|
categoryId | String | The ID of the category that is currently applied on the plugin's host. |
Related Wix 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 current category or related data.
You can do this using the Wix Stores APIs (Velo, REST, JavaScript SDK).
Last updated: 13 October 2026