@wix/ditto-codegen-public 1.0.162 → 1.0.164

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (66) hide show
  1. package/dist/docs-output/api-docs/bookings-bookings-onBookingCanceled-doc.txt +169 -0
  2. package/dist/docs-output/api-docs/bookings-bookings-onBookingCreated-doc.txt +154 -0
  3. package/dist/docs-output/api-docs/crm-contacts-onContactCreated-doc.txt +87 -171
  4. package/dist/docs-output/api-docs/crm-contacts-onContactDeleted-doc.txt +58 -0
  5. package/dist/docs-output/api-docs/crm-contacts-onContactUpdated-doc.txt +99 -0
  6. package/dist/docs-output/api-docs/data-items-get-doc.txt +95 -54
  7. package/dist/docs-output/api-docs/data-items-insert-doc.txt +235 -43
  8. package/dist/docs-output/api-docs/data-items-onDataItemCreated-doc.txt +61 -0
  9. package/dist/docs-output/api-docs/data-items-onDataItemDeleted-doc.txt +58 -0
  10. package/dist/docs-output/api-docs/data-items-onDataItemUpdated-doc.txt +61 -0
  11. package/dist/docs-output/api-docs/data-items-query-doc.txt +507 -302
  12. package/dist/docs-output/api-docs/data-items-remove-doc.txt +120 -40
  13. package/dist/docs-output/api-docs/data-items-update-doc.txt +425 -46
  14. package/dist/docs-output/api-docs/ecom-cart-addToCart-doc.txt +488 -0
  15. package/dist/docs-output/api-docs/ecom-cart-createCart-doc.txt +518 -0
  16. package/dist/docs-output/api-docs/ecom-cart-createCheckout-doc.txt +155 -0
  17. package/dist/docs-output/api-docs/ecom-cart-deleteCart-doc.txt +92 -0
  18. package/dist/docs-output/api-docs/ecom-cart-getCart-doc.txt +376 -0
  19. package/dist/docs-output/api-docs/ecom-cart-onCartCreated-doc.txt +89 -80
  20. package/dist/docs-output/api-docs/ecom-cart-onCartUpdated-doc.txt +91 -81
  21. package/dist/docs-output/api-docs/ecom-cart-removeLineItemsFromCart-doc.txt +321 -0
  22. package/dist/docs-output/api-docs/ecom-cart-updateCart-doc.txt +539 -0
  23. package/dist/docs-output/api-docs/ecom-checkout-addToCheckout-doc.txt +1005 -0
  24. package/dist/docs-output/api-docs/ecom-checkout-createCheckout-doc.txt +1641 -0
  25. package/dist/docs-output/api-docs/ecom-checkout-getCheckout-doc.txt +1027 -0
  26. package/dist/docs-output/api-docs/ecom-checkout-onCheckoutCompleted-doc.txt +151 -0
  27. package/dist/docs-output/api-docs/ecom-checkout-onCheckoutCreated-doc.txt +150 -0
  28. package/dist/docs-output/api-docs/ecom-checkout-onCheckoutUpdated-doc.txt +150 -0
  29. package/dist/docs-output/api-docs/ecom-checkout-removeLineItemsFromCheckout-doc.txt +879 -0
  30. package/dist/docs-output/api-docs/ecom-checkout-updateCheckout-doc.txt +1011 -0
  31. package/dist/docs-output/api-docs/ecom-currentCart-getCurrentCart-doc.txt +368 -322
  32. package/dist/docs-output/api-docs/ecom-currentCart-updateCurrentCart-doc.txt +506 -321
  33. package/dist/docs-output/api-docs/ecom-orders-bulkUpdateOrders-doc.txt +1040 -0
  34. package/dist/docs-output/api-docs/ecom-orders-cancelOrder-doc.txt +608 -0
  35. package/dist/docs-output/api-docs/ecom-orders-getOrder-doc.txt +926 -0
  36. package/dist/docs-output/api-docs/ecom-orders-onOrderCreated-doc.txt +245 -0
  37. package/dist/docs-output/api-docs/ecom-orders-onOrderUpdated-doc.txt +244 -0
  38. package/dist/docs-output/api-docs/ecom-orders-searchOrders-doc.txt +670 -0
  39. package/dist/docs-output/api-docs/ecom-orders-updateOrder-doc.txt +818 -0
  40. package/dist/docs-output/api-docs/search-wixSiteSearch-search-doc.txt +162 -0
  41. package/dist/docs-output/api-docs/stores-collections-addProductsToCollection-doc.txt +86 -0
  42. package/dist/docs-output/api-docs/stores-collections-createCollection-doc.txt +108 -0
  43. package/dist/docs-output/api-docs/stores-collections-getCollection-doc.txt +102 -0
  44. package/dist/docs-output/api-docs/stores-collections-queryCollections-doc.txt +209 -0
  45. package/dist/docs-output/api-docs/stores-collections-removeProductsFromCollection-doc.txt +86 -0
  46. package/dist/docs-output/api-docs/stores-collections-updateCollection-doc.txt +110 -0
  47. package/dist/docs-output/api-docs/stores-inventory-queryInventory-doc.txt +98 -0
  48. package/dist/docs-output/api-docs/stores-inventory-updateInventoryVariants-doc.txt +249 -0
  49. package/dist/docs-output/api-docs/stores-inventoryItemsV3-queryInventoryItems-doc.txt +236 -0
  50. package/dist/docs-output/api-docs/stores-inventoryItemsV3-updateInventoryItem-doc.txt +139 -0
  51. package/dist/docs-output/api-docs/stores-productsV3-createProduct-doc.txt +1697 -0
  52. package/dist/docs-output/api-docs/stores-productsV3-deleteProduct-doc.txt +73 -0
  53. package/dist/docs-output/api-docs/stores-productsV3-getProduct-doc.txt +933 -0
  54. package/dist/docs-output/api-docs/stores-productsV3-onProductCreated-doc.txt +794 -0
  55. package/dist/docs-output/api-docs/stores-productsV3-onProductDeleted-doc.txt +794 -0
  56. package/dist/docs-output/api-docs/stores-productsV3-onProductUpdated-doc.txt +794 -0
  57. package/dist/docs-output/api-docs/stores-productsV3-queryProducts-doc.txt +1051 -0
  58. package/dist/docs-output/api-docs/stores-productsV3-searchProducts-doc.txt +1144 -0
  59. package/dist/docs-output/api-docs/stores-productsV3-updateProduct-doc.txt +1730 -1600
  60. package/dist/docs-output/api-docs/stores-readOnlyVariantsV3-queryVariants-doc.txt +290 -0
  61. package/dist/docs-output/api-docs/stores-readOnlyVariantsV3-searchVariants-doc.txt +353 -0
  62. package/dist/out.js +24996 -553
  63. package/package.json +2 -2
  64. package/dist/docs-output/api-docs/data-items-onDataItemCreated.txt +0 -103
  65. package/dist/docs-output/api-docs/stores-product-onProductCreated-doc.txt +0 -118
  66. package/dist/docs-output/api-docs/stores-productV3-onProductCreated-doc.txt +0 -184
@@ -0,0 +1,933 @@
1
+ <stores_productsV3_getProduct>
2
+ <description>
3
+ # Method name:
4
+
5
+ stores.productsV3.getProduct(productId: string, options: GetProductOptions)
6
+
7
+ # Method Link:
8
+
9
+ https://dev.wix.com/docs/sdk/backend-modules/stores/catalog-v3/products-v3/get-product
10
+
11
+ # Method Description:
12
+
13
+ Retrieves a product.
14
+
15
+ > **Note:**
16
+ > To retrieve a non-visible product (`visible: false`), your app must have the required `SCOPE.STORES.PRODUCT_READ_ADMIN` permission scope.
17
+
18
+ # Method Permissions:
19
+
20
+ - WIX_STORES.PRODUCT_READ
21
+ - WIX_STORES.PRODUCT_READ_NON_VISIBLE
22
+
23
+ # Method Permissions Scopes IDs:
24
+
25
+ undefined
26
+
27
+
28
+
29
+ # Method Code Examples:
30
+
31
+ ## getProduct
32
+
33
+ ```javascript
34
+ import { productsV3 } from '@wix/stores';
35
+
36
+ async function getProduct(productId, options) {
37
+ const response = await productsV3.getProduct(productId, options);
38
+ };
39
+ ```
40
+
41
+ ## getProduct (with elevated permissions)
42
+
43
+ ```javascript
44
+ import { productsV3 } from '@wix/stores';
45
+ import { auth } from '@wix/essentials';
46
+
47
+ async function myGetProductMethod(productId, options) {
48
+ const elevatedGetProduct = auth.elevate(productsV3.getProduct);
49
+ const response = await elevatedGetProduct(productId, options);
50
+ }
51
+ ```
52
+
53
+
54
+
55
+ ## default
56
+
57
+ ```javascript
58
+ try {
59
+ const result = await productsV3.getProduct("0650ee23-cb9c-4629-a289-a136a3620ff8", {});
60
+ return result;
61
+ } catch (error) {
62
+ console.error(error);
63
+ throw error;
64
+ }
65
+ ```
66
+ </description>
67
+ <type_definition>
68
+ ```
69
+ Method: stores.productsV3.getProduct(productId, options)
70
+ Description: Retrieves a product. > **Note:** > To retrieve a non-visible product (`visible: false`), your app must have the required `SCOPE.STORES.PRODUCT_READ_ADMIN` permission scope.
71
+ Method parameters:
72
+ param name: productId | type: string | description: Product GUID. | required: true
73
+ param name: options | type: GetProductOptions | description: none
74
+ - name: fields | type: Array<SingleEntityOpsRequestedFields> | description: Fields to include in the response.
75
+ enum:
76
+ ALL_CATEGORIES_INFO: Provides GUIDs and indexes for all categories including inherited parent categories.
77
+ BREADCRUMBS_INFO: Returns the category breadcrumb navigation path from root categories down to the product's main category, including category GUIDs, names, and slugs.
78
+ CURRENCY: Currency information including the currency code and formatted price amounts for storefront display.
79
+ DESCRIPTION: Returns the product description as rich content with complete node structure, metadata, and styling information.
80
+ DIRECT_CATEGORIES_INFO: Provides the GUIDs and indexes of categories the product is directly assigned to.
81
+ INFO_SECTION: Returns basic info section metadata including GUIDs, unique names, and titles. Use with `INFO_SECTION_DESCRIPTION` or `INFO_SECTION_PLAIN_DESCRIPTION` to include content.
82
+ INFO_SECTION_DESCRIPTION: Returns info section descriptions as rich content with complete node structure, metadata, and styling information. Use with `INFO_SECTION` for complete metadata.
83
+ INFO_SECTION_PLAIN_DESCRIPTION: Returns info section descriptions as HTML content. Use with `INFO_SECTION` for complete metadata.
84
+ MEDIA_ITEMS_INFO: Returns all media items associated with the product, including detailed metadata (URLs, alt-text, dimensions, filenames, file sizes).
85
+ MERCHANT_DATA: Returns merchant-related financial data including cost ranges and variant revenue details like cost, profit, and profit margin. Requires the `SCOPE.STORES.PRODUCT_READ_ADMIN` permission scope.
86
+ PLAIN_DESCRIPTION: Provides product description as plain HTML text.
87
+ SUBSCRIPTION_PRICES_INFO: Details subscription pricing options, empty for non-subscription products.
88
+ THUMBNAIL: Returns an optimized thumbnail image with standard dimensions, suitable for listings or previews.
89
+ UNKNOWN_REQUESTED_FIELD: Not implemented.
90
+ URL: The product's public storefront URL, including both relative path and full URL with base domain.
91
+ VARIANT_OPTION_CHOICE_NAMES: Enriches variant choices with human-readable option and choice names alongside render types.
92
+ WEIGHT_MEASUREMENT_UNIT_INFO: Returns the weight measurement unit (KG, LB) for the product.
93
+ Return type: PROMISE<V3Product>
94
+ - name: _createdDate | type: Date | description: Date and time the product was created.
95
+ - name: _id | type: string | description: Product GUID.
96
+ - name: _updatedDate | type: Date | description: Date and time the product was updated.
97
+ - name: actualPriceRange | type: PriceRange | description: Product actualPrice range - minimum and maximum prices of all product variants.
98
+ - name: actualPriceRange.maxValue | type: FixedMonetaryAmount | description: Maximum value.
99
+ - name: actualPriceRange.maxValue.amount | type: string | description: Monetary amount. For example, `"3.99"`, or `"-4.99"` for a negative amount.
100
+ - name: actualPriceRange.maxValue.formattedAmount | type: string | description: Formatted monetary amount. For example, `"$3.99"`. > **Note:** Returned only when you pass `"CURRENCY"` to the `fields` array in Products API requests.
101
+ - name: actualPriceRange.minValue | type: FixedMonetaryAmount | description: Minimum value.
102
+ - name: allCategoriesInfo | type: ProductCategoriesInfo | description: List of categories that directly contain this product, as well as their parent categories. > **Note:** Returned only when you pass `"ALL_CATEGORIES_INFO"` to the `fields` array in Products API requests.
103
+ - name: allCategoriesInfo.categories | type: Array<ProductCategory> | description: A list of categories related to product.
104
+ - name: allCategoriesInfo.categories[]._id | type: string | description: Category GUID.
105
+ - name: allCategoriesInfo.categories[].index | type: number | description: Index location of the product within the category, which can be utilized for sorting products in a specific category. For detailed instructions on how to set this up, refer to the [Add and arrange products in category](https://dev.wix.com/docs/rest/business-solutions/stores/catalog-v3/products-v3/sample-use-cases-and-flows#add-and-arrange-products-in-category) sample flow.
106
+ - name: brand | type: Brand | description: Product brand. + Pass `brand.name` to add a new brand while creating a product. + Pass an existing brand's `id` to assign that brand to the product.
107
+ - name: brand._id | type: string | description: Brand GUID.
108
+ - name: brand.name | type: string | description: Brand name.
109
+ - name: breadcrumbsInfo | type: BreadcrumbsInfo | description: Breadcrumbs of the `mainCategoryId`. Used to navigate to parent categories. > **Note:** Returned only when you pass `"BREADCRUMBS_INFO"` to the `fields` array in Products API requests.
110
+ - name: breadcrumbsInfo.breadcrumbs | type: Array<BreadCrumb> | description: Breadcrumbs.
111
+ - name: breadcrumbsInfo.breadcrumbs[].categoryId | type: string | description: Category GUID.
112
+ - name: breadcrumbsInfo.breadcrumbs[].categoryName | type: string | description: Category name.
113
+ - name: breadcrumbsInfo.breadcrumbs[].categorySlug | type: string | description: Category slug.
114
+ - name: compareAtPriceRange | type: PriceRange | description: Product compareAtPrice range - minimum and maximum compare at prices of all product variants.
115
+ - name: costRange | type: PriceRange | description: Product cost range - minimum and maximum costs of all product variants. > **Note:** Returned only when the following conditions are met: > + You pass `"MERCHANT_DATA"` to the `fields` array in Products API requests. > + Your app has the required `SCOPE.STORES.PRODUCT_READ_ADMIN` permission scope.
116
+ - name: currency | type: string | description: Currency used for the pricing of this product, in [ISO-4217](https://en.wikipedia.org/wiki/ISO_4217#List_of_ISO_4217_currency_codes) format. Defaults to the currency defined in the site settings, unless specified in `x-wix-currency` header. > **Note:** Returned only when you pass `"CURRENCY"` to the `fields` array in Products API requests.
117
+ - name: description | type: RichContent | description: Product description using rich content. > **Note:** Returned only when you pass `"DESCRIPTION"` to the `fields` array in Products API requests. <widget src="https://apps.wix.com/_serverless/ricos-playground-services/goto/api-component" plugins="indent.emoji.divider.codeBlock.file.gallery.giphy.image.table.link.textHighlight.textColor" exampleid="7dc9240e-d548-417a-abcf-0291b68b4303"> <a href="https://dev.wix.com/docs/ricos/api-reference/ricos-document">See Ricos document reference</a> </widget>
118
+ - name: description.documentStyle | type: DocumentStyle | description: Global styling for header, paragraph, block quote, and code block nodes in the object.
119
+ - name: description.documentStyle.blockquote | type: TextNodeStyle | description: Styling for block quote nodes.
120
+ - name: description.documentStyle.blockquote.decorations | type: Array<Decoration> | description: The decorations to apply to the node.
121
+ - name: description.documentStyle.blockquote.decorations[].type | type: DecorationType | description: The type of decoration to apply.
122
+ enum: ANCHOR, BOLD, COLOR, EXTERNAL, FONT_FAMILY, FONT_SIZE, ITALIC, LINK, MENTION, SPOILER, STRIKETHROUGH, SUBSCRIPT, SUPERSCRIPT, UNDERLINE
123
+ - ONE-OF:
124
+ - name: description.documentStyle.blockquote.decorations[].anchorData | type: AnchorData | description: Data for an anchor link decoration.
125
+ - name: description.documentStyle.blockquote.decorations[].anchorData.anchor | type: string | description: The target node's GUID.
126
+ - name: description.documentStyle.blockquote.decorations[].colorData | type: ColorData | description: Data for a color decoration.
127
+ - name: description.documentStyle.blockquote.decorations[].colorData.background | type: string | description: The text's background color as a hexadecimal value.
128
+ - name: description.documentStyle.blockquote.decorations[].colorData.foreground | type: string | description: The text's foreground color as a hexadecimal value.
129
+ - name: description.documentStyle.blockquote.decorations[].fontFamilyData | type: FontFamilyData | description: Data for a font family decoration.
130
+ - name: description.documentStyle.blockquote.decorations[].fontFamilyData.value | type: string | description: none
131
+ - name: description.documentStyle.blockquote.decorations[].fontSizeData | type: FontSizeData | description: Data for a font size decoration.
132
+ - name: description.documentStyle.blockquote.decorations[].fontSizeData.unit | type: FontType | description: The units used for the font size.
133
+ enum: EM, PX
134
+ - name: description.documentStyle.blockquote.decorations[].fontSizeData.value | type: number | description: Font size value.
135
+ - name: description.documentStyle.blockquote.decorations[].fontWeightValue | type: number | description: Font weight for a bold decoration.
136
+ - name: description.documentStyle.blockquote.decorations[].italicData | type: boolean | description: Data for an italic decoration. Defaults to `true`.
137
+ - name: description.documentStyle.blockquote.decorations[].linkData | type: LinkData | description: Data for an external link decoration.
138
+ - name: description.documentStyle.blockquote.decorations[].linkData.link | type: Link | description: Link details.
139
+ - name: description.documentStyle.blockquote.decorations[].linkData.link.customData | type: string | description: A serialized object used for a custom or external link panel.
140
+ - name: description.documentStyle.blockquote.decorations[].linkData.link.rel | type: Rel | description: The HTML `rel` attribute value for the link. This object specifies the relationship between the current document and the linked document.
141
+ - name: description.documentStyle.blockquote.decorations[].linkData.link.rel.nofollow | type: boolean | description: Indicates to search engine crawlers not to follow the link. Defaults to `false`.
142
+ - name: description.documentStyle.blockquote.decorations[].linkData.link.rel.noreferrer | type: boolean | description: Indicates that this link protect referral information from being passed to the target website.
143
+ - name: description.documentStyle.blockquote.decorations[].linkData.link.rel.sponsored | type: boolean | description: Indicates to search engine crawlers that the link is a paid placement such as sponsored content or an advertisement. Defaults to `false`.
144
+ - name: description.documentStyle.blockquote.decorations[].linkData.link.rel.ugc | type: boolean | description: Indicates that this link is user-generated content and isn't necessarily trusted or endorsed by the page’s author. For example, a link in a fourm post. Defaults to `false`.
145
+ - name: description.documentStyle.blockquote.decorations[].linkData.link.target | type: Target | description: he HTML `target` attribute value for the link. This property defines where the linked document opens as follows: `SELF` - Default. Opens the linked document in the same frame as the link. `BLANK` - Opens the linked document in a new browser tab or window. `PARENT` - Opens the linked document in the link's parent frame. `TOP` - Opens the linked document in the full body of the link's browser tab or window.
146
+ enum:
147
+ BLANK: Opens the linked document in a new window or tab
148
+ PARENT: Opens the linked document in the parent frame
149
+ SELF: Opens the linked document in the same frame as it was clicked (this is default)
150
+ TOP: Opens the linked document in the full body of the window
151
+ - ONE-OF:
152
+ - name: description.documentStyle.blockquote.decorations[].linkData.link.anchor | type: string | description: The target node's GUID. Used for linking to another node in this object.
153
+ - name: description.documentStyle.blockquote.decorations[].linkData.link.url | type: string | description: The absolute URL for the linked document.
154
+ - name: description.documentStyle.blockquote.decorations[].mentionData | type: MentionData | description: Data for a mention decoration.
155
+ - name: description.documentStyle.blockquote.decorations[].mentionData.id | type: string | description: Mentioned user's GUID.
156
+ - name: description.documentStyle.blockquote.decorations[].mentionData.name | type: string | description: The mentioned user's name.
157
+ - name: description.documentStyle.blockquote.decorations[].mentionData.slug | type: string | description: The version of the user's name that appears after the `@` character in the mention.
158
+ - name: description.documentStyle.blockquote.decorations[].spoilerData | type: SpoilerData | description: Data for a spoiler decoration.
159
+ - name: description.documentStyle.blockquote.decorations[].spoilerData.id | type: string | description: Spoiler GUID.
160
+ - name: description.documentStyle.blockquote.decorations[].strikethroughData | type: boolean | description: Data for a strikethrough decoration. Defaults to `true`.
161
+ - name: description.documentStyle.blockquote.decorations[].subscriptData | type: boolean | description: Data for a subscript decoration. Defaults to `true`.
162
+ - name: description.documentStyle.blockquote.decorations[].superscriptData | type: boolean | description: Data for a superscript decoration. Defaults to `true`.
163
+ - name: description.documentStyle.blockquote.decorations[].underlineData | type: boolean | description: Data for an underline decoration. Defaults to `true`.
164
+ - name: description.documentStyle.blockquote.lineHeight | type: string | description: Line height for text in the node.
165
+ - name: description.documentStyle.blockquote.nodeStyle | type: NodeStyle | description: Padding and background color for the node.
166
+ - name: description.documentStyle.blockquote.nodeStyle.backgroundColor | type: string | description: The background color as a hexadecimal value.
167
+ - name: description.documentStyle.blockquote.nodeStyle.paddingBottom | type: string | description: The bottom padding value in pixels.
168
+ - name: description.documentStyle.blockquote.nodeStyle.paddingTop | type: string | description: The top padding value in pixels.
169
+ - name: description.documentStyle.codeBlock | type: TextNodeStyle | description: Styling for code block nodes.
170
+ - name: description.documentStyle.headerFive | type: TextNodeStyle | description: Styling for H5 nodes.
171
+ - name: description.documentStyle.headerFour | type: TextNodeStyle | description: Styling for H4 nodes.
172
+ - name: description.documentStyle.headerOne | type: TextNodeStyle | description: Styling for H1 nodes.
173
+ - name: description.documentStyle.headerSix | type: TextNodeStyle | description: Styling for H6 nodes.
174
+ - name: description.documentStyle.headerThree | type: TextNodeStyle | description: Styling for H3 nodes.
175
+ - name: description.documentStyle.headerTwo | type: TextNodeStyle | description: Styling for H2 nodes.
176
+ - name: description.documentStyle.paragraph | type: TextNodeStyle | description: Styling for paragraph nodes.
177
+ - name: description.metadata | type: Metadata | description: Object metadata.
178
+ - name: description.metadata._id | type: string | description: Object GUID.
179
+ - name: description.metadata.version | type: number | description: Schema version.
180
+ - name: description.nodes | type: Array<Node> | description: Node objects representing a rich content document.
181
+ - name: description.nodes[].id | type: string | description: Node GUID.
182
+ - name: description.nodes[].nodes | type: Array<Node> | description: A list of child nodes.
183
+ - name: description.nodes[].style | type: NodeStyle | description: Padding and background color styling for the node.
184
+ - name: description.nodes[].type | type: NodeType | description: Node type. Use `APP_EMBED` for nodes that embed content from other Wix apps. Use `EMBED` to embed content in [oEmbed](https://oembed.com/) format.
185
+ enum: APP_EMBED, AUDIO, BLOCKQUOTE, BULLETED_LIST, BUTTON, CAPTION, CODE_BLOCK, COLLAPSIBLE_ITEM, COLLAPSIBLE_ITEM_BODY, COLLAPSIBLE_ITEM_TITLE, COLLAPSIBLE_LIST, DIVIDER, EMBED, EXTERNAL, FILE, GALLERY, GIF, HEADING, HTML, IMAGE, LAYOUT, LAYOUT_CELL, LINK_PREVIEW, LIST_ITEM, MAP, ORDERED_LIST, PARAGRAPH, POLL, TABLE, TABLE_CELL, TABLE_ROW, TEXT, VIDEO
186
+ - ONE-OF:
187
+ - name: description.nodes[].appEmbedData | type: AppEmbedData | description: Data for an app embed node.
188
+ - name: description.nodes[].appEmbedData.buttonStyles | type: ButtonStyles | description: Button styling options.
189
+ - name: description.nodes[].appEmbedData.buttonStyles.backgroundColor | type: string | description: Background color as a hexadecimal value.
190
+ - name: description.nodes[].appEmbedData.buttonStyles.backgroundColorHover | type: string | description: Background color as a hexadecimal value (hover state).
191
+ - name: description.nodes[].appEmbedData.buttonStyles.borderColor | type: string | description: Border color as a hexadecimal value.
192
+ - name: description.nodes[].appEmbedData.buttonStyles.borderColorHover | type: string | description: Border color as a hexadecimal value (hover state).
193
+ - name: description.nodes[].appEmbedData.buttonStyles.borderRadius | type: number | description: Border radius in pixels.
194
+ - name: description.nodes[].appEmbedData.buttonStyles.borderWidth | type: number | description: Border width in pixels.
195
+ - name: description.nodes[].appEmbedData.buttonStyles.buttonSize | type: string | description: Button size option, one of `SMALL`, `MEDIUM` or `LARGE`. Defaults to `MEDIUM`.
196
+ - name: description.nodes[].appEmbedData.buttonStyles.buttonText | type: string | description: Text to display on the button.
197
+ - name: description.nodes[].appEmbedData.buttonStyles.textColor | type: string | description: Text color as a hexadecimal value.
198
+ - name: description.nodes[].appEmbedData.buttonStyles.textColorHover | type: string | description: Text color as a hexadecimal value (hover state).
199
+ - name: description.nodes[].appEmbedData.cardStyles | type: CardStyles | description: Card styling options.
200
+ - name: description.nodes[].appEmbedData.cardStyles.alignment | type: Alignment | description: Content alignment. Defaults to `START`.
201
+ enum:
202
+ CENTER: Content centered
203
+ END: Content aligned to end (right in LTR layouts, left in RTL layouts)
204
+ START: Content aligned to start (left in LTR layouts, right in RTL layouts)
205
+ - name: description.nodes[].appEmbedData.cardStyles.backgroundColor | type: string | description: Card background color as a hexadecimal value.
206
+ - name: description.nodes[].appEmbedData.cardStyles.borderColor | type: string | description: Card border color as a hexadecimal value.
207
+ - name: description.nodes[].appEmbedData.cardStyles.borderRadius | type: number | description: Card border radius in pixels.
208
+ - name: description.nodes[].appEmbedData.cardStyles.borderWidth | type: number | description: Card border width in pixels.
209
+ - name: description.nodes[].appEmbedData.cardStyles.textColor | type: string | description: Text color as a hexadecimal value.
210
+ - name: description.nodes[].appEmbedData.cardStyles.titleColor | type: string | description: Title text color as a hexadecimal value.
211
+ - name: description.nodes[].appEmbedData.cardStyles.titlePriceLayout | type: Layout | description: Layout for title and price. Defaults to `STACKED`.
212
+ enum:
213
+ SIDE_BY_SIDE: Elements arranged horizontally
214
+ STACKED: Elements stacked vertically
215
+ - name: description.nodes[].appEmbedData.cardStyles.type | type: Type | description: Card type. Defaults to `CONTAINED`.
216
+ enum:
217
+ CONTAINED: Card with visible border and background
218
+ FRAMELESS: Card without visible border
219
+ - name: description.nodes[].appEmbedData.containerData | type: PluginContainerData | description: Styling for the app embed's container.
220
+ - name: description.nodes[].appEmbedData.containerData.alignment | type: PluginContainerDataAlignment | description: The node's alignment within its container.
221
+ enum:
222
+ CENTER: Center Alignment
223
+ LEFT: Left Alignment
224
+ RIGHT: Right Alignment
225
+ - name: description.nodes[].appEmbedData.containerData.height | type: Height | description: The height of the node when it's displayed.
226
+ - name: description.nodes[].appEmbedData.containerData.height.custom | type: string | description: A custom height value in pixels.
227
+ - name: description.nodes[].appEmbedData.containerData.spoiler | type: Spoiler | description: Spoiler cover settings for the node.
228
+ - name: description.nodes[].appEmbedData.containerData.spoiler.buttonText | type: string | description: The text for the button used to remove the spoiler cover.
229
+ - name: description.nodes[].appEmbedData.containerData.spoiler.description | type: string | description: The description displayed on top of the spoiler cover.
230
+ - name: description.nodes[].appEmbedData.containerData.spoiler.enabled | type: boolean | description: Sets whether the spoiler cover is enabled for this node. Defaults to `false`.
231
+ - name: description.nodes[].appEmbedData.containerData.textWrap | type: boolean | description: Sets whether text should wrap around this node when it's displayed. If `textWrap` is `false`, the node takes up the width of its container. Defaults to `true` for all node types except 'DIVIVDER' where it defaults to `false`.
232
+ - name: description.nodes[].appEmbedData.containerData.width | type: PluginContainerDataWidth | description: The width of the node when it's displayed.
233
+ - ONE-OF:
234
+ - name: description.nodes[].appEmbedData.containerData.width.custom | type: string | description: A custom width value in pixels.
235
+ - name: description.nodes[].appEmbedData.containerData.width.size | type: WidthType | description: One of the following predefined width options: `CONTENT`: The width of the container matches the content width. `SMALL`: A small width. `ORIGINAL`: For `imageData` containers only. The width of the container matches the original image width. `FULL_WIDTH`: For `imageData` containers only. The image container takes up the full width of the screen.
236
+ enum:
237
+ CONTENT: Width matches the content width
238
+ FULL_WIDTH: coast-to-coast display
239
+ ORIGINAL: Width will match the original asset width
240
+ SMALL: Small Width
241
+ - name: description.nodes[].appEmbedData.hideButton | type: boolean | description: Whether to hide the button.
242
+ - name: description.nodes[].appEmbedData.hideDateTime | type: boolean | description: Whether to hide the date and time (Event).
243
+ - name: description.nodes[].appEmbedData.hideDescription | type: boolean | description: Whether to hide the description (Event and Booking).
244
+ - name: description.nodes[].appEmbedData.hideDuration | type: boolean | description: Whether to hide the duration (Booking).
245
+ - name: description.nodes[].appEmbedData.hideImage | type: boolean | description: Whether to hide the image.
246
+ - name: description.nodes[].appEmbedData.hideLocation | type: boolean | description: Whether to hide the location (Event).
247
+ - name: description.nodes[].appEmbedData.hidePrice | type: boolean | description: Whether to hide the price.
248
+ - name: description.nodes[].appEmbedData.hideRibbon | type: boolean | description: Whether to hide the ribbon.
249
+ - name: description.nodes[].appEmbedData.hideTitle | type: boolean | description: Whether to hide the title.
250
+ - name: description.nodes[].appEmbedData.image | type: V1Media | description: An image for the embedded content.
251
+ - name: description.nodes[].appEmbedData.image.duration | type: number | description: Media duration in seconds. Only relevant for audio and video files.
252
+ - name: description.nodes[].appEmbedData.image.height | type: number | description: Media height in pixels.
253
+ - name: description.nodes[].appEmbedData.image.src | type: FileSource | description: The source for the media's data.
254
+ - name: description.nodes[].appEmbedData.image.src.private | type: boolean | description: Indicates whether the file's source is private. Defaults to `false`.
255
+ - ONE-OF:
256
+ - name: description.nodes[].appEmbedData.image.src.custom | type: string | description: Custom GUID. Use `id` instead.
257
+ - name: description.nodes[].appEmbedData.image.src.id | type: string | description: An GUID that's resolved to a URL by a resolver function.
258
+ - name: description.nodes[].appEmbedData.image.src.url | type: string | description: The absolute URL for the file's source.
259
+ - name: description.nodes[].appEmbedData.image.width | type: number | description: Media width in pixels.
260
+ - name: description.nodes[].appEmbedData.imageStyles | type: ImageStyles | description: Image styling options.
261
+ - name: description.nodes[].appEmbedData.imageStyles.aspectRatio | type: AspectRatio | description: Aspect ratio for the image. Defaults to `SQUARE`.
262
+ enum:
263
+ RECTANGLE: 16:9 aspect ratio
264
+ SQUARE: 1:1 aspect ratio
265
+ - name: description.nodes[].appEmbedData.imageStyles.borderColor | type: string | description: Image border color as a hexadecimal value.
266
+ - name: description.nodes[].appEmbedData.imageStyles.borderRadius | type: number | description: Image border radius in pixels.
267
+ - name: description.nodes[].appEmbedData.imageStyles.borderWidth | type: number | description: Image border width in pixels.
268
+ - name: description.nodes[].appEmbedData.imageStyles.hideImage | type: boolean | description: Whether to hide the image.
269
+ - name: description.nodes[].appEmbedData.imageStyles.imagePosition | type: Position | description: Position of image. Defaults to `START`.
270
+ enum:
271
+ END: Image positioned at the end (right in LTR layouts, left in RTL layouts)
272
+ START: Image positioned at the start (left in LTR layouts, right in RTL layouts)
273
+ TOP: Image positioned at the top
274
+ - name: description.nodes[].appEmbedData.imageStyles.resizing | type: Resizing | description: How the image should be resized. Defaults to `FILL`.
275
+ enum:
276
+ FILL: Fill the container, may crop the image
277
+ FIT: Fit the image within the container
278
+ - name: description.nodes[].appEmbedData.itemId | type: string | description: The GUID of the embedded content.
279
+ - name: description.nodes[].appEmbedData.name | type: string | description: The name of the embedded content.
280
+ - name: description.nodes[].appEmbedData.pricingData | type: PricingData | description: Pricing data for embedded Wix App content.
281
+ - name: description.nodes[].appEmbedData.pricingData.currency | type: string | description: Currency of the value in ISO 4217 format (e.g., "USD", "EUR").
282
+ - name: description.nodes[].appEmbedData.pricingData.discountedValue | type: string | description: Numeric price value as string after discount application (e.g., "15.99").
283
+ - name: description.nodes[].appEmbedData.pricingData.pricingPlanId | type: string | description: Pricing plan GUID.
284
+ - name: description.nodes[].appEmbedData.pricingData.valueFrom | type: string | description: Minimum numeric price value as string (e.g., "10.99").
285
+ - name: description.nodes[].appEmbedData.pricingData.valueTo | type: string | description: Maximum numeric price value as string (e.g., "19.99").
286
+ - name: description.nodes[].appEmbedData.ribbonStyles | type: RibbonStyles | description: Ribbon styling options.
287
+ - name: description.nodes[].appEmbedData.ribbonStyles.backgroundColor | type: string | description: Ribbon background color as a hexadecimal value.
288
+ - name: description.nodes[].appEmbedData.ribbonStyles.borderColor | type: string | description: Ribbon border color as a hexadecimal value.
289
+ - name: description.nodes[].appEmbedData.ribbonStyles.borderRadius | type: number | description: Ribbon border radius in pixels.
290
+ - name: description.nodes[].appEmbedData.ribbonStyles.borderWidth | type: number | description: Ribbon border width in pixels.
291
+ - name: description.nodes[].appEmbedData.ribbonStyles.ribbonPlacement | type: Placement | description: Placement of the ribbon. Defaults to `IMAGE`.
292
+ enum:
293
+ IMAGE: Ribbon placed on the image
294
+ PRODUCT_INFO: Ribbon placed on the product information
295
+ - name: description.nodes[].appEmbedData.ribbonStyles.ribbonText | type: string | description: Text to display on the ribbon.
296
+ - name: description.nodes[].appEmbedData.ribbonStyles.textColor | type: string | description: Ribbon text color as a hexadecimal value.
297
+ - name: description.nodes[].appEmbedData.type | type: AppType | description: The type of Wix App content being embedded.
298
+ enum: BOOKING, EVENT, PRODUCT
299
+ - name: description.nodes[].appEmbedData.url | type: string | description: The URL for the embedded content.
300
+ - ONE-OF:
301
+ - name: description.nodes[].appEmbedData.bookingData | type: BookingData | description: Data for embedded Wix Bookings content.
302
+ - name: description.nodes[].appEmbedData.bookingData.durations | type: string | description: Booking duration in minutes.
303
+ - name: description.nodes[].appEmbedData.eventData | type: EventData | description: Data for embedded Wix Events content.
304
+ - name: description.nodes[].appEmbedData.eventData.location | type: string | description: Event location.
305
+ - name: description.nodes[].appEmbedData.eventData.scheduling | type: string | description: Event schedule.
306
+ - name: description.nodes[].audioData | type: AudioData | description: Data for an audio node.
307
+ - name: description.nodes[].audioData.audio | type: V1Media | description: Audio file details.
308
+ - name: description.nodes[].audioData.authorName | type: string | description: Author name.
309
+ - name: description.nodes[].audioData.containerData | type: PluginContainerData | description: Styling for the audio node's container.
310
+ - name: description.nodes[].audioData.coverImage | type: V1Media | description: Cover image.
311
+ - name: description.nodes[].audioData.disableDownload | type: boolean | description: Sets whether the audio node's download button is disabled. Defaults to `false`.
312
+ - name: description.nodes[].audioData.html | type: string | description: An HTML version of the audio node.
313
+ - name: description.nodes[].audioData.name | type: string | description: Track name.
314
+ - name: description.nodes[].blockquoteData | type: BlockquoteData | description: Data for a block quote node.
315
+ - name: description.nodes[].blockquoteData.indentation | type: number | description: Indentation level from 1-4.
316
+ - name: description.nodes[].bulletedListData | type: BulletedListData | description: Data for a bulleted list node.
317
+ - name: description.nodes[].bulletedListData.indentation | type: number | description: Indentation level from 0-4.
318
+ - name: description.nodes[].bulletedListData.offset | type: number | description: Offset level from 0-4.
319
+ - name: description.nodes[].buttonData | type: ButtonData | description: Data for a button node.
320
+ - name: description.nodes[].buttonData.containerData | type: PluginContainerData | description: Styling for the button's container.
321
+ - name: description.nodes[].buttonData.link | type: Link | description: Button link details.
322
+ - name: description.nodes[].buttonData.styles | type: Styles | description: Styling for the button.
323
+ - name: description.nodes[].buttonData.styles.backgroundColor | type: string | description: Background color as a hexadecimal value.
324
+ - name: description.nodes[].buttonData.styles.backgroundColorHover | type: string | description: Background color as a hexadecimal value (hover state).
325
+ - name: description.nodes[].buttonData.styles.borderColor | type: string | description: Border color as a hexadecimal value.
326
+ - name: description.nodes[].buttonData.styles.borderColorHover | type: string | description: Border color as a hexadecimal value (hover state).
327
+ - name: description.nodes[].buttonData.styles.borderRadius | type: number | description: Border radius in pixels.
328
+ - name: description.nodes[].buttonData.styles.borderWidth | type: number | description: Border width in pixels.
329
+ - name: description.nodes[].buttonData.styles.buttonSize | type: string | description: Button size option, one of `SMALL`, `MEDIUM` or `LARGE`. Defaults to `MEDIUM`.
330
+ - name: description.nodes[].buttonData.styles.textColor | type: string | description: Text color as a hexadecimal value.
331
+ - name: description.nodes[].buttonData.styles.textColorHover | type: string | description: Text color as a hexadecimal value (hover state).
332
+ - name: description.nodes[].buttonData.text | type: string | description: The text to display on the button.
333
+ - name: description.nodes[].buttonData.type | type: ButtonDataType | description: The button type.
334
+ enum:
335
+ ACTION: Triggers custom action that is defined in plugin configuration by the consumer
336
+ LINK: Regular link button
337
+ - name: description.nodes[].captionData | type: CaptionData | description: Data for a caption node.
338
+ - name: description.nodes[].captionData.textStyle | type: TextStyle | description: none
339
+ - name: description.nodes[].captionData.textStyle.lineHeight | type: string | description: A CSS `line-height` value for the text expressed as a ratio relative to the font size. For example, if the font size is 20px, a `lineHeight` value of `'1.5'`` results in a line height of 30px.
340
+ - name: description.nodes[].captionData.textStyle.textAlignment | type: TextAlignment | description: Text alignment. Defaults to `AUTO`.
341
+ enum:
342
+ AUTO: browser default, eqivalent to `initial`
343
+ CENTER: Center align
344
+ JUSTIFY: Text is spaced to line up its left and right edges to the left and right edges of the line box, except for the last line
345
+ LEFT: Left align
346
+ RIGHT: Right align
347
+ - name: description.nodes[].codeBlockData | type: CodeBlockData | description: Data for a code block node.
348
+ - name: description.nodes[].codeBlockData.textStyle | type: TextStyle | description: Styling for the code block's text.
349
+ - name: description.nodes[].collapsibleListData | type: CollapsibleListData | description: Data for a collapsible list node.
350
+ - name: description.nodes[].collapsibleListData.containerData | type: PluginContainerData | description: Styling for the collapsible list's container.
351
+ - name: description.nodes[].collapsibleListData.direction | type: Direction | description: The direction of the text in the list. Either left-to-right or right-to-left.
352
+ enum:
353
+ LTR: Left-to-right
354
+ RTL: Right-to-left
355
+ - name: description.nodes[].collapsibleListData.expandOnlyOne | type: boolean | description: If `true`, only one item can be expanded at a time. Defaults to `false`.
356
+ - name: description.nodes[].collapsibleListData.initialExpandedItems | type: InitialExpandedItems | description: Sets which items are expanded when the page loads.
357
+ enum:
358
+ ALL: All items will expended initally
359
+ FIRST: First item will be expended initally
360
+ NONE: All items collapsed initally
361
+ - name: description.nodes[].collapsibleListData.isQapageData | type: boolean | description: If `true`, The collapsible item will appear in search results as an FAQ.
362
+ - name: description.nodes[].dividerData | type: DividerData | description: Data for a divider node.
363
+ - name: description.nodes[].dividerData.alignment | type: DividerDataAlignment | description: Divider alignment.
364
+ enum:
365
+ CENTER: Center alignment
366
+ LEFT: Left alignment
367
+ RIGHT: Right alignment
368
+ - name: description.nodes[].dividerData.containerData | type: PluginContainerData | description: Styling for the divider's container.
369
+ - name: description.nodes[].dividerData.lineStyle | type: LineStyle | description: Divider line style.
370
+ enum:
371
+ DASHED: Dashed Line
372
+ DOTTED: Dotted Line
373
+ DOUBLE: Double Line
374
+ SINGLE: Single Line
375
+ - name: description.nodes[].dividerData.width | type: Width | description: Divider width.
376
+ enum:
377
+ LARGE: Large line
378
+ MEDIUM: Medium line
379
+ SMALL: Small line
380
+ - name: description.nodes[].embedData | type: EmbedData | description: Data for an oEmbed node.
381
+ - name: description.nodes[].embedData.containerData | type: PluginContainerData | description: Styling for the oEmbed node's container.
382
+ - name: description.nodes[].embedData.oembed | type: Oembed | description: An [oEmbed](https://www.oembed.com) object.
383
+ - name: description.nodes[].embedData.oembed.authorName | type: string | description: The name of the author or owner of the resource.
384
+ - name: description.nodes[].embedData.oembed.authorUrl | type: string | description: The URL for the author or owner of the resource.
385
+ - name: description.nodes[].embedData.oembed.height | type: number | description: The height of the resource specified in the `url` property in pixels.
386
+ - name: description.nodes[].embedData.oembed.html | type: string | description: HTML for embedding a video player. The HTML should have no padding or margins.
387
+ - name: description.nodes[].embedData.oembed.providerName | type: string | description: The name of the resource provider.
388
+ - name: description.nodes[].embedData.oembed.providerUrl | type: string | description: The URL for the resource provider.
389
+ - name: description.nodes[].embedData.oembed.thumbnailHeight | type: string | description: The height of the resource's thumbnail image. If this property is defined, `thumbnailUrl` and `thumbnailWidth`must also be defined.
390
+ - name: description.nodes[].embedData.oembed.thumbnailUrl | type: string | description: The URL for a thumbnail image for the resource. If this property is defined, `thumbnailWidth` and `thumbnailHeight` must also be defined.
391
+ - name: description.nodes[].embedData.oembed.thumbnailWidth | type: string | description: The width of the resource's thumbnail image. If this property is defined, `thumbnailUrl` and `thumbnailHeight` must also be defined.
392
+ - name: description.nodes[].embedData.oembed.title | type: string | description: Resource title.
393
+ - name: description.nodes[].embedData.oembed.type | type: string | description: The resource type.
394
+ - name: description.nodes[].embedData.oembed.url | type: string | description: The source URL for the resource.
395
+ - name: description.nodes[].embedData.oembed.version | type: string | description: The oEmbed version number. This value must be `1.0`.
396
+ - name: description.nodes[].embedData.oembed.videoUrl | type: string | description: The URL for an embedded viedo.
397
+ - name: description.nodes[].embedData.oembed.width | type: number | description: The width of the resource specified in the `url` property in pixels.
398
+ - name: description.nodes[].embedData.src | type: string | description: Origin asset source.
399
+ - name: description.nodes[].externalData | type: Record<string, any> | description: Data for a custom external node.
400
+ - name: description.nodes[].fileData | type: FileData | description: Data for a file node.
401
+ - name: description.nodes[].fileData.containerData | type: PluginContainerData | description: Styling for the file's container.
402
+ - name: description.nodes[].fileData.mimeType | type: string | description: File MIME type.
403
+ - name: description.nodes[].fileData.name | type: string | description: File name.
404
+ - name: description.nodes[].fileData.path | type: string | description: File path.
405
+ - name: description.nodes[].fileData.pdfSettings | type: PDFSettings | description: Settings for PDF files.
406
+ - name: description.nodes[].fileData.pdfSettings.disableDownload | type: boolean | description: Sets whether the PDF download button is disabled. Defaults to `false`.
407
+ - name: description.nodes[].fileData.pdfSettings.disablePrint | type: boolean | description: Sets whether the PDF print button is disabled. Defaults to `false`.
408
+ - name: description.nodes[].fileData.pdfSettings.viewMode | type: ViewMode | description: PDF view mode. One of the following: `NONE` : The PDF isn't displayed. `FULL` : A full page view of the PDF is displayed. `MINI` : A mini view of the PDF is displayed.
409
+ enum:
410
+ FULL: Full PDF view
411
+ MINI: Mini PDF view
412
+ NONE: No PDF view
413
+ - name: description.nodes[].fileData.sizeInKb | type: string | description: File size in KB.
414
+ - name: description.nodes[].fileData.src | type: FileSource | description: The source for the file's data.
415
+ - name: description.nodes[].fileData.type | type: string | description: File type.
416
+ - name: description.nodes[].galleryData | type: GalleryData | description: Data for a gallery node.
417
+ - name: description.nodes[].galleryData.containerData | type: PluginContainerData | description: Styling for the gallery's container.
418
+ - name: description.nodes[].galleryData.disableDownload | type: boolean | description: Sets whether the gallery's download button is disabled. Defaults to `false`.
419
+ - name: description.nodes[].galleryData.disableExpand | type: boolean | description: Sets whether the gallery's expand button is disabled. Defaults to `false`.
420
+ - name: description.nodes[].galleryData.items | type: Array<Item> | description: The items in the gallery.
421
+ - name: description.nodes[].galleryData.items[].altText | type: string | description: Item's alternative text.
422
+ - name: description.nodes[].galleryData.items[].title | type: string | description: Item title.
423
+ - ONE-OF:
424
+ - name: description.nodes[].galleryData.items[].image | type: Image | description: An image item.
425
+ - name: description.nodes[].galleryData.items[].image.link | type: Link | description: Link details for images that are links.
426
+ - name: description.nodes[].galleryData.items[].image.media | type: V1Media | description: Image file details.
427
+ - name: description.nodes[].galleryData.items[].video | type: Video | description: A video item.
428
+ - name: description.nodes[].galleryData.items[].video.media | type: V1Media | description: Video file details.
429
+ - name: description.nodes[].galleryData.items[].video.thumbnail | type: V1Media | description: Video thumbnail file details.
430
+ - name: description.nodes[].galleryData.options | type: GalleryOptions | description: Options for defining the gallery's appearance.
431
+ - name: description.nodes[].galleryData.options.item | type: ItemStyle | description: Styling for gallery items.
432
+ - name: description.nodes[].galleryData.options.item.crop | type: Crop | description: Sets how item images are cropped.
433
+ enum:
434
+ FILL: Crop to fill
435
+ FIT: Crop to fit
436
+ - name: description.nodes[].galleryData.options.item.ratio | type: number | description: Item ratio
437
+ - name: description.nodes[].galleryData.options.item.spacing | type: number | description: The spacing between items in pixels.
438
+ - name: description.nodes[].galleryData.options.item.targetSize | type: number | description: Desirable dimension for each item in pixels (behvaior changes according to gallery type)
439
+ - name: description.nodes[].galleryData.options.layout | type: GalleryOptionsLayout | description: Gallery layout.
440
+ - name: description.nodes[].galleryData.options.layout.horizontalScroll | type: boolean | description: Sets whether horizontal scroll is enabled. Defaults to `true` unless the layout `type` is set to `GRID` or `COLLAGE`.
441
+ - name: description.nodes[].galleryData.options.layout.mobileNumberOfColumns | type: number | description: The number of columns to display on mobile screens.
442
+ - name: description.nodes[].galleryData.options.layout.numberOfColumns | type: number | description: The number of columns to display on full size screens.
443
+ - name: description.nodes[].galleryData.options.layout.orientation | type: Orientation | description: Gallery orientation.
444
+ enum:
445
+ COLUMNS: Columns Orientation
446
+ ROWS: Rows Orientation
447
+ - name: description.nodes[].galleryData.options.layout.type | type: LayoutType | description: Gallery layout type.
448
+ enum:
449
+ COLLAGE: Collage type
450
+ COLUMN: Column type
451
+ FULLSIZE: Fullsize images type
452
+ GRID: Grid type
453
+ MAGIC: Magic type
454
+ MASONRY: Masonry type
455
+ PANORAMA: Panorama type
456
+ SLIDER: Slider type
457
+ SLIDESHOW: Slideshow type
458
+ THUMBNAIL: Thumbnail type
459
+ - name: description.nodes[].galleryData.options.thumbnails | type: Thumbnails | description: Styling for gallery thumbnail images.
460
+ - name: description.nodes[].galleryData.options.thumbnails.placement | type: ThumbnailsAlignment | description: Thumbnail alignment.
461
+ enum:
462
+ BOTTOM: Bottom alignment
463
+ LEFT: Left alignment
464
+ NONE: No thumbnail
465
+ RIGHT: Right alignment
466
+ TOP: Top alignment
467
+ - name: description.nodes[].galleryData.options.thumbnails.spacing | type: number | description: Spacing between thumbnails in pixels.
468
+ - name: description.nodes[].gifData | type: GIFData | description: Data for a GIF node.
469
+ - name: description.nodes[].gifData.containerData | type: PluginContainerData | description: Styling for the GIF's container.
470
+ - name: description.nodes[].gifData.downsized | type: GIF | description: The source of the downsized GIF.
471
+ - name: description.nodes[].gifData.downsized.gif | type: string | description: GIF format URL.
472
+ - name: description.nodes[].gifData.downsized.mp4 | type: string | description: MP4 format URL.
473
+ - name: description.nodes[].gifData.downsized.still | type: string | description: Thumbnail URL.
474
+ - name: description.nodes[].gifData.gifType | type: GIFType | description: Type of GIF (Sticker or NORMAL). Defaults to `NORMAL`.
475
+ enum: NORMAL, STICKER
476
+ - name: description.nodes[].gifData.height | type: number | description: Height in pixels.
477
+ - name: description.nodes[].gifData.original | type: GIF | description: The source of the full size GIF.
478
+ - name: description.nodes[].gifData.width | type: number | description: Width in pixels.
479
+ - name: description.nodes[].headingData | type: HeadingData | description: Data for a heading node.
480
+ - name: description.nodes[].headingData.indentation | type: number | description: Indentation level from 1-4.
481
+ - name: description.nodes[].headingData.level | type: number | description: Heading level from 1-6.
482
+ - name: description.nodes[].headingData.textStyle | type: TextStyle | description: Styling for the heading text.
483
+ - name: description.nodes[].htmlData | type: HTMLData | description: Data for an embedded HTML node.
484
+ - name: description.nodes[].htmlData.autoHeight | type: boolean | description: If container height is aligned with its content height. Defaults to `true`.
485
+ - name: description.nodes[].htmlData.containerData | type: PluginContainerData | description: Styling for the HTML node's container. Height property is irrelevant for HTML embeds when autoHeight is set to `true`.
486
+ - name: description.nodes[].htmlData.source | type: Source | description: The type of HTML code.
487
+ enum: ADSENSE, AI, HTML
488
+ - ONE-OF:
489
+ - name: description.nodes[].htmlData.html | type: string | description: The HTML code for the node.
490
+ - name: description.nodes[].htmlData.isAdsense | type: boolean | description: Whether this is an AdSense element. Use `source` instead.
491
+ - name: description.nodes[].htmlData.url | type: string | description: The URL for the HTML code for the node.
492
+ - name: description.nodes[].imageData | type: ImageData | description: Data for an image node.
493
+ - name: description.nodes[].imageData.altText | type: string | description: Image's alternative text.
494
+ - name: description.nodes[].imageData.containerData | type: PluginContainerData | description: Styling for the image's container.
495
+ - name: description.nodes[].imageData.decorative | type: boolean | description: Sets whether the image is decorative and does not need an explanation. Defaults to `false`.
496
+ - name: description.nodes[].imageData.disableDownload | type: boolean | description: Sets whether the image's download button is disabled. Defaults to `false`.
497
+ - name: description.nodes[].imageData.disableExpand | type: boolean | description: Sets whether the image expands to full screen when clicked. Defaults to `false`.
498
+ - name: description.nodes[].imageData.image | type: V1Media | description: Image file details.
499
+ - name: description.nodes[].imageData.link | type: Link | description: Link details for images that are links.
500
+ - name: description.nodes[].imageData.styles | type: ImageDataStyles | description: Styling for the image.
501
+ - name: description.nodes[].imageData.styles.border | type: StylesBorder | description: Border attributes.
502
+ - name: description.nodes[].imageData.styles.border.color | type: string | description: Border color as a hexadecimal value.
503
+ - name: description.nodes[].imageData.styles.border.radius | type: number | description: Border radius in pixels.
504
+ - name: description.nodes[].imageData.styles.border.width | type: number | description: Border width in pixels.
505
+ - name: description.nodes[].layoutCellData | type: LayoutCellData | description: Data for a cell node.
506
+ - name: description.nodes[].layoutCellData.colSpan | type: number | description: Size of the cell in 12 columns grid.
507
+ - name: description.nodes[].layoutData | type: LayoutData | description: Data for a layout node. Reserved for future use.
508
+ - name: description.nodes[].layoutData.backdropColor | type: string | description: Backdrop color as a hexadecimal value.
509
+ - name: description.nodes[].layoutData.backdropImage | type: BackgroundImage | description: Backdrop image.radius in pixels.
510
+ - name: description.nodes[].layoutData.backdropImage.media | type: V1Media | description: Background image.
511
+ - name: description.nodes[].layoutData.backdropImage.opacity | type: number | description: Background image opacity.
512
+ - name: description.nodes[].layoutData.backdropImage.position | type: ImagePosition | description: Position of background. Defaults to `CENTER`.
513
+ enum:
514
+ BOTTOM: Image positioned at the center bottom
515
+ BOTTOM_LEFT: Image positioned at the bottom left
516
+ BOTTOM_RIGHT: Image positioned at the bottom right
517
+ CENTER: Image positioned at the center
518
+ CENTER_LEFT: Image positioned on the left
519
+ CENTER_RIGHT: Image positioned on the right
520
+ TOP: Image positioned at the center top
521
+ TOP_LEFT: Image positioned at the top left
522
+ TOP_RIGHT: Image positioned at the top right
523
+ - name: description.nodes[].layoutData.backdropImage.scaling | type: Scaling | description: Background image scaling.
524
+ enum:
525
+ AUTO: Auto image scaling
526
+ CONTAIN: Contain image scaling
527
+ COVER: Cover image scaling
528
+ - name: description.nodes[].layoutData.backdropPaddingBottom | type: number | description: Backdrop bottom padding
529
+ - name: description.nodes[].layoutData.backdropPaddingTop | type: number | description: Backdrop top padding.
530
+ - name: description.nodes[].layoutData.backgroundColor | type: string | description: Background color as a hexadecimal value.
531
+ - name: description.nodes[].layoutData.backgroundImage | type: BackgroundImage | description: Background image.
532
+ - name: description.nodes[].layoutData.borderColor | type: string | description: Border color as a hexadecimal value.
533
+ - name: description.nodes[].layoutData.borderRadius | type: number | description: Border
534
+ - name: description.nodes[].layoutData.borderWidth | type: number | description: Border width in pixels.
535
+ - name: description.nodes[].layoutData.cellPadding | type: Array<number> | description: Padding in pixels for cells. Follows CSS order: top, right, bottom, left
536
+ - name: description.nodes[].layoutData.cellVerticalAlignment | type: VerticalAlignmentAlignment | description: Vertical alignment for the cell's items.
537
+ enum:
538
+ BOTTOM: Bottom alignment
539
+ MIDDLE: Middle alignment
540
+ TOP: Top alignment
541
+ - name: description.nodes[].layoutData.containerData | type: PluginContainerData | description: Styling for the layout's container.
542
+ - name: description.nodes[].layoutData.gap | type: number | description: Horizontal and vertical gap between columns
543
+ - name: description.nodes[].layoutData.responsivenessBehaviour | type: ResponsivenessBehaviour | description: Responsiveness behaviour of columns when responsiveness applies. Either stacks or wrappers.
544
+ enum:
545
+ STACK: Stacking of columns
546
+ WRAP: Wrapping of columns
547
+ - name: description.nodes[].layoutData.responsivenessBreakpoint | type: number | description: Size in pixels when responsiveness_behaviour applies
548
+ - name: description.nodes[].linkPreviewData | type: LinkPreviewData | description: Data for a link preview node.
549
+ - name: description.nodes[].linkPreviewData.containerData | type: PluginContainerData | description: Styling for the link preview's container.
550
+ - name: description.nodes[].linkPreviewData.description | type: string | description: Preview description.
551
+ - name: description.nodes[].linkPreviewData.html | type: string | description: The preview content as HTML.
552
+ - name: description.nodes[].linkPreviewData.link | type: Link | description: Link details.
553
+ - name: description.nodes[].linkPreviewData.styles | type: LinkPreviewDataStyles | description: Styling for the link preview.
554
+ - name: description.nodes[].linkPreviewData.styles.backgroundColor | type: string | description: Background color as a hexadecimal value.
555
+ - name: description.nodes[].linkPreviewData.styles.borderColor | type: string | description: Border color as a hexadecimal value.
556
+ - name: description.nodes[].linkPreviewData.styles.borderRadius | type: number | description: Border radius in pixels.
557
+ - name: description.nodes[].linkPreviewData.styles.borderWidth | type: number | description: Border width in pixels.
558
+ - name: description.nodes[].linkPreviewData.styles.linkColor | type: string | description: Link color as a hexadecimal value.
559
+ - name: description.nodes[].linkPreviewData.styles.subtitleColor | type: string | description: Subtitle color as a hexadecimal value.
560
+ - name: description.nodes[].linkPreviewData.styles.thumbnailPosition | type: StylesPosition | description: Position of thumbnail. Defaults to `START`.
561
+ enum:
562
+ END: Thumbnail positioned at the end (right in LTR layouts, left in RTL layouts)
563
+ HIDDEN: Thumbnail hidden and not displayed
564
+ START: Thumbnail positioned at the start (left in LTR layouts, right in RTL layouts)
565
+ TOP: Thumbnail positioned at the top
566
+ - name: description.nodes[].linkPreviewData.styles.titleColor | type: string | description: Title color as a hexadecimal value.
567
+ - name: description.nodes[].linkPreviewData.thumbnailUrl | type: string | description: Preview thumbnail URL.
568
+ - name: description.nodes[].linkPreviewData.title | type: string | description: Preview title.
569
+ - name: description.nodes[].mapData | type: MapData | description: none
570
+ - name: description.nodes[].mapData.containerData | type: PluginContainerData | description: Styling for the map's container.
571
+ - name: description.nodes[].mapData.mapSettings | type: MapSettings | description: Map settings.
572
+ - name: description.nodes[].mapData.mapSettings.address | type: string | description: The address to display on the map.
573
+ - name: description.nodes[].mapData.mapSettings.draggable | type: boolean | description: Sets whether the map is draggable.
574
+ - name: description.nodes[].mapData.mapSettings.initialZoom | type: number | description: Initial zoom value.
575
+ - name: description.nodes[].mapData.mapSettings.lat | type: number | description: Location latitude.
576
+ - name: description.nodes[].mapData.mapSettings.lng | type: number | description: Location longitude.
577
+ - name: description.nodes[].mapData.mapSettings.locationName | type: string | description: Location name.
578
+ - name: description.nodes[].mapData.mapSettings.mapType | type: MapType | description: Map type. `HYBRID` is a combination of the `ROADMAP` and `SATELLITE` map types.
579
+ enum:
580
+ HYBRID: Hybrid map type
581
+ ROADMAP: Roadmap map type
582
+ SATELITE: Satellite map type
583
+ TERRAIN: Terrain map type
584
+ - name: description.nodes[].mapData.mapSettings.marker | type: boolean | description: Sets whether the location marker is visible.
585
+ - name: description.nodes[].mapData.mapSettings.streetViewControl | type: boolean | description: Sets whether street view control is enabled.
586
+ - name: description.nodes[].mapData.mapSettings.viewModeControl | type: boolean | description: Sets whether view mode control is enabled.
587
+ - name: description.nodes[].mapData.mapSettings.zoomControl | type: boolean | description: Sets whether zoom control is enabled.
588
+ - name: description.nodes[].orderedListData | type: OrderedListData | description: Data for an ordered list node.
589
+ - name: description.nodes[].orderedListData.indentation | type: number | description: Indentation level from 0-4.
590
+ - name: description.nodes[].orderedListData.offset | type: number | description: Offset level from 0-4.
591
+ - name: description.nodes[].orderedListData.start | type: number | description: List start number.
592
+ - name: description.nodes[].paragraphData | type: ParagraphData | description: Data for a paragraph node.
593
+ - name: description.nodes[].paragraphData.indentation | type: number | description: Indentation level from 1-4.
594
+ - name: description.nodes[].paragraphData.level | type: number | description: Paragraph level
595
+ - name: description.nodes[].paragraphData.textStyle | type: TextStyle | description: Styling for the paragraph text.
596
+ - name: description.nodes[].pollData | type: PollData | description: Data for a poll node.
597
+ - name: description.nodes[].pollData.containerData | type: PluginContainerData | description: Styling for the poll's container.
598
+ - name: description.nodes[].pollData.design | type: Design | description: Styling for the poll and voting options.
599
+ - name: description.nodes[].pollData.design.options | type: OptionDesign | description: Styling for voting options.
600
+ - name: description.nodes[].pollData.design.options.borderRadius | type: number | description: Border radius in pixels.
601
+ - name: description.nodes[].pollData.design.poll | type: PollDesign | description: Styling for the poll.
602
+ - name: description.nodes[].pollData.design.poll.background | type: Background | description: Background styling.
603
+ - name: description.nodes[].pollData.design.poll.background.type | type: BackgroundType | description: Background type. For each option, include the relevant details.
604
+ enum:
605
+ COLOR: Color background type
606
+ GRADIENT: Gradiant background type
607
+ IMAGE: Image background type
608
+ - ONE-OF:
609
+ - name: description.nodes[].pollData.design.poll.background.color | type: string | description: The background color as a hexademical value.
610
+ - name: description.nodes[].pollData.design.poll.background.gradient | type: Gradient | description: Details for a gradient background.
611
+ - name: description.nodes[].pollData.design.poll.background.gradient.angle | type: number | description: The gradient angle in degrees.
612
+ - name: description.nodes[].pollData.design.poll.background.gradient.lastColor | type: string | description: The end color as a hexademical value.
613
+ - name: description.nodes[].pollData.design.poll.background.gradient.startColor | type: string | description: The start color as a hexademical value.
614
+ - name: description.nodes[].pollData.design.poll.background.image | type: V1Media | description: An image to use for the background.
615
+ - name: description.nodes[].pollData.design.poll.borderRadius | type: number | description: Border radius in pixels.
616
+ - name: description.nodes[].pollData.layout | type: PollDataLayout | description: Layout settings for the poll and voting options.
617
+ - name: description.nodes[].pollData.layout.options | type: OptionLayout | description: Voting otpions layout settings.
618
+ - name: description.nodes[].pollData.layout.options.enableImage | type: boolean | description: Sets whether to display option images. Defaults to `false`.
619
+ - name: description.nodes[].pollData.layout.poll | type: PollLayout | description: Poll layout settings.
620
+ - name: description.nodes[].pollData.layout.poll.direction | type: PollLayoutDirection | description: The direction of the text displayed in the voting options. Text can be displayed either right-to-left or left-to-right.
621
+ enum:
622
+ LTR: Left-to-right
623
+ RTL: Right-to-left
624
+ - name: description.nodes[].pollData.layout.poll.enableImage | type: boolean | description: Sets whether to display the main poll image. Defaults to `false`.
625
+ - name: description.nodes[].pollData.layout.poll.type | type: PollLayoutType | description: The layout for displaying the voting options.
626
+ enum:
627
+ GRID: Grid
628
+ LIST: List
629
+ - name: description.nodes[].pollData.poll | type: Poll | description: Poll data.
630
+ - name: description.nodes[].pollData.poll.creatorId | type: string | description: Poll creator GUID.
631
+ - name: description.nodes[].pollData.poll.id | type: string | description: Poll GUID.
632
+ - name: description.nodes[].pollData.poll.image | type: V1Media | description: Main poll image.
633
+ - name: description.nodes[].pollData.poll.options | type: Array<Option> | description: Voting options.
634
+ - name: description.nodes[].pollData.poll.options[].id | type: string | description: Option GUID.
635
+ - name: description.nodes[].pollData.poll.options[].image | type: V1Media | description: The image displayed with the option.
636
+ - name: description.nodes[].pollData.poll.options[].title | type: string | description: Option title.
637
+ - name: description.nodes[].pollData.poll.settings | type: PollSettings | description: The poll's permissions and display settings.
638
+ - name: description.nodes[].pollData.poll.settings.permissions | type: Permissions | description: Permissions settings for voting.
639
+ - name: description.nodes[].pollData.poll.settings.permissions.allowMultipleVotes | type: boolean | description: Sets whether one voter can vote multiple times. Defaults to `false`.
640
+ - name: description.nodes[].pollData.poll.settings.permissions.view | type: ViewRole | description: Sets who can view the poll results.
641
+ enum:
642
+ CREATOR: Only Poll creator can view the results
643
+ EVERYONE: Anyone can see the results, even if one didn't vote
644
+ VOTERS: Anyone who voted can see the results
645
+ - name: description.nodes[].pollData.poll.settings.permissions.vote | type: VoteRole | description: Sets who can vote.
646
+ enum:
647
+ ALL: Anyone
648
+ SITE_MEMBERS: Logged in member
649
+ - name: description.nodes[].pollData.poll.settings.showVoters | type: boolean | description: Sets whether voters are displayed in the vote results. Defaults to `true`.
650
+ - name: description.nodes[].pollData.poll.settings.showVotesCount | type: boolean | description: Sets whether the vote count is displayed. Defaults to `true`.
651
+ - name: description.nodes[].pollData.poll.title | type: string | description: Poll title.
652
+ - name: description.nodes[].tableCellData | type: TableCellData | description: Data for a table cell node.
653
+ - name: description.nodes[].tableCellData.borderColors | type: BorderColors | description: The cell's border colors.
654
+ - name: description.nodes[].tableCellData.borderColors.bottom | type: string | description: Bottom border color as a hexadecimal value.
655
+ - name: description.nodes[].tableCellData.borderColors.left | type: string | description: Left border color as a hexadecimal value.
656
+ - name: description.nodes[].tableCellData.borderColors.right | type: string | description: Right border color as a hexadecimal value.
657
+ - name: description.nodes[].tableCellData.borderColors.top | type: string | description: Top border color as a hexadecimal value.
658
+ - name: description.nodes[].tableCellData.borderWidths | type: BorderWidths | description: The cell's border widths.
659
+ - name: description.nodes[].tableCellData.borderWidths.bottom | type: number | description: Bottom border width in pixels.
660
+ - name: description.nodes[].tableCellData.borderWidths.left | type: number | description: Left border width in pixels.
661
+ - name: description.nodes[].tableCellData.borderWidths.right | type: number | description: Right border width in pixels.
662
+ - name: description.nodes[].tableCellData.borderWidths.top | type: number | description: Top border width in pixels.
663
+ - name: description.nodes[].tableCellData.cellStyle | type: CellStyle | description: Styling for the cell's background color and text alignment.
664
+ - name: description.nodes[].tableCellData.cellStyle.backgroundColor | type: string | description: Cell background color as a hexadecimal value.
665
+ - name: description.nodes[].tableCellData.cellStyle.verticalAlignment | type: VerticalAlignment | description: Vertical alignment for the cell's text.
666
+ enum:
667
+ BOTTOM: Bottom alignment
668
+ MIDDLE: Middle alignment
669
+ TOP: Top alignment
670
+ - name: description.nodes[].tableCellData.colspan | type: number | description: Defines how many columns the cell spans. Default: 1.
671
+ - name: description.nodes[].tableCellData.rowspan | type: number | description: Defines how many rows the cell spans. Default: 1.
672
+ - name: description.nodes[].tableData | type: TableData | description: Data for a table node.
673
+ - name: description.nodes[].tableData.cellPadding | type: Array<number> | description: Padding in pixels for cells. Follows CSS order: top, right, bottom, left.
674
+ - name: description.nodes[].tableData.cellSpacing | type: number | description: The spacing between cells in pixels. Defaults to `0`.
675
+ - name: description.nodes[].tableData.columnHeader | type: boolean | description: Sets whether the table's first column is a header. Defaults to `false`.
676
+ - name: description.nodes[].tableData.containerData | type: PluginContainerData | description: Styling for the table's container.
677
+ - name: description.nodes[].tableData.dimensions | type: Dimensions | description: The table's dimensions.
678
+ - name: description.nodes[].tableData.dimensions.colsMinWidth | type: Array<number> | description: An array representing the minimum width of each column in pixels.
679
+ - name: description.nodes[].tableData.dimensions.colsWidthRatio | type: Array<number> | description: An array representing relative width of each column in relation to the other columns.
680
+ - name: description.nodes[].tableData.dimensions.rowsHeight | type: Array<number> | description: An array representing the height of each row in pixels.
681
+ - name: description.nodes[].tableData.rowHeader | type: boolean | description: Sets whether the table's first row is a header. Defaults to `false`.
682
+ - name: description.nodes[].textData | type: TextData | description: Data for a text node. Used to apply decorations to text.
683
+ - name: description.nodes[].textData.decorations | type: Array<Decoration> | description: The decorations to apply.
684
+ - name: description.nodes[].textData.text | type: string | description: The text to apply decorations to.
685
+ - name: description.nodes[].videoData | type: VideoData | description: Data for a video node.
686
+ - name: description.nodes[].videoData.containerData | type: PluginContainerData | description: Styling for the video's container.
687
+ - name: description.nodes[].videoData.disableDownload | type: boolean | description: Sets whether the video's download button is disabled. Defaults to `false`.
688
+ - name: description.nodes[].videoData.options | type: PlaybackOptions | description: Video options.
689
+ - name: description.nodes[].videoData.options.autoPlay | type: boolean | description: Sets whether the media will automatically start playing.
690
+ - name: description.nodes[].videoData.options.playInLoop | type: boolean | description: Sets whether media's will be looped.
691
+ - name: description.nodes[].videoData.options.showControls | type: boolean | description: Sets whether media's controls will be shown.
692
+ - name: description.nodes[].videoData.thumbnail | type: V1Media | description: Video thumbnail details.
693
+ - name: description.nodes[].videoData.title | type: string | description: Video title.
694
+ - name: description.nodes[].videoData.video | type: V1Media | description: Video details.
695
+ - name: directCategoriesInfo | type: ProductCategoriesInfo | description: List of categories that directly contain this product. Updated automatically when a product is added/removed from a category, when an item is moved within a category, or when a category is deleted. > **Note:** Returned only when you pass `"DIRECT_CATEGORIES_INFO"` to the `fields` array in Products API requests.
696
+ - name: extendedFields | type: ExtendedFields | description: Custom extended fields for the product object. [Extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields) must be configured in the app dashboard before they can be accessed with API calls.
697
+ - name: extendedFields.namespaces | type: Record<string, undefined> | description: Extended field data. Each key corresponds to the namespace of the app that created the extended fields. The value of each key is structured according to the schema defined when the extended fields were configured. You can only access fields for which you have the appropriate permissions. Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields).
698
+ - name: handle | type: string | description: A unique human-friendly identifier for the product. Unlike the product GUID, the handle can be set by the user to ensure consistency across multiple platforms. In case handle wasn't given, the handle will be automatically generated.
699
+ - name: infoSections | type: Array<InfoSection> | description: Product info section. + Pass `infoSection.uniqueName`, `infoSection.title`, and `infoSection.description` to add a new info section while creating a product. + Pass an existing info section's `id` or `uniqueName` to assign that info section to the product.
700
+ - name: infoSections[]._id | type: string | description: Info section GUID.
701
+ - name: infoSections[].description | type: RichContent | description: Info section description using rich content. > **Note:** Returned only when you pass `"INFO_SECTION_DESCRIPTION"` to the `fields` array in Products API requests. <widget src="https://apps.wix.com/_serverless/ricos-playground-services/goto/api-component" plugins="indent.emoji.divider.codeBlock.file.gallery.giphy.image.table.link.textHighlight.textColor" exampleid="7dc9240e-d548-417a-abcf-0291b68b4303"> <a href="https://dev.wix.com/docs/ricos/api-reference/ricos-document">See Ricos document reference</a> </widget>
702
+ - name: infoSections[].plainDescription | type: string | description: Info section description in HTML. When provided on create/update, this string must be a valid HTML. It will then be converted to rich content. `plainDescription` is ignored when value is also passed to the `description` field. > **Note:** Returned only when you pass `"INFO_SECTION_PLAIN_DESCRIPTION"` to the `fields` array in Products API requests.
703
+ - name: infoSections[].title | type: string | description: Info section title. > **Note:** Returned only when you pass `"INFO_SECTION"` to the `fields` array in Products API requests.
704
+ - name: infoSections[].uniqueName | type: string | description: Info section unique name. > **Note:** Returned only when you pass `"INFO_SECTION"` to the `fields` array in Products API requests.
705
+ - name: inventory | type: Inventory | description: Product inventory info.
706
+ - name: inventory.availabilityStatus | type: InventoryAvailabilityStatus | description: Current availability status.
707
+ enum:
708
+ IN_STOCK: All variants are in stock and available for purchase.
709
+ OUT_OF_STOCK: All variants are out of stock.
710
+ PARTIALLY_OUT_OF_STOCK: Some variants are out of stock and some are in stock and available for purchase.
711
+ UNKNOWN_AVAILABILITY_STATUS
712
+ - name: inventory.preorderAvailability | type: ProductPreorderAvailability | description: Preorder availability status.
713
+ enum:
714
+ ALL_VARIANTS: All the product variants are available for preorder.
715
+ NO_VARIANTS: None of the product variants are available for preorder.
716
+ SOME_VARIANTS: Some of the product variants are available for preorder.
717
+ UNKNOWN_PREORDER_AVAILABILITY_STATUS
718
+ - name: inventory.preorderStatus | type: PreorderStatus | description: Current preorder status.
719
+ enum:
720
+ DISABLED: All variants are disabled for preorder.
721
+ ENABLED: All variants are enabled for preorder.
722
+ PARTIALLY_ENABLED: Some variants are disabled and some are enabled for preorder.
723
+ UNKNOWN_PREORDER_STATUS
724
+ - name: mainCategoryId | type: string | description: The GUID of the product's primary direct category, which defines the product’s breadcrumbs path. For example, if the product's main category is "T-Shirts" (which is a subcategory of "Clothing"), the breadcrumbs path will be "Clothing > T-Shirts".
725
+ - name: media | type: Media | description: Product media items.
726
+ - name: media.itemsInfo | type: MediaItemsInfo | description: All media items. > **Note:** Returned only when you pass `"MEDIA_ITEMS_INFO"` to the `fields` array in Products API requests.
727
+ - name: media.itemsInfo.items | type: Array<ProductMedia> | description: All media items (images, videos etc) associated with this product.
728
+ - name: media.itemsInfo.items[].altText | type: string | description: Image alt text.
729
+ - name: media.itemsInfo.items[].displayName | type: string | description: Media display name. Allows to override the default media name. Can be passed only when `setBy: url`.
730
+ - name: media.itemsInfo.items[].mediaType | type: MediaType | description: Media type.
731
+ enum:
732
+ IMAGE: Image media type.
733
+ UNKNOWN_MEDIA_TYPE, VIDEO: Video media type.
734
+ - name: media.itemsInfo.items[].thumbnail | type: Thumbnail | description: Media thumbnail. > **Note:** Returned only when you pass `"THUMBNAIL"` to the `fields` array in Products API requests.
735
+ - name: media.itemsInfo.items[].thumbnail.altText | type: string | description: Thumbnail alt text.
736
+ - name: media.itemsInfo.items[].thumbnail.height | type: number | description: Thumbnail height.
737
+ - name: media.itemsInfo.items[].thumbnail.url | type: string | description: Thumbnail url.
738
+ - name: media.itemsInfo.items[].thumbnail.width | type: number | description: Thumbnail width.
739
+ - name: media.itemsInfo.items[].uploadId | type: string | description: GUID used to upload media to Wix Media Manager.
740
+ - ONE-OF:
741
+ - name: media.itemsInfo.items[]._id | type: string | description: Set media by GUID of an existing file in Wix Media Manager.
742
+ - name: media.itemsInfo.items[].url | type: string | description: Set media using an external media URL.
743
+ - ONE-OF:
744
+ - name: media.itemsInfo.items[].image | type: string | description: Product image.
745
+ - name: media.itemsInfo.items[].video | type: string | description: Product video.
746
+ - name: media.main | type: ProductMedia | description: Main media (image, video, etc.) associated with this product.
747
+ - name: modifiers | type: Array<ConnectedModifier> | description: Product modifiers. Allows the customer to customize product, e.g. select Color, Size and so on similarly to `options` but with one main difference - `modifiers` never generate any variants.
748
+ - name: modifiers[]._id | type: string | description: GUID of a customization with `customizationType: MODIFIER`.
749
+ - name: modifiers[].mandatory | type: boolean | description: Whether customer input is required for this modifier.
750
+ - name: modifiers[].modifierRenderType | type: ModifierRenderType | description: Modifier render type.
751
+ enum:
752
+ FREE_TEXT: Free text.
753
+ SWATCH_CHOICES: Swatch choices.
754
+ TEXT_CHOICES: Text choices.
755
+ UNKNOWN_MODIFIER_RENDER_TYPE: Not implemented.
756
+ - name: modifiers[].name | type: string | description: Modifier title.
757
+ - ONE-OF:
758
+ - name: modifiers[].choicesSettings | type: ModifierChoicesSettings | description: Choice settings.
759
+ - name: modifiers[].choicesSettings.choices | type: Array<ConnectedModifierChoice> | description: List of modifier choices.
760
+ - name: modifiers[].choicesSettings.choices[].addedPrice | type: string | description: Added price.
761
+ - name: modifiers[].choicesSettings.choices[].choiceId | type: string | description: Choice GUID.
762
+ - name: modifiers[].choicesSettings.choices[].choiceType | type: ChoiceType | description: Choice type.
763
+ enum:
764
+ CHOICE_TEXT: Text choice.
765
+ IMAGE: Image choice.
766
+ MULTIPLE_COLORS: Multiple colors choice.
767
+ ONE_COLOR: Single color choice.
768
+ UNKNOWN_CHOICE_TYPE
769
+ - name: modifiers[].choicesSettings.choices[].key | type: string | description: Modifier key. Used for eCommerce integration.
770
+ - name: modifiers[].choicesSettings.choices[].linkedMedia | type: Array<ProductMedia> | description: Product media.
771
+ - name: modifiers[].choicesSettings.choices[].name | type: string | description: Choice name.
772
+ - ONE-OF:
773
+ - name: modifiers[].choicesSettings.choices[].colorCode | type: string | description: Color code in HEX format, [as described by MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/hex-color).
774
+ - name: modifiers[].freeTextSettings | type: FreeTextSettings | description: Free text modifier settings.
775
+ - name: modifiers[].freeTextSettings.defaultAddedPrice | type: string | description: Default amount to be added to the product's price.
776
+ - name: modifiers[].freeTextSettings.maxCharCount | type: number | description: Maximum number of characters.
777
+ - name: modifiers[].freeTextSettings.minCharCount | type: number | description: Minimum number of characters.
778
+ - name: modifiers[].freeTextSettings.title | type: string | description: Title of the text to be input by the customer.
779
+ - name: name | type: string | description: Product name. Translatable.
780
+ - name: options | type: Array<ConnectedOption> | description: Product options. Allows the customer to customize the product. For example, selecting color, size, and more. Always generates variants: every variant must have exactly one choice related to each option. Since options and variants tightly coupled and rely on each other they usually should be provided together in all operations.
781
+ - name: options[]._id | type: string | description: GUID of a customization with `customizationType: PRODUCT_OPTION`.
782
+ - name: options[].name | type: string | description: Option name.
783
+ - name: options[].optionRenderType | type: ProductOptionRenderType | description: Option render type.
784
+ enum:
785
+ SWATCH_CHOICES: Swatch choices.
786
+ TEXT_CHOICES: Text choices.
787
+ UNKNOWN_OPTION_RENDER_TYPE: Not implemented.
788
+ - ONE-OF:
789
+ - name: options[].choicesSettings | type: ChoicesSettings | description: Choices settings.
790
+ - name: options[].choicesSettings.choices | type: Array<ConnectedOptionChoice> | description: List of available choices for the option.
791
+ - name: options[].choicesSettings.choices[].choiceId | type: string | description: The id of the choice.
792
+ - name: options[].choicesSettings.choices[].choiceType | type: ChoiceType | description: The type of this choice.
793
+ - name: options[].choicesSettings.choices[].inStock | type: boolean | description: A flag that indicates if at least one variant with this choice is in stock in the default store's location. For example, a product with 'Color' and 'Size' options with variants: [Blue, Small] which is out of stock and [Red Large] which is in stock. For choice 'Blue' ths flag will be 'false' and for 'Red' the flag will be true
794
+ - name: options[].choicesSettings.choices[].linkedMedia | type: Array<ProductMedia> | description: Product media overrides. When not empty only these images will be shown when such choices selected by customer. Otherwise all images of product. When several choices from different options selected only media filter present in `media_overrides` of ALL choices will be shown. For example if Color:red has images 1,2,3 and Material:Silk has images 2,3,5 then only images 2,3 will be shown when both of them selected.
795
+ - name: options[].choicesSettings.choices[].name | type: string | description: Choice name.
796
+ - name: options[].choicesSettings.choices[].visible | type: boolean | description: Whether at least one variant with this choice is visible. Default: `false`
797
+ - ONE-OF:
798
+ - name: options[].choicesSettings.choices[].colorCode | type: string | description: Color code in HEX format, [as described by MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/hex-color).
799
+ - name: plainDescription | type: string | description: Product description in HTML. + When provided on create/update, this string must be a valid HTML. It will then be converted to rich content. + `plainDescription` is ignored when value is also passed to the `description` field. > **Note:** Returned only when you pass `"PLAIN_DESCRIPTION"` to the `fields` array in Products API requests.
800
+ - name: productType | type: ProductType | description: Product type. When passing `productType: PHYSICAL`, you must also pass `physicalProperties`.
801
+ enum:
802
+ DIGITAL: Digital product.
803
+ PHYSICAL: Physical product.
804
+ UNKNOWN_PRODUCT_TYPE: Not implemented.
805
+ - name: revision | type: string | description: Revision number, which increments by 1 each time the product is updated. To prevent conflicting changes, the current revision must be passed when updating the product. Ignored when creating a product.
806
+ - name: ribbon | type: Ribbon | description: Product ribbon. + Pass `ribbon.name` to add a new ribbon while creating a product. + Pass an existing ribbon's `id` or `name` to assign that ribbon to the product.
807
+ - name: ribbon._id | type: string | description: Ribbon GUID.
808
+ - name: ribbon.name | type: string | description: Ribbon name.
809
+ - name: seoData | type: SeoSchema | description: Product SEO data.
810
+ - name: seoData.settings | type: Settings | description: SEO general settings.
811
+ - name: seoData.settings.keywords | type: Array<Keyword> | description: User-selected keyword terms for a specific page.
812
+ - name: seoData.settings.keywords[].isMain | type: boolean | description: Whether the keyword is the main focus keyword.
813
+ - name: seoData.settings.keywords[].origin | type: string | description: The source that added the keyword terms to the SEO settings.
814
+ - name: seoData.settings.keywords[].term | type: string | description: Keyword value.
815
+ - name: seoData.settings.preventAutoRedirect | type: boolean | description: Whether the [automatical redirect visits](https://support.wix.com/en/article/customizing-your-pages-seo-settings-in-the-seo-panel) from the old URL to the new one is enabled. Default: `false` (automatical redirect is enabled).
816
+ - name: seoData.tags | type: Array<Tag> | description: SEO tag information.
817
+ - name: seoData.tags[].children | type: string | description: SEO tag inner content. For example, `<title> inner content </title>`.
818
+ - name: seoData.tags[].custom | type: boolean | description: Whether the tag is a [custom tag](https://support.wix.com/en/article/adding-additional-meta-tags-to-your-sites-pages).
819
+ - name: seoData.tags[].disabled | type: boolean | description: Whether the tag is disabled. If the tag is disabled, people can't find your page when searching for this phrase in search engines.
820
+ - name: seoData.tags[].meta | type: Record<string, any> | description: SEO tag metadata. For example, `{"height": 300, "width": 240}`.
821
+ - name: seoData.tags[].props | type: Record<string, any> | description: A `{"key": "value"}` pair object where each SEO tag property (`"name"`, `"content"`, `"rel"`, `"href"`) contains a value. For example: `{"name": "description", "content": "the description itself"}`.
822
+ - name: seoData.tags[].type | type: string | description: SEO tag type. Supported values: `title`, `meta`, `script`, `link`.
823
+ - name: slug | type: string | description: Product slug. If not provided, the slug is autogenerated based on the product name.
824
+ - name: subscriptionDetails | type: SubscriptionDetails | description: Product subscriptions.
825
+ - name: subscriptionDetails.allowOneTimePurchases | type: boolean | description: Whether to allow one-time purchases in addition to subscription-based purchases. Default: `false`
826
+ - name: subscriptionDetails.subscriptions | type: Array<Subscription> | description: Subscriptions.
827
+ - name: subscriptionDetails.subscriptions[]._id | type: string | description: Subscription GUID.
828
+ - name: subscriptionDetails.subscriptions[].description | type: string | description: Subscription description.
829
+ - name: subscriptionDetails.subscriptions[].discount | type: SubscriptionDiscount | description: Discount info (optional). For example, a $20 discount would be `amount: 20`, `type: AMOUNT`.
830
+ - name: subscriptionDetails.subscriptions[].discount.type | type: DiscountType | description: Discount type.
831
+ enum:
832
+ AMOUNT: Discount by a specific amount.
833
+ PERCENT: Discount by a percentage.
834
+ UNKNOWN_DISCOUNT
835
+ - ONE-OF:
836
+ - name: subscriptionDetails.subscriptions[].discount.amountOff | type: string | description: Amount to discount from the variant discounted_price.
837
+ - name: subscriptionDetails.subscriptions[].discount.percentOff | type: number | description: Percentage to discount from variant discounted_price.
838
+ - name: subscriptionDetails.subscriptions[].frequency | type: SubscriptionFrequency | description: Frequency of recurring payment. For example, if `frequency: MONTH` and `billingCycles: 6`; payment will be made monthly for 6 months.
839
+ enum: DAY, MONTH, UNDEFINED, WEEK, YEAR
840
+ - name: subscriptionDetails.subscriptions[].interval | type: number | description: Interval of recurring payment. Default: `1`. For example, if `frequency: MONTH`, `billingCycles: 3` and `interval: 2`; payment will be made every 2 months for a total of 6 months.
841
+ - name: subscriptionDetails.subscriptions[].title | type: string | description: Subscription title.
842
+ - name: subscriptionDetails.subscriptions[].visible | type: boolean | description: Whether the subscription is visible to site visitors. Default: `true`
843
+ - ONE-OF:
844
+ - name: subscriptionDetails.subscriptions[].autoRenewal | type: boolean | description: Whether subscription is renewed automatically at the end of each period. Cannot be `false`, instead set `billingCycles`.
845
+ - name: subscriptionDetails.subscriptions[].billingCycles | type: number | description: Number of billing cycles before subscription ends.
846
+ - name: taxGroupId | type: string | description: Tax group GUID.
847
+ - name: url | type: string | description: URL to the site's product page. > **Note:** Returned only when you pass `"URL"` to the `fields` array in Products API requests.
848
+ - name: variantSummary | type: VariantSummary | description: The total number of variants for the product.
849
+ - name: variantSummary.variantCount | type: number | description: The total number of variants for the product.
850
+ - name: variantsInfo | type: VariantsInfo | description: Product variants. Each variant must reference all product options via its `choices` array. Each choice references an option using `optionChoiceNames` for all requests.
851
+ - name: variantsInfo.variants | type: Array<Variant> | description: List of related variants.
852
+ - name: variantsInfo.variants[]._id | type: string | description: Variant GUID.
853
+ - name: variantsInfo.variants[].barcode | type: string | description: Variant barcode.
854
+ - name: variantsInfo.variants[].choices | type: Array<OptionChoice> | description: List of choices that define the product's variant, which requires exactly one choice per product option. Must use `optionChoiceNames` in all requests this field is required. Empty only for default variants of unmanaged products.
855
+ - name: variantsInfo.variants[].choices[].optionChoiceIds | type: OptionChoiceIds | description: Option and choice GUIDs. These match the GUIDs of the option and choice from the product's options field.
856
+ - name: variantsInfo.variants[].choices[].optionChoiceIds.choiceId | type: string | description: Choice GUID.
857
+ - name: variantsInfo.variants[].choices[].optionChoiceIds.optionId | type: string | description: Option GUID.
858
+ - name: variantsInfo.variants[].choices[].optionChoiceNames | type: OptionChoiceNames | description: Option and choice names. This needs to be used in all requests `OptionChoice` is needed, and all `OptionChoiceNames` fields are required. > **Note:** Returned only when you pass `"VARIANT_OPTION_CHOICE_NAMES"` to the `fields` array in Products API requests.
859
+ - name: variantsInfo.variants[].choices[].optionChoiceNames.choiceName | type: string | description: Choice name.
860
+ - name: variantsInfo.variants[].choices[].optionChoiceNames.optionName | type: string | description: Option name.
861
+ - name: variantsInfo.variants[].choices[].optionChoiceNames.renderType | type: ProductOptionRenderType | description: Render type.
862
+ - name: variantsInfo.variants[].inventoryStatus | type: InventoryStatus | description: Variant inventory status.
863
+ - name: variantsInfo.variants[].inventoryStatus.inStock | type: boolean | description: Whether the variant is in stock.
864
+ - name: variantsInfo.variants[].inventoryStatus.preorderEnabled | type: boolean | description: Whether preorder is enabled for this variant.
865
+ - name: variantsInfo.variants[].media | type: ProductMedia | description: Variant media.
866
+ - name: variantsInfo.variants[].price | type: PriceInfo | description: Variant price.
867
+ - name: variantsInfo.variants[].price.actualPrice | type: FixedMonetaryAmount | description: Variant price. Must be greater or equal to 0.
868
+ - name: variantsInfo.variants[].price.compareAtPrice | type: FixedMonetaryAmount | description: The compare-at-price represents the original price of a product before any discount. It is optional and should only be set if a discount applies. When set, it must be higher than the current price to reflect accurate savings.
869
+ - name: variantsInfo.variants[].revenueDetails | type: RevenueDetails | description: Variant revenue details. > **Note:** Returned only when the following conditions are met: > + You pass `"MERCHANT_DATA"` to the `fields` array in Products API requests. > + Your app has the required `SCOPE.STORES.PRODUCT_READ_ADMIN` permission scope.
870
+ - name: variantsInfo.variants[].revenueDetails.cost | type: FixedMonetaryAmount | description: Item cost.
871
+ - name: variantsInfo.variants[].revenueDetails.profit | type: FixedMonetaryAmount | description: Profit. Calculated by reducing `cost` from `discountedPrice`.
872
+ - name: variantsInfo.variants[].revenueDetails.profitMargin | type: number | description: Profit Margin. Calculated by dividing `profit` by `discountedPrice`. The result is rounded to 4 decimal places.
873
+ - name: variantsInfo.variants[].sku | type: string | description: Variant SKU (stock keeping unit).
874
+ - name: variantsInfo.variants[].subscriptionPricesInfo | type: SubscriptionPricesInfo | description: Subscription prices calculated by applying subscription discount to the variant `price.actual_price`. > **Note:** Returned only when you pass `"SUBSCRIPTION_PRICES_INFO"` to the `fields` array in Products API requests.
875
+ - name: variantsInfo.variants[].subscriptionPricesInfo.subscriptionPrices | type: Array<SubscriptionPrice> | description: Subscription prices.
876
+ - name: variantsInfo.variants[].subscriptionPricesInfo.subscriptionPrices[].price | type: FixedMonetaryAmount | description: Subscription price calculated by applying subscription discount to the variant `price.actual_price`
877
+ - name: variantsInfo.variants[].subscriptionPricesInfo.subscriptionPrices[].pricePerUnit | type: SubscriptionPricePerUnit | description: Price per unit info.
878
+ - name: variantsInfo.variants[].subscriptionPricesInfo.subscriptionPrices[].pricePerUnit.description | type: string | description: Price per unit description. > **Note:** Returned only when you pass `"CURRENCY"` to the `fields` array in Products API requests.
879
+ - name: variantsInfo.variants[].subscriptionPricesInfo.subscriptionPrices[].pricePerUnit.value | type: string | description: Calculated value of price per unit. Takes into account `pricePerUnit` settings of parent product, `pricePerUnit` settings of this variant, and the variant subscription price.
880
+ - name: variantsInfo.variants[].subscriptionPricesInfo.subscriptionPrices[].subscriptionId | type: string | description: Subscription GUID.
881
+ - name: variantsInfo.variants[].visible | type: boolean | description: Whether the variant is visible to site visitors. Default: `true`
882
+ - ONE-OF:
883
+ - name: variantsInfo.variants[].digitalProperties | type: VariantDigitalProperties | description: Digital properties. Must be passed when `productType: DIGITAL`
884
+ - name: variantsInfo.variants[].digitalProperties.digitalFile | type: SecuredMedia | description: Digital file which will be downloaded by customer after successful purchase.
885
+ - name: variantsInfo.variants[].digitalProperties.digitalFile._id | type: string | description: Media GUID in media manager.
886
+ - name: variantsInfo.variants[].digitalProperties.digitalFile.fileName | type: string | description: Original file name.
887
+ - name: variantsInfo.variants[].digitalProperties.digitalFile.fileSize | type: string | description: Original file size.
888
+ - name: variantsInfo.variants[].digitalProperties.digitalFile.fileType | type: FileType | description: File type.
889
+ enum:
890
+ SECURE_ARCHIVE: Secure archive file.
891
+ SECURE_DOCUMENT: Secure document file.
892
+ SECURE_MUSIC: Secure music file.
893
+ SECURE_PICTURE: Secure picture file.
894
+ SECURE_VIDEO: Secure video file.
895
+ UNSPECIFIED: Unspecified file type.
896
+ - name: variantsInfo.variants[].physicalProperties | type: VariantPhysicalProperties | description: Physical properties. Must be passed when `productType: PHYSICAL`
897
+ - name: variantsInfo.variants[].physicalProperties.pricePerUnit | type: PricePerUnit | description: Price per unit info, in order to show price per unit on the product page. For example if one sells cheese and defines 100g here then we know that buying this variant buyer receives 100g of cheese. But on product page price will be displayed for units defined on product level. See `pricePerUnit.value` to understand how it's calculated.
898
+ - name: variantsInfo.variants[].physicalProperties.pricePerUnit.description | type: string | description: Price per unit description. > **Note:** Returned only when you pass `"CURRENCY"` to the `fields` array in Products API requests.
899
+ - name: variantsInfo.variants[].physicalProperties.pricePerUnit.settings | type: PricePerUnitSettings | description: Price per unit data for this variant. `measurementUnit` value must correspond to the measurement unit set on the product.
900
+ - name: variantsInfo.variants[].physicalProperties.pricePerUnit.settings.measurementUnit | type: MeasurementUnit | description: Measurement unit. For example, to define price per 100 grams, set this field to "G".
901
+ enum: CBM, CL, CM, FLOZ, FT, G, GAL, IN, KG, L, LB, M, MG, ML, MM, OZ, PT, QT, SQFT, SQM, UNSPECIFIED, YD
902
+ - name: variantsInfo.variants[].physicalProperties.pricePerUnit.settings.quantity | type: number | description: Quantity. For example, to define price per per 100 grams, set this field to `100`.
903
+ - name: variantsInfo.variants[].physicalProperties.pricePerUnit.value | type: string | description: Calculated value of price per unit. Takes into account `pricePerUnit` settings of parent product, of this variant, and discounted price of variant. For example if discounted price is 2$, product's price per unit setting is 1 Kg, variant price per unit setting is 0.5 Kg then this value is 4$ (means variant weight is 0.5 Kg and it costs 2$ but we want to show price per 1 Kg so we show 4$).
904
+ - name: variantsInfo.variants[].physicalProperties.weight | type: number | description: Variant shipping weight. product.physicalProperties.shipping_weight_range values are taken from here.
905
+ - name: visible | type: boolean | description: Whether the product is visible to site visitors on the site. Default: `true`
906
+ - name: visibleInPos | type: boolean | description: Whether the product is visible in POS (point of sale). Default: `true` > **Note:** Always `false` for `productType: DIGITAL`.
907
+ - ONE-OF:
908
+ - name: physicalProperties | type: PhysicalProperties | description: Physical properties. Required when `productType: PHYSICAL`.
909
+ - name: physicalProperties.deliveryProfileId | type: string | description: Delivery profile GUID.
910
+ - name: physicalProperties.fulfillerId | type: string | description: Fulfiller GUID.
911
+ - name: physicalProperties.pricePerUnit | type: PricePerUnitSettings | description: Price per unit settings. > **Note:** Use this field only when relevant. For example, for products that are sold by weight, volume, or length.
912
+ - name: physicalProperties.pricePerUnitRange | type: PricePerUnitRange | description: Product price per unit range. The minimum and maximum price per unit of all the variants.
913
+ - name: physicalProperties.pricePerUnitRange.maxValue | type: PricePerUnitRangePricePerUnit | description: Maximum price per unit across all variants.
914
+ - name: physicalProperties.pricePerUnitRange.maxValue.description | type: string | description: Price per unit info in the format of variant specific data / product setting, for example €4.00 / 1 Kg. > **Note:** This field is returned by the API only when you pass `fields: "CURRENCY"` in a request.
915
+ - name: physicalProperties.pricePerUnitRange.maxValue.value | type: string | description: Calculated value of price per unit. Takes into account pricePerUnit settings of product and variants and price of variants. For example if discounted price is 2$, product's price per unit setting is 1 Kg, variant price per unit setting is 0.5 Kg then this value is 4$ (means variant weight is 0.5 Kg and it costs 2$ but we want to show price per 1 Kg so we show 4$).
916
+ - name: physicalProperties.pricePerUnitRange.minValue | type: PricePerUnitRangePricePerUnit | description: Minimum price per unit across all variants.
917
+ - name: physicalProperties.shippingWeightRange | type: WeightRange | description: Product shipping weight range - Calculated from the lightest and heaviest variant shipping weights.
918
+ - name: physicalProperties.shippingWeightRange.maxValue | type: number | description: Maximum weight across all variants associated with this product.
919
+ - name: physicalProperties.shippingWeightRange.minValue | type: number | description: Minimum weight across all variants associated with this product.
920
+ - name: physicalProperties.weightMeasurementUnitInfo | type: WeightMeasurementUnitInfo | description: Weight measurement unit. > **Note:** Returned only when you pass `"WEIGHT_MEASUREMENT_UNIT_INFO"` to the `fields` array in Products API requests.
921
+ - name: physicalProperties.weightMeasurementUnitInfo.weightMeasurementUnit | type: WeightUnit | description: Weight measurement unit.
922
+ enum:
923
+ KG: Kilograms.
924
+ LB: Pounds.
925
+ UNSPECIFIED_WEIGHT_UNIT: Weight unit can't be classified due to an error.
926
+ Possible Errors:
927
+ HTTP Code: 403 | Status Code: PERMISSION_DENIED | Application Code: NO_PERMISSION_TO_INCLUDE_NOT_VISIBLE_PRODUCTS
928
+ HTTP Code: 403 | Status Code: PERMISSION_DENIED | Application Code: NO_PERMISSION_TO_READ_MERCHANT_DATA
929
+
930
+
931
+ ```
932
+ </type_definition>
933
+ </stores_productsV3_getProduct>