Wix Stores: Product Page
The following slots and APIs are available when building a site plugin for the Product page.
Important:
The slots and APIs are different depending on which version of Wix Stores is installed on a site. Your app should include placement slot IDs for both versions. To check which version of Wix Stores is installed on a specific site, call the Get App Instance method and inspect the installedWixApps field.
Slots
The following images show the slots available in the Product page, into which users can add plugins. The locations of slots differ slightly depending on which version of Wix Stores and which page layout a site is using.
New product page
Note:
If using the product-page-media-1 slot, it may overlap with the thumbnail images on the left hand side in a desktop view. In this case, we recommend offering settings in your app to control the left padding.
Mobile
Desktop
Old product page
Mobile
Classic
Simple
Sleek
Spotlight
Stunning
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. To support both versions of the Product page, include the placement slot IDs of the corresponding slots in both versions:
Use the following placement slot IDs:
New product page (as displayed in the image above)
| Slot | Placement slot ID |
|---|---|
product-page-top | ddcfe6ea-b2ac-40f4-b420-2eb18b10e377 |
product-page-media-1 | fba51e0c-08ae-4c26-8276-b4256927b374 |
product-page-details-1 | e71c3400-e5ee-40a6-9690-f05a1f765dc8 |
product-page-details-2 | 6b5db632-c35f-4cf9-93d8-bfb36e241d29 |
product-page-details-3 | 3406f59a-0e0a-4308-b385-0e43c1ad5df1 |
product-page-details-4 | e0703de2-1b2c-4844-8cdd-869b3cf4bbb8 |
product-page-details-5 | ea567a40-b747-4911-907d-46144736d0ad |
product-page-details-6 | 0dbe5034-bbff-49fb-8a28-d8d51991f708 |
product-page-details-7 | 24b75309-d44d-454a-bb98-a2f3c1489477 |
product-page-details-8 | ce46412f-b736-4e94-a6a5-f60e84a2b6de |
product-page-details-9 | 038f343a-75d3-4ed9-9bda-7f1096cfa3e7 |
product-page-bottom | c8400e82-400b-4591-a9e0-c0f0287fbf45 |
Old product page (as displayed in the image above)
| Slot | Placement slot ID |
|---|---|
product-page-top | 2832b6e7-1bb3-4b08-b361-5e77a13621dc |
product-page-media-1 | f74d0746-dd85-4a4e-b1c5-8207b29cc191 |
product-page-details-1 | 8e497c6c-3ed9-4995-8ee9-e9f939f7a355 |
product-page-details-2 | 905e9719-9672-437f-85a0-1975337ba08c |
product-page-details-3 | b9dff4d5-192d-4574-bf14-baf6e2734f3a |
product-page-details-4 | cec2ee92-7e12-42a1-a2f5-fe02f30e688a |
product-page-details-5 | 1db8f870-879b-46b8-88df-f232e2621eb2 |
product-page-details-6 | 6feecc92-8459-4698-ad4b-b085a74407d8 |
product-page-details-7 | 15c88f6e-fbd2-418b-a389-00bcd1937dc1 |
product-page-details-8 | edce2d4e-51c9-4e75-b7db-090da80ff455 |
product-page-details-9 | a49a45fe-2f34-4eae-a8f5-d971f822e645 |
product-page-details-slot-1 | 109ad6e8-ba91-451c-87c2-acf70cb940f7 |
product-page-bottom | ad454e1e-aa18-46a6-ae81-5df549178c7a |
product-page-bottom-slot | 6c255ba5-0850-4067-8667-565c6f078ce0 |
product-page-additional-buttons | 9d31fcc2-53ee-4547-b837-878f5394ed7e |
For example, to allow your plugin to be placed in the second details slot in both Product page versions:
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 objects:
Provide the following values for each property:
New product page
| Key | Value |
|---|---|
appDefinitionId | "a0c68605-c2e7-4c8d-9ea1-767f9770e087" |
widgetId | "6a25b678-53ec-4b37-a190-65fcd1ca1a63" |
slotId | ID of the slot you want as displayed in the image above. |
Old product page
| Key | Value |
|---|---|
appDefinitionId | "1380b703-ce81-ff05-f115-39571d94dfcd" |
widgetId | "13a94f09-2766-3c40-4a32-8edb5acdd8bc" |
slotId | ID of the slot you want as displayed in the image above. |
For example:
Product plugin API
Use the Product Plugin API to integrate with the plugin's host, which in this case is the product page.
The API provides data about the current event.
| Property | Type | Description |
|---|---|---|
productId | string | The ID of the product on the product page. |
selectedVariantId | string | The ID of the selected product variant. This ID is only available after the site visitor picks all required product choices. For example selecting the color and size of the product. Until all required choices are selected, this ID is undefined. |
selectedChoices | object | An object containing all the choices the site visitor picks from the options on the product page. Each key is an option name and each value is the selected option. For example, { color: "green", size: "large" }. |
quantity | number | The number of product items the site visitor wants to buy. The site visitor can increase or decrease this value on the product page. |
customText | string[] | An array of text values entered by the site visitor in custom text fields on the product page. For example, this can be used for personalization, such as adding names to a shirt. Multiple text fields are supported, so each entry in the array corresponds to a different custom text field on the product page. |
Related Wix APIs
In your site plugin or in your app's server code, you may want to perform actions or implement logic that's dependent on the current product or related data.
You can do this using the Wix Stores APIs (Velo, REST, JavaScript SDK).
Last updated: 13 October 2026