@wix/ditto-codegen-public 1.0.162 → 1.0.163

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 +929 -79
  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,1051 @@
1
+ <stores_productsV3_queryProducts>
2
+ <description>
3
+ # Method name:
4
+
5
+ stores.productsV3.queryProducts(options: QueryProductsOptions)
6
+
7
+ # Method Link:
8
+
9
+ https://dev.wix.com/docs/sdk/backend-modules/stores/catalog-v3/products-v3/query-products
10
+
11
+ # Method Description:
12
+
13
+ Retrieves a list of up to 100 products, given the provided filtering, sorting, and cursor paging.
14
+ Pass supported values to the `fields` array in the request to include those fields in the response.
15
+
16
+ To learn about working with _Query_ endpoints, see
17
+ [API Query Language](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language),
18
+ and [Sorting and Paging](https://dev.wix.com/docs/rest/articles/getting-started/sorting-and-paging).
19
+
20
+ > **Notes:**
21
+ > + This method does not return `variantsInfo`. To retrieve product variants, use the Get Product method.
22
+ > + To retrieve a non-visible product (`visible: false`), your app must have the required `SCOPE.STORES.PRODUCT_READ_ADMIN` permission scope.
23
+
24
+
25
+ |PROPERTY |SUPPORTED FILTERS & SORTING
26
+ |:---:|:---:|
27
+ |`_id`|[`eq()`](/products-query-builder/eq),[`ne()`](/products-query-builder/ne),[`exists()`](/products-query-builder/exists),[`in()`](/products-query-builder/in),[`hasSome()`](/products-query-builder/has-some),[`startsWith()`](/products-query-builder/starts-with),[`gt()`](/products-query-builder/gt),[`lt()`](/products-query-builder/lt),[`le()`](/products-query-builder/le),[`ge()`](/products-query-builder/ge)|
28
+ |`_createdDate`|[`eq()`](/products-query-builder/eq),[`ne()`](/products-query-builder/ne),[`exists()`](/products-query-builder/exists),[`in()`](/products-query-builder/in),[`hasSome()`](/products-query-builder/has-some),[`lt()`](/products-query-builder/lt),[`le()`](/products-query-builder/le),[`gt()`](/products-query-builder/gt),[`ge()`](/products-query-builder/ge),[`ascending()`](/products-query-builder/ascending),[`descending()`](/products-query-builder/descending)|
29
+ |`_updatedDate`|[`eq()`](/products-query-builder/eq),[`ne()`](/products-query-builder/ne),[`exists()`](/products-query-builder/exists),[`in()`](/products-query-builder/in),[`hasSome()`](/products-query-builder/has-some),[`lt()`](/products-query-builder/lt),[`le()`](/products-query-builder/le),[`gt()`](/products-query-builder/gt),[`ge()`](/products-query-builder/ge),[`ascending()`](/products-query-builder/ascending),[`descending()`](/products-query-builder/descending)|
30
+ |`slug`|[`eq()`](/products-query-builder/eq),[`ne()`](/products-query-builder/ne),[`exists()`](/products-query-builder/exists),[`in()`](/products-query-builder/in),[`hasSome()`](/products-query-builder/has-some),[`startsWith()`](/products-query-builder/starts-with),[`gt()`](/products-query-builder/gt),[`lt()`](/products-query-builder/lt),[`le()`](/products-query-builder/le),[`ge()`](/products-query-builder/ge),[`ascending()`](/products-query-builder/ascending),[`descending()`](/products-query-builder/descending)|
31
+ |`visible`|[`eq()`](/products-query-builder/eq),[`ne()`](/products-query-builder/ne),[`exists()`](/products-query-builder/exists),[`in()`](/products-query-builder/in),[`hasSome()`](/products-query-builder/has-some),[`ascending()`](/products-query-builder/ascending),[`descending()`](/products-query-builder/descending)|
32
+ |`options.id`|[`eq()`](/products-query-builder/eq),[`ne()`](/products-query-builder/ne),[`exists()`](/products-query-builder/exists),[`in()`](/products-query-builder/in),[`hasSome()`](/products-query-builder/has-some),[`startsWith()`](/products-query-builder/starts-with),[`gt()`](/products-query-builder/gt),[`lt()`](/products-query-builder/lt),[`le()`](/products-query-builder/le),[`ge()`](/products-query-builder/ge)|
33
+ |`handle`|[`eq()`](/products-query-builder/eq),[`ne()`](/products-query-builder/ne),[`exists()`](/products-query-builder/exists),[`in()`](/products-query-builder/in),[`hasSome()`](/products-query-builder/has-some),[`startsWith()`](/products-query-builder/starts-with),[`gt()`](/products-query-builder/gt),[`lt()`](/products-query-builder/lt),[`le()`](/products-query-builder/le),[`ge()`](/products-query-builder/ge)|
34
+
35
+ # Method Permissions:
36
+
37
+ - WIX_STORES.PRODUCT_READ
38
+ - WIX_STORES.PRODUCT_READ_NON_VISIBLE
39
+
40
+ # Method Permissions Scopes IDs:
41
+
42
+ undefined
43
+
44
+
45
+
46
+ # Method Code Examples:
47
+
48
+ ## queryProducts
49
+
50
+ ```javascript
51
+ import { productsV3 } from '@wix/stores';
52
+
53
+ async function queryProducts() {
54
+ const { items } = await productsV3.queryProducts().find();
55
+ };
56
+ ```
57
+
58
+ ## queryProducts (with elevated permissions)
59
+
60
+ ```javascript
61
+ import { productsV3 } from '@wix/stores';
62
+ import { auth } from '@wix/essentials';
63
+
64
+ async function myQueryProductsMethod(query, options) {
65
+ const elevatedQueryProducts = auth.elevate(productsV3.queryProducts);
66
+ const response = await elevatedQueryProducts(query, options);
67
+ }
68
+ ```
69
+
70
+
71
+
72
+ ## default
73
+
74
+ ```javascript
75
+ try {
76
+ const { items } = await productsV3.queryProducts({ fields: ["_id", "name", "slug"] });
77
+ return items;
78
+ } catch (error) {
79
+ console.error(error);
80
+ throw error;
81
+ }
82
+ ```
83
+ </description>
84
+ <type_definition>
85
+ ```
86
+ Method: stores.productsV3.queryProducts(options)
87
+ Description: Retrieves a list of up to 100 products, given the provided filtering, sorting, and cursor paging. Pass supported values to the `fields` array in the request to include those fields in the response. To learn about working with _Query_ endpoints, see [API Query Language](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language), and [Sorting and Paging](https://dev.wix.com/docs/rest/articles/getting-started/sorting-and-paging). > **Notes:** > + This method does not return `variantsInfo`. To retrieve product variants, use the Get Product method. > + To retrieve a non-visible product (`visible: false`), your app must have the required `SCOPE.STORES.PRODUCT_READ_ADMIN` permission scope. |PROPERTY |SUPPORTED FILTERS & SORTING |:---:|:---:| |`_id`|[`eq()`](/products-query-builder/eq),[`ne()`](/products-query-builder/ne),[`exists()`](/products-query-builder/exists),[`in()`](/products-query-builder/in),[`hasSome()`](/products-query-builder/has-some),[`startsWith()`](/products-query-builder/starts-with),[`gt()`](/products-query-builder/gt),[`lt()`](/products-query-builder/lt),[`le()`](/products-query-builder/le),[`ge()`](/products-query-builder/ge)| |`_createdDate`|[`eq()`](/products-query-builder/eq),[`ne()`](/products-query-builder/ne),[`exists()`](/products-query-builder/exists),[`in()`](/products-query-builder/in),[`hasSome()`](/products-query-builder/has-some),[`lt()`](/products-query-builder/lt),[`le()`](/products-query-builder/le),[`gt()`](/products-query-builder/gt),[`ge()`](/products-query-builder/ge),[`ascending()`](/products-query-builder/ascending),[`descending()`](/products-query-builder/descending)| |`_updatedDate`|[`eq()`](/products-query-builder/eq),[`ne()`](/products-query-builder/ne),[`exists()`](/products-query-builder/exists),[`in()`](/products-query-builder/in),[`hasSome()`](/products-query-builder/has-some),[`lt()`](/products-query-builder/lt),[`le()`](/products-query-builder/le),[`gt()`](/products-query-builder/gt),[`ge()`](/products-query-builder/ge),[`ascending()`](/products-query-builder/ascending),[`descending()`](/products-query-builder/descending)| |`slug`|[`eq()`](/products-query-builder/eq),[`ne()`](/products-query-builder/ne),[`exists()`](/products-query-builder/exists),[`in()`](/products-query-builder/in),[`hasSome()`](/products-query-builder/has-some),[`startsWith()`](/products-query-builder/starts-with),[`gt()`](/products-query-builder/gt),[`lt()`](/products-query-builder/lt),[`le()`](/products-query-builder/le),[`ge()`](/products-query-builder/ge),[`ascending()`](/products-query-builder/ascending),[`descending()`](/products-query-builder/descending)| |`visible`|[`eq()`](/products-query-builder/eq),[`ne()`](/products-query-builder/ne),[`exists()`](/products-query-builder/exists),[`in()`](/products-query-builder/in),[`hasSome()`](/products-query-builder/has-some),[`ascending()`](/products-query-builder/ascending),[`descending()`](/products-query-builder/descending)| |`options.id`|[`eq()`](/products-query-builder/eq),[`ne()`](/products-query-builder/ne),[`exists()`](/products-query-builder/exists),[`in()`](/products-query-builder/in),[`hasSome()`](/products-query-builder/has-some),[`startsWith()`](/products-query-builder/starts-with),[`gt()`](/products-query-builder/gt),[`lt()`](/products-query-builder/lt),[`le()`](/products-query-builder/le),[`ge()`](/products-query-builder/ge)| |`handle`|[`eq()`](/products-query-builder/eq),[`ne()`](/products-query-builder/ne),[`exists()`](/products-query-builder/exists),[`in()`](/products-query-builder/in),[`hasSome()`](/products-query-builder/has-some),[`startsWith()`](/products-query-builder/starts-with),[`gt()`](/products-query-builder/gt),[`lt()`](/products-query-builder/lt),[`le()`](/products-query-builder/le),[`ge()`](/products-query-builder/ge)|
88
+ Method parameters:
89
+ param name: options | type: QueryProductsOptions | description: none
90
+ - name: fields | type: Array<RequestedFields> | description: A list of requested fields to be included in the response.
91
+ enum:
92
+ ALL_CATEGORIES_INFO: Provides GUIDs and indexes for all categories including inherited parent categories.
93
+ BREADCRUMBS_INFO: Returns the category breadcrumb navigation path from root categories down to the product's main category, including category GUIDs, names, and slugs.
94
+ CURRENCY: Currency information including the currency code and formatted price amounts for storefront display.
95
+ DESCRIPTION: Returns the product description as rich content with complete node structure, metadata, and styling information.
96
+ DIRECT_CATEGORIES_INFO: Provides the GUIDs and indexes of categories the product is directly assigned to.
97
+ 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.
98
+ 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.
99
+ INFO_SECTION_PLAIN_DESCRIPTION: Returns info section descriptions as HTML content. Use with `INFO_SECTION` for complete metadata.
100
+ MEDIA_ITEMS_INFO: Returns all media items associated with the product, including detailed metadata (URLs, alt-text, dimensions, filenames, file sizes).
101
+ 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.
102
+ PLAIN_DESCRIPTION: Provides product description as plain HTML text.
103
+ SUBSCRIPTION_PRICES_INFO: Details subscription pricing options, empty for non-subscription products.
104
+ THUMBNAIL: Returns an optimized thumbnail image with standard dimensions, suitable for listings or previews.
105
+ UNKNOWN_REQUESTED_FIELD: Not implemented.
106
+ URL: The product's public storefront URL, including both relative path and full URL with base domain.
107
+ VARIANT_OPTION_CHOICE_NAMES: Enriches variant choices with human-readable option and choice names alongside render types.
108
+ WEIGHT_MEASUREMENT_UNIT_INFO: Returns the weight measurement unit (KG, LB) for the product.
109
+ Return type: REFERENCE<ProductsQueryBuilder>
110
+ Method: stores.productsV3.queryProducts().ascending(propertyNames)
111
+ Description: Adds a sort to a query, sorting by the specified properties in ascending order. The `ascending()` function refines a `ProductsQueryBuilder` to sort by the value of `propertyName` in ascending order. You can specify multiple properties for sorting in ascending order by passing each property name as an additional argument. `ascending()` sorts the results in the order the properties are passed. You can sort the following types: - Number: Sorts numerically. - Date: Sorts by date and time. - String: Sorts lexicographically, so `'abc'` comes after `'XYZ'`. If a property contains a number stored as a string (for example, `'0'`), that value is sorted alphabetically and not numerically. If a property doesn't have a value, that value is ranked lowest.
112
+ Method parameters:
113
+ param name: propertyNames | type: Array<string> | description: Properties used in the sort. To sort by multiple properties, pass properties as additional arguments.
114
+ Return type: REFERENCE<ProductsQueryBuilder>
115
+ Method: stores.productsV3.queryProducts().descending(propertyNames)
116
+ Description: Adds a sort to a query, sorting by the specified properties in descending order. The `descending()` function refines a `ProductsQueryBuilder` to sort by the value of `propertyName` in descending order. You can specify multiple properties for sorting in descending order by passing each property name as an additional argument. `descending()` sorts the results in the order the properties are passed. You can sort the following types: - Number: Sorts numerically. - Date: Sorts by date and time. - String: Sorts lexicographically, so `'abc'` comes after `'XYZ'`. If a property contains a number stored as a string (for example, `'0'`), that value is sorted alphabetically and not numerically. If a property doesn't have a value, that value is ranked lowest.
117
+ Method parameters:
118
+ param name: propertyNames | type: Array<string> | description: Properties used in the sort. To sort by multiple properties, pass properties as additional arguments.
119
+ Return type: REFERENCE<ProductsQueryBuilder>
120
+ Method: stores.productsV3.queryProducts().eq(propertyName, value)
121
+ Description: Refines a query to match items where the specified property equals the specified value. The `eq()` function refines a `ProductsQueryBuilder` to match only items where the value of the specified `propertyName` equals the specified `value`. `eq()` matches only values of the same type. For example, `0` stored as a number doesn't match `'0'` stored as a string. Matching strings with `eq()` is case-sensitive, so `'text'` isn't equal to `'Text'`.
122
+ Method parameters:
123
+ param name: propertyName | type: string | description: Property whose value is compared with `value`.
124
+ param name: value | type: any | description: Value to compare against.
125
+ Return type: REFERENCE<ProductsQueryBuilder>
126
+ Method: stores.productsV3.queryProducts().exists(propertyName, value)
127
+ Description: Refines a query to match items where the specified property contains a value. The `exists()` function refines a `ProductsQueryBuilder` to only match items where the value of the specified `propertyName` doesn't equal null or undefined. `exists()` checks for either existence or non-existence based on the boolean parameter. Note that `exists()` does match items where the value of the specified `propertyName` is an empty string or an invalid value. `exists()` is only useful for properties which don't contain default values and therefore their values may be unassigned.
128
+ Method parameters:
129
+ param name: propertyName | type: string | description: none
130
+ param name: value | type: boolean | description: none
131
+ Return type: REFERENCE<ProductsQueryBuilder>
132
+ Method: stores.productsV3.queryProducts().find()
133
+ Description: Returns the query results. The `find()` function returns a Promise that resolves to the query results and metadata. The Promise is rejected if `find()` is called with insufficient permissions or if any of the previous functions used to refine the query are invalid.
134
+ Return type: PROMISE<ProductsQueryResult>
135
+ - name: cursors | type: Cursors | description: Returns the query cursors. `cursors` returns the query's `next` and `prev` cursors.
136
+ - name: cursors.next | type: string | description: Cursor string pointing to the next page in the list of results.
137
+ - name: cursors.prev | type: string | description: Cursor pointing to the previous page in the list of results.
138
+ - name: items | type: Array<V3Product> | description: Returns an array of `productsV3` items that match the query. `items` contains the current page of results retrieved by the query. If no results match the query, `items` is an empty array. The page size is defined by the [`limit()`](/products-query-builder/limit) function and can be retrieved using the [`pageSize`](#page-size) property. You can use the [`next()`](#next) and [`prev()`](#prev) functions returned by `productsV3` to navigate the pages of a query result.
139
+ - name: items[]._createdDate | type: Date | description: Date and time the product was created.
140
+ - name: items[]._id | type: string | description: Product GUID.
141
+ - name: items[]._updatedDate | type: Date | description: Date and time the product was updated.
142
+ - name: items[].actualPriceRange | type: PriceRange | description: Product actualPrice range - minimum and maximum prices of all product variants.
143
+ - name: items[].actualPriceRange.maxValue | type: FixedMonetaryAmount | description: Maximum value.
144
+ - name: items[].actualPriceRange.maxValue.amount | type: string | description: Monetary amount. For example, `"3.99"`, or `"-4.99"` for a negative amount.
145
+ - name: items[].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.
146
+ - name: items[].actualPriceRange.minValue | type: FixedMonetaryAmount | description: Minimum value.
147
+ - name: items[].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.
148
+ - name: items[].allCategoriesInfo.categories | type: Array<ProductCategory> | description: A list of categories related to product.
149
+ - name: items[].allCategoriesInfo.categories[]._id | type: string | description: Category GUID.
150
+ - name: items[].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.
151
+ - name: items[].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.
152
+ - name: items[].brand._id | type: string | description: Brand GUID.
153
+ - name: items[].brand.name | type: string | description: Brand name.
154
+ - name: items[].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.
155
+ - name: items[].breadcrumbsInfo.breadcrumbs | type: Array<BreadCrumb> | description: Breadcrumbs.
156
+ - name: items[].breadcrumbsInfo.breadcrumbs[].categoryId | type: string | description: Category GUID.
157
+ - name: items[].breadcrumbsInfo.breadcrumbs[].categoryName | type: string | description: Category name.
158
+ - name: items[].breadcrumbsInfo.breadcrumbs[].categorySlug | type: string | description: Category slug.
159
+ - name: items[].compareAtPriceRange | type: PriceRange | description: Product compareAtPrice range - minimum and maximum compare at prices of all product variants.
160
+ - name: items[].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.
161
+ - name: items[].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.
162
+ - name: items[].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>
163
+ - name: items[].description.documentStyle | type: DocumentStyle | description: Global styling for header, paragraph, block quote, and code block nodes in the object.
164
+ - name: items[].description.documentStyle.blockquote | type: TextNodeStyle | description: Styling for block quote nodes.
165
+ - name: items[].description.documentStyle.blockquote.decorations | type: Array<Decoration> | description: The decorations to apply to the node.
166
+ - name: items[].description.documentStyle.blockquote.decorations[].type | type: DecorationType | description: The type of decoration to apply.
167
+ enum: ANCHOR, BOLD, COLOR, EXTERNAL, FONT_FAMILY, FONT_SIZE, ITALIC, LINK, MENTION, SPOILER, STRIKETHROUGH, SUBSCRIPT, SUPERSCRIPT, UNDERLINE
168
+ - ONE-OF:
169
+ - name: items[].description.documentStyle.blockquote.decorations[].anchorData | type: AnchorData | description: Data for an anchor link decoration.
170
+ - name: items[].description.documentStyle.blockquote.decorations[].anchorData.anchor | type: string | description: The target node's GUID.
171
+ - name: items[].description.documentStyle.blockquote.decorations[].colorData | type: ColorData | description: Data for a color decoration.
172
+ - name: items[].description.documentStyle.blockquote.decorations[].colorData.background | type: string | description: The text's background color as a hexadecimal value.
173
+ - name: items[].description.documentStyle.blockquote.decorations[].colorData.foreground | type: string | description: The text's foreground color as a hexadecimal value.
174
+ - name: items[].description.documentStyle.blockquote.decorations[].fontFamilyData | type: FontFamilyData | description: Data for a font family decoration.
175
+ - name: items[].description.documentStyle.blockquote.decorations[].fontFamilyData.value | type: string | description: none
176
+ - name: items[].description.documentStyle.blockquote.decorations[].fontSizeData | type: FontSizeData | description: Data for a font size decoration.
177
+ - name: items[].description.documentStyle.blockquote.decorations[].fontSizeData.unit | type: FontType | description: The units used for the font size.
178
+ enum: EM, PX
179
+ - name: items[].description.documentStyle.blockquote.decorations[].fontSizeData.value | type: number | description: Font size value.
180
+ - name: items[].description.documentStyle.blockquote.decorations[].fontWeightValue | type: number | description: Font weight for a bold decoration.
181
+ - name: items[].description.documentStyle.blockquote.decorations[].italicData | type: boolean | description: Data for an italic decoration. Defaults to `true`.
182
+ - name: items[].description.documentStyle.blockquote.decorations[].linkData | type: LinkData | description: Data for an external link decoration.
183
+ - name: items[].description.documentStyle.blockquote.decorations[].linkData.link | type: Link | description: Link details.
184
+ - name: items[].description.documentStyle.blockquote.decorations[].linkData.link.customData | type: string | description: A serialized object used for a custom or external link panel.
185
+ - name: items[].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.
186
+ - name: items[].description.documentStyle.blockquote.decorations[].linkData.link.rel.nofollow | type: boolean | description: Indicates to search engine crawlers not to follow the link. Defaults to `false`.
187
+ - name: items[].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.
188
+ - name: items[].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`.
189
+ - name: items[].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`.
190
+ - name: items[].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.
191
+ enum:
192
+ BLANK: Opens the linked document in a new window or tab
193
+ PARENT: Opens the linked document in the parent frame
194
+ SELF: Opens the linked document in the same frame as it was clicked (this is default)
195
+ TOP: Opens the linked document in the full body of the window
196
+ - ONE-OF:
197
+ - name: items[].description.documentStyle.blockquote.decorations[].linkData.link.anchor | type: string | description: The target node's GUID. Used for linking to another node in this object.
198
+ - name: items[].description.documentStyle.blockquote.decorations[].linkData.link.url | type: string | description: The absolute URL for the linked document.
199
+ - name: items[].description.documentStyle.blockquote.decorations[].mentionData | type: MentionData | description: Data for a mention decoration.
200
+ - name: items[].description.documentStyle.blockquote.decorations[].mentionData.id | type: string | description: Mentioned user's GUID.
201
+ - name: items[].description.documentStyle.blockquote.decorations[].mentionData.name | type: string | description: The mentioned user's name.
202
+ - name: items[].description.documentStyle.blockquote.decorations[].mentionData.slug | type: string | description: The version of the user's name that appears after the `@` character in the mention.
203
+ - name: items[].description.documentStyle.blockquote.decorations[].spoilerData | type: SpoilerData | description: Data for a spoiler decoration.
204
+ - name: items[].description.documentStyle.blockquote.decorations[].spoilerData.id | type: string | description: Spoiler GUID.
205
+ - name: items[].description.documentStyle.blockquote.decorations[].strikethroughData | type: boolean | description: Data for a strikethrough decoration. Defaults to `true`.
206
+ - name: items[].description.documentStyle.blockquote.decorations[].subscriptData | type: boolean | description: Data for a subscript decoration. Defaults to `true`.
207
+ - name: items[].description.documentStyle.blockquote.decorations[].superscriptData | type: boolean | description: Data for a superscript decoration. Defaults to `true`.
208
+ - name: items[].description.documentStyle.blockquote.decorations[].underlineData | type: boolean | description: Data for an underline decoration. Defaults to `true`.
209
+ - name: items[].description.documentStyle.blockquote.lineHeight | type: string | description: Line height for text in the node.
210
+ - name: items[].description.documentStyle.blockquote.nodeStyle | type: NodeStyle | description: Padding and background color for the node.
211
+ - name: items[].description.documentStyle.blockquote.nodeStyle.backgroundColor | type: string | description: The background color as a hexadecimal value.
212
+ - name: items[].description.documentStyle.blockquote.nodeStyle.paddingBottom | type: string | description: The bottom padding value in pixels.
213
+ - name: items[].description.documentStyle.blockquote.nodeStyle.paddingTop | type: string | description: The top padding value in pixels.
214
+ - name: items[].description.documentStyle.codeBlock | type: TextNodeStyle | description: Styling for code block nodes.
215
+ - name: items[].description.documentStyle.headerFive | type: TextNodeStyle | description: Styling for H5 nodes.
216
+ - name: items[].description.documentStyle.headerFour | type: TextNodeStyle | description: Styling for H4 nodes.
217
+ - name: items[].description.documentStyle.headerOne | type: TextNodeStyle | description: Styling for H1 nodes.
218
+ - name: items[].description.documentStyle.headerSix | type: TextNodeStyle | description: Styling for H6 nodes.
219
+ - name: items[].description.documentStyle.headerThree | type: TextNodeStyle | description: Styling for H3 nodes.
220
+ - name: items[].description.documentStyle.headerTwo | type: TextNodeStyle | description: Styling for H2 nodes.
221
+ - name: items[].description.documentStyle.paragraph | type: TextNodeStyle | description: Styling for paragraph nodes.
222
+ - name: items[].description.metadata | type: Metadata | description: Object metadata.
223
+ - name: items[].description.metadata._id | type: string | description: Object GUID.
224
+ - name: items[].description.metadata.version | type: number | description: Schema version.
225
+ - name: items[].description.nodes | type: Array<Node> | description: Node objects representing a rich content document.
226
+ - name: items[].description.nodes[].id | type: string | description: Node GUID.
227
+ - name: items[].description.nodes[].nodes | type: Array<Node> | description: A list of child nodes.
228
+ - name: items[].description.nodes[].style | type: NodeStyle | description: Padding and background color styling for the node.
229
+ - name: items[].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.
230
+ 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
231
+ - ONE-OF:
232
+ - name: items[].description.nodes[].appEmbedData | type: AppEmbedData | description: Data for an app embed node.
233
+ - name: items[].description.nodes[].appEmbedData.buttonStyles | type: ButtonStyles | description: Button styling options.
234
+ - name: items[].description.nodes[].appEmbedData.buttonStyles.backgroundColor | type: string | description: Background color as a hexadecimal value.
235
+ - name: items[].description.nodes[].appEmbedData.buttonStyles.backgroundColorHover | type: string | description: Background color as a hexadecimal value (hover state).
236
+ - name: items[].description.nodes[].appEmbedData.buttonStyles.borderColor | type: string | description: Border color as a hexadecimal value.
237
+ - name: items[].description.nodes[].appEmbedData.buttonStyles.borderColorHover | type: string | description: Border color as a hexadecimal value (hover state).
238
+ - name: items[].description.nodes[].appEmbedData.buttonStyles.borderRadius | type: number | description: Border radius in pixels.
239
+ - name: items[].description.nodes[].appEmbedData.buttonStyles.borderWidth | type: number | description: Border width in pixels.
240
+ - name: items[].description.nodes[].appEmbedData.buttonStyles.buttonSize | type: string | description: Button size option, one of `SMALL`, `MEDIUM` or `LARGE`. Defaults to `MEDIUM`.
241
+ - name: items[].description.nodes[].appEmbedData.buttonStyles.buttonText | type: string | description: Text to display on the button.
242
+ - name: items[].description.nodes[].appEmbedData.buttonStyles.textColor | type: string | description: Text color as a hexadecimal value.
243
+ - name: items[].description.nodes[].appEmbedData.buttonStyles.textColorHover | type: string | description: Text color as a hexadecimal value (hover state).
244
+ - name: items[].description.nodes[].appEmbedData.cardStyles | type: CardStyles | description: Card styling options.
245
+ - name: items[].description.nodes[].appEmbedData.cardStyles.alignment | type: Alignment | description: Content alignment. Defaults to `START`.
246
+ enum:
247
+ CENTER: Content centered
248
+ END: Content aligned to end (right in LTR layouts, left in RTL layouts)
249
+ START: Content aligned to start (left in LTR layouts, right in RTL layouts)
250
+ - name: items[].description.nodes[].appEmbedData.cardStyles.backgroundColor | type: string | description: Card background color as a hexadecimal value.
251
+ - name: items[].description.nodes[].appEmbedData.cardStyles.borderColor | type: string | description: Card border color as a hexadecimal value.
252
+ - name: items[].description.nodes[].appEmbedData.cardStyles.borderRadius | type: number | description: Card border radius in pixels.
253
+ - name: items[].description.nodes[].appEmbedData.cardStyles.borderWidth | type: number | description: Card border width in pixels.
254
+ - name: items[].description.nodes[].appEmbedData.cardStyles.textColor | type: string | description: Text color as a hexadecimal value.
255
+ - name: items[].description.nodes[].appEmbedData.cardStyles.titleColor | type: string | description: Title text color as a hexadecimal value.
256
+ - name: items[].description.nodes[].appEmbedData.cardStyles.titlePriceLayout | type: Layout | description: Layout for title and price. Defaults to `STACKED`.
257
+ enum:
258
+ SIDE_BY_SIDE: Elements arranged horizontally
259
+ STACKED: Elements stacked vertically
260
+ - name: items[].description.nodes[].appEmbedData.cardStyles.type | type: Type | description: Card type. Defaults to `CONTAINED`.
261
+ enum:
262
+ CONTAINED: Card with visible border and background
263
+ FRAMELESS: Card without visible border
264
+ - name: items[].description.nodes[].appEmbedData.containerData | type: PluginContainerData | description: Styling for the app embed's container.
265
+ - name: items[].description.nodes[].appEmbedData.containerData.alignment | type: PluginContainerDataAlignment | description: The node's alignment within its container.
266
+ enum:
267
+ CENTER: Center Alignment
268
+ LEFT: Left Alignment
269
+ RIGHT: Right Alignment
270
+ - name: items[].description.nodes[].appEmbedData.containerData.height | type: Height | description: The height of the node when it's displayed.
271
+ - name: items[].description.nodes[].appEmbedData.containerData.height.custom | type: string | description: A custom height value in pixels.
272
+ - name: items[].description.nodes[].appEmbedData.containerData.spoiler | type: Spoiler | description: Spoiler cover settings for the node.
273
+ - name: items[].description.nodes[].appEmbedData.containerData.spoiler.buttonText | type: string | description: The text for the button used to remove the spoiler cover.
274
+ - name: items[].description.nodes[].appEmbedData.containerData.spoiler.description | type: string | description: The description displayed on top of the spoiler cover.
275
+ - name: items[].description.nodes[].appEmbedData.containerData.spoiler.enabled | type: boolean | description: Sets whether the spoiler cover is enabled for this node. Defaults to `false`.
276
+ - name: items[].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`.
277
+ - name: items[].description.nodes[].appEmbedData.containerData.width | type: PluginContainerDataWidth | description: The width of the node when it's displayed.
278
+ - ONE-OF:
279
+ - name: items[].description.nodes[].appEmbedData.containerData.width.custom | type: string | description: A custom width value in pixels.
280
+ - name: items[].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.
281
+ enum:
282
+ CONTENT: Width matches the content width
283
+ FULL_WIDTH: coast-to-coast display
284
+ ORIGINAL: Width will match the original asset width
285
+ SMALL: Small Width
286
+ - name: items[].description.nodes[].appEmbedData.hideButton | type: boolean | description: Whether to hide the button.
287
+ - name: items[].description.nodes[].appEmbedData.hideDateTime | type: boolean | description: Whether to hide the date and time (Event).
288
+ - name: items[].description.nodes[].appEmbedData.hideDescription | type: boolean | description: Whether to hide the description (Event and Booking).
289
+ - name: items[].description.nodes[].appEmbedData.hideDuration | type: boolean | description: Whether to hide the duration (Booking).
290
+ - name: items[].description.nodes[].appEmbedData.hideImage | type: boolean | description: Whether to hide the image.
291
+ - name: items[].description.nodes[].appEmbedData.hideLocation | type: boolean | description: Whether to hide the location (Event).
292
+ - name: items[].description.nodes[].appEmbedData.hidePrice | type: boolean | description: Whether to hide the price.
293
+ - name: items[].description.nodes[].appEmbedData.hideRibbon | type: boolean | description: Whether to hide the ribbon.
294
+ - name: items[].description.nodes[].appEmbedData.hideTitle | type: boolean | description: Whether to hide the title.
295
+ - name: items[].description.nodes[].appEmbedData.image | type: V1Media | description: An image for the embedded content.
296
+ - name: items[].description.nodes[].appEmbedData.image.duration | type: number | description: Media duration in seconds. Only relevant for audio and video files.
297
+ - name: items[].description.nodes[].appEmbedData.image.height | type: number | description: Media height in pixels.
298
+ - name: items[].description.nodes[].appEmbedData.image.src | type: FileSource | description: The source for the media's data.
299
+ - name: items[].description.nodes[].appEmbedData.image.src.private | type: boolean | description: Indicates whether the file's source is private. Defaults to `false`.
300
+ - ONE-OF:
301
+ - name: items[].description.nodes[].appEmbedData.image.src.custom | type: string | description: Custom GUID. Use `id` instead.
302
+ - name: items[].description.nodes[].appEmbedData.image.src.id | type: string | description: An GUID that's resolved to a URL by a resolver function.
303
+ - name: items[].description.nodes[].appEmbedData.image.src.url | type: string | description: The absolute URL for the file's source.
304
+ - name: items[].description.nodes[].appEmbedData.image.width | type: number | description: Media width in pixels.
305
+ - name: items[].description.nodes[].appEmbedData.imageStyles | type: ImageStyles | description: Image styling options.
306
+ - name: items[].description.nodes[].appEmbedData.imageStyles.aspectRatio | type: AspectRatio | description: Aspect ratio for the image. Defaults to `SQUARE`.
307
+ enum:
308
+ RECTANGLE: 16:9 aspect ratio
309
+ SQUARE: 1:1 aspect ratio
310
+ - name: items[].description.nodes[].appEmbedData.imageStyles.borderColor | type: string | description: Image border color as a hexadecimal value.
311
+ - name: items[].description.nodes[].appEmbedData.imageStyles.borderRadius | type: number | description: Image border radius in pixels.
312
+ - name: items[].description.nodes[].appEmbedData.imageStyles.borderWidth | type: number | description: Image border width in pixels.
313
+ - name: items[].description.nodes[].appEmbedData.imageStyles.hideImage | type: boolean | description: Whether to hide the image.
314
+ - name: items[].description.nodes[].appEmbedData.imageStyles.imagePosition | type: Position | description: Position of image. Defaults to `START`.
315
+ enum:
316
+ END: Image positioned at the end (right in LTR layouts, left in RTL layouts)
317
+ START: Image positioned at the start (left in LTR layouts, right in RTL layouts)
318
+ TOP: Image positioned at the top
319
+ - name: items[].description.nodes[].appEmbedData.imageStyles.resizing | type: Resizing | description: How the image should be resized. Defaults to `FILL`.
320
+ enum:
321
+ FILL: Fill the container, may crop the image
322
+ FIT: Fit the image within the container
323
+ - name: items[].description.nodes[].appEmbedData.itemId | type: string | description: The GUID of the embedded content.
324
+ - name: items[].description.nodes[].appEmbedData.name | type: string | description: The name of the embedded content.
325
+ - name: items[].description.nodes[].appEmbedData.pricingData | type: PricingData | description: Pricing data for embedded Wix App content.
326
+ - name: items[].description.nodes[].appEmbedData.pricingData.currency | type: string | description: Currency of the value in ISO 4217 format (e.g., "USD", "EUR").
327
+ - name: items[].description.nodes[].appEmbedData.pricingData.discountedValue | type: string | description: Numeric price value as string after discount application (e.g., "15.99").
328
+ - name: items[].description.nodes[].appEmbedData.pricingData.pricingPlanId | type: string | description: Pricing plan GUID.
329
+ - name: items[].description.nodes[].appEmbedData.pricingData.valueFrom | type: string | description: Minimum numeric price value as string (e.g., "10.99").
330
+ - name: items[].description.nodes[].appEmbedData.pricingData.valueTo | type: string | description: Maximum numeric price value as string (e.g., "19.99").
331
+ - name: items[].description.nodes[].appEmbedData.ribbonStyles | type: RibbonStyles | description: Ribbon styling options.
332
+ - name: items[].description.nodes[].appEmbedData.ribbonStyles.backgroundColor | type: string | description: Ribbon background color as a hexadecimal value.
333
+ - name: items[].description.nodes[].appEmbedData.ribbonStyles.borderColor | type: string | description: Ribbon border color as a hexadecimal value.
334
+ - name: items[].description.nodes[].appEmbedData.ribbonStyles.borderRadius | type: number | description: Ribbon border radius in pixels.
335
+ - name: items[].description.nodes[].appEmbedData.ribbonStyles.borderWidth | type: number | description: Ribbon border width in pixels.
336
+ - name: items[].description.nodes[].appEmbedData.ribbonStyles.ribbonPlacement | type: Placement | description: Placement of the ribbon. Defaults to `IMAGE`.
337
+ enum:
338
+ IMAGE: Ribbon placed on the image
339
+ PRODUCT_INFO: Ribbon placed on the product information
340
+ - name: items[].description.nodes[].appEmbedData.ribbonStyles.ribbonText | type: string | description: Text to display on the ribbon.
341
+ - name: items[].description.nodes[].appEmbedData.ribbonStyles.textColor | type: string | description: Ribbon text color as a hexadecimal value.
342
+ - name: items[].description.nodes[].appEmbedData.type | type: AppType | description: The type of Wix App content being embedded.
343
+ enum: BOOKING, EVENT, PRODUCT
344
+ - name: items[].description.nodes[].appEmbedData.url | type: string | description: The URL for the embedded content.
345
+ - ONE-OF:
346
+ - name: items[].description.nodes[].appEmbedData.bookingData | type: BookingData | description: Data for embedded Wix Bookings content.
347
+ - name: items[].description.nodes[].appEmbedData.bookingData.durations | type: string | description: Booking duration in minutes.
348
+ - name: items[].description.nodes[].appEmbedData.eventData | type: EventData | description: Data for embedded Wix Events content.
349
+ - name: items[].description.nodes[].appEmbedData.eventData.location | type: string | description: Event location.
350
+ - name: items[].description.nodes[].appEmbedData.eventData.scheduling | type: string | description: Event schedule.
351
+ - name: items[].description.nodes[].audioData | type: AudioData | description: Data for an audio node.
352
+ - name: items[].description.nodes[].audioData.audio | type: V1Media | description: Audio file details.
353
+ - name: items[].description.nodes[].audioData.authorName | type: string | description: Author name.
354
+ - name: items[].description.nodes[].audioData.containerData | type: PluginContainerData | description: Styling for the audio node's container.
355
+ - name: items[].description.nodes[].audioData.coverImage | type: V1Media | description: Cover image.
356
+ - name: items[].description.nodes[].audioData.disableDownload | type: boolean | description: Sets whether the audio node's download button is disabled. Defaults to `false`.
357
+ - name: items[].description.nodes[].audioData.html | type: string | description: An HTML version of the audio node.
358
+ - name: items[].description.nodes[].audioData.name | type: string | description: Track name.
359
+ - name: items[].description.nodes[].blockquoteData | type: BlockquoteData | description: Data for a block quote node.
360
+ - name: items[].description.nodes[].blockquoteData.indentation | type: number | description: Indentation level from 1-4.
361
+ - name: items[].description.nodes[].bulletedListData | type: BulletedListData | description: Data for a bulleted list node.
362
+ - name: items[].description.nodes[].bulletedListData.indentation | type: number | description: Indentation level from 0-4.
363
+ - name: items[].description.nodes[].bulletedListData.offset | type: number | description: Offset level from 0-4.
364
+ - name: items[].description.nodes[].buttonData | type: ButtonData | description: Data for a button node.
365
+ - name: items[].description.nodes[].buttonData.containerData | type: PluginContainerData | description: Styling for the button's container.
366
+ - name: items[].description.nodes[].buttonData.link | type: Link | description: Button link details.
367
+ - name: items[].description.nodes[].buttonData.styles | type: Styles | description: Styling for the button.
368
+ - name: items[].description.nodes[].buttonData.styles.backgroundColor | type: string | description: Background color as a hexadecimal value.
369
+ - name: items[].description.nodes[].buttonData.styles.backgroundColorHover | type: string | description: Background color as a hexadecimal value (hover state).
370
+ - name: items[].description.nodes[].buttonData.styles.borderColor | type: string | description: Border color as a hexadecimal value.
371
+ - name: items[].description.nodes[].buttonData.styles.borderColorHover | type: string | description: Border color as a hexadecimal value (hover state).
372
+ - name: items[].description.nodes[].buttonData.styles.borderRadius | type: number | description: Border radius in pixels.
373
+ - name: items[].description.nodes[].buttonData.styles.borderWidth | type: number | description: Border width in pixels.
374
+ - name: items[].description.nodes[].buttonData.styles.buttonSize | type: string | description: Button size option, one of `SMALL`, `MEDIUM` or `LARGE`. Defaults to `MEDIUM`.
375
+ - name: items[].description.nodes[].buttonData.styles.textColor | type: string | description: Text color as a hexadecimal value.
376
+ - name: items[].description.nodes[].buttonData.styles.textColorHover | type: string | description: Text color as a hexadecimal value (hover state).
377
+ - name: items[].description.nodes[].buttonData.text | type: string | description: The text to display on the button.
378
+ - name: items[].description.nodes[].buttonData.type | type: ButtonDataType | description: The button type.
379
+ enum:
380
+ ACTION: Triggers custom action that is defined in plugin configuration by the consumer
381
+ LINK: Regular link button
382
+ - name: items[].description.nodes[].captionData | type: CaptionData | description: Data for a caption node.
383
+ - name: items[].description.nodes[].captionData.textStyle | type: TextStyle | description: none
384
+ - name: items[].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.
385
+ - name: items[].description.nodes[].captionData.textStyle.textAlignment | type: TextAlignment | description: Text alignment. Defaults to `AUTO`.
386
+ enum:
387
+ AUTO: browser default, eqivalent to `initial`
388
+ CENTER: Center align
389
+ 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
390
+ LEFT: Left align
391
+ RIGHT: Right align
392
+ - name: items[].description.nodes[].codeBlockData | type: CodeBlockData | description: Data for a code block node.
393
+ - name: items[].description.nodes[].codeBlockData.textStyle | type: TextStyle | description: Styling for the code block's text.
394
+ - name: items[].description.nodes[].collapsibleListData | type: CollapsibleListData | description: Data for a collapsible list node.
395
+ - name: items[].description.nodes[].collapsibleListData.containerData | type: PluginContainerData | description: Styling for the collapsible list's container.
396
+ - name: items[].description.nodes[].collapsibleListData.direction | type: Direction | description: The direction of the text in the list. Either left-to-right or right-to-left.
397
+ enum:
398
+ LTR: Left-to-right
399
+ RTL: Right-to-left
400
+ - name: items[].description.nodes[].collapsibleListData.expandOnlyOne | type: boolean | description: If `true`, only one item can be expanded at a time. Defaults to `false`.
401
+ - name: items[].description.nodes[].collapsibleListData.initialExpandedItems | type: InitialExpandedItems | description: Sets which items are expanded when the page loads.
402
+ enum:
403
+ ALL: All items will expended initally
404
+ FIRST: First item will be expended initally
405
+ NONE: All items collapsed initally
406
+ - name: items[].description.nodes[].collapsibleListData.isQapageData | type: boolean | description: If `true`, The collapsible item will appear in search results as an FAQ.
407
+ - name: items[].description.nodes[].dividerData | type: DividerData | description: Data for a divider node.
408
+ - name: items[].description.nodes[].dividerData.alignment | type: DividerDataAlignment | description: Divider alignment.
409
+ enum:
410
+ CENTER: Center alignment
411
+ LEFT: Left alignment
412
+ RIGHT: Right alignment
413
+ - name: items[].description.nodes[].dividerData.containerData | type: PluginContainerData | description: Styling for the divider's container.
414
+ - name: items[].description.nodes[].dividerData.lineStyle | type: LineStyle | description: Divider line style.
415
+ enum:
416
+ DASHED: Dashed Line
417
+ DOTTED: Dotted Line
418
+ DOUBLE: Double Line
419
+ SINGLE: Single Line
420
+ - name: items[].description.nodes[].dividerData.width | type: Width | description: Divider width.
421
+ enum:
422
+ LARGE: Large line
423
+ MEDIUM: Medium line
424
+ SMALL: Small line
425
+ - name: items[].description.nodes[].embedData | type: EmbedData | description: Data for an oEmbed node.
426
+ - name: items[].description.nodes[].embedData.containerData | type: PluginContainerData | description: Styling for the oEmbed node's container.
427
+ - name: items[].description.nodes[].embedData.oembed | type: Oembed | description: An [oEmbed](https://www.oembed.com) object.
428
+ - name: items[].description.nodes[].embedData.oembed.authorName | type: string | description: The name of the author or owner of the resource.
429
+ - name: items[].description.nodes[].embedData.oembed.authorUrl | type: string | description: The URL for the author or owner of the resource.
430
+ - name: items[].description.nodes[].embedData.oembed.height | type: number | description: The height of the resource specified in the `url` property in pixels.
431
+ - name: items[].description.nodes[].embedData.oembed.html | type: string | description: HTML for embedding a video player. The HTML should have no padding or margins.
432
+ - name: items[].description.nodes[].embedData.oembed.providerName | type: string | description: The name of the resource provider.
433
+ - name: items[].description.nodes[].embedData.oembed.providerUrl | type: string | description: The URL for the resource provider.
434
+ - name: items[].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.
435
+ - name: items[].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.
436
+ - name: items[].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.
437
+ - name: items[].description.nodes[].embedData.oembed.title | type: string | description: Resource title.
438
+ - name: items[].description.nodes[].embedData.oembed.type | type: string | description: The resource type.
439
+ - name: items[].description.nodes[].embedData.oembed.url | type: string | description: The source URL for the resource.
440
+ - name: items[].description.nodes[].embedData.oembed.version | type: string | description: The oEmbed version number. This value must be `1.0`.
441
+ - name: items[].description.nodes[].embedData.oembed.videoUrl | type: string | description: The URL for an embedded viedo.
442
+ - name: items[].description.nodes[].embedData.oembed.width | type: number | description: The width of the resource specified in the `url` property in pixels.
443
+ - name: items[].description.nodes[].embedData.src | type: string | description: Origin asset source.
444
+ - name: items[].description.nodes[].externalData | type: Record<string, any> | description: Data for a custom external node.
445
+ - name: items[].description.nodes[].fileData | type: FileData | description: Data for a file node.
446
+ - name: items[].description.nodes[].fileData.containerData | type: PluginContainerData | description: Styling for the file's container.
447
+ - name: items[].description.nodes[].fileData.mimeType | type: string | description: File MIME type.
448
+ - name: items[].description.nodes[].fileData.name | type: string | description: File name.
449
+ - name: items[].description.nodes[].fileData.path | type: string | description: File path.
450
+ - name: items[].description.nodes[].fileData.pdfSettings | type: PDFSettings | description: Settings for PDF files.
451
+ - name: items[].description.nodes[].fileData.pdfSettings.disableDownload | type: boolean | description: Sets whether the PDF download button is disabled. Defaults to `false`.
452
+ - name: items[].description.nodes[].fileData.pdfSettings.disablePrint | type: boolean | description: Sets whether the PDF print button is disabled. Defaults to `false`.
453
+ - name: items[].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.
454
+ enum:
455
+ FULL: Full PDF view
456
+ MINI: Mini PDF view
457
+ NONE: No PDF view
458
+ - name: items[].description.nodes[].fileData.sizeInKb | type: string | description: File size in KB.
459
+ - name: items[].description.nodes[].fileData.src | type: FileSource | description: The source for the file's data.
460
+ - name: items[].description.nodes[].fileData.type | type: string | description: File type.
461
+ - name: items[].description.nodes[].galleryData | type: GalleryData | description: Data for a gallery node.
462
+ - name: items[].description.nodes[].galleryData.containerData | type: PluginContainerData | description: Styling for the gallery's container.
463
+ - name: items[].description.nodes[].galleryData.disableDownload | type: boolean | description: Sets whether the gallery's download button is disabled. Defaults to `false`.
464
+ - name: items[].description.nodes[].galleryData.disableExpand | type: boolean | description: Sets whether the gallery's expand button is disabled. Defaults to `false`.
465
+ - name: items[].description.nodes[].galleryData.items | type: Array<Item> | description: The items in the gallery.
466
+ - name: items[].description.nodes[].galleryData.items[].altText | type: string | description: Item's alternative text.
467
+ - name: items[].description.nodes[].galleryData.items[].title | type: string | description: Item title.
468
+ - ONE-OF:
469
+ - name: items[].description.nodes[].galleryData.items[].image | type: Image | description: An image item.
470
+ - name: items[].description.nodes[].galleryData.items[].image.link | type: Link | description: Link details for images that are links.
471
+ - name: items[].description.nodes[].galleryData.items[].image.media | type: V1Media | description: Image file details.
472
+ - name: items[].description.nodes[].galleryData.items[].video | type: Video | description: A video item.
473
+ - name: items[].description.nodes[].galleryData.items[].video.media | type: V1Media | description: Video file details.
474
+ - name: items[].description.nodes[].galleryData.items[].video.thumbnail | type: V1Media | description: Video thumbnail file details.
475
+ - name: items[].description.nodes[].galleryData.options | type: GalleryOptions | description: Options for defining the gallery's appearance.
476
+ - name: items[].description.nodes[].galleryData.options.item | type: ItemStyle | description: Styling for gallery items.
477
+ - name: items[].description.nodes[].galleryData.options.item.crop | type: Crop | description: Sets how item images are cropped.
478
+ enum:
479
+ FILL: Crop to fill
480
+ FIT: Crop to fit
481
+ - name: items[].description.nodes[].galleryData.options.item.ratio | type: number | description: Item ratio
482
+ - name: items[].description.nodes[].galleryData.options.item.spacing | type: number | description: The spacing between items in pixels.
483
+ - name: items[].description.nodes[].galleryData.options.item.targetSize | type: number | description: Desirable dimension for each item in pixels (behvaior changes according to gallery type)
484
+ - name: items[].description.nodes[].galleryData.options.layout | type: GalleryOptionsLayout | description: Gallery layout.
485
+ - name: items[].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`.
486
+ - name: items[].description.nodes[].galleryData.options.layout.mobileNumberOfColumns | type: number | description: The number of columns to display on mobile screens.
487
+ - name: items[].description.nodes[].galleryData.options.layout.numberOfColumns | type: number | description: The number of columns to display on full size screens.
488
+ - name: items[].description.nodes[].galleryData.options.layout.orientation | type: Orientation | description: Gallery orientation.
489
+ enum:
490
+ COLUMNS: Columns Orientation
491
+ ROWS: Rows Orientation
492
+ - name: items[].description.nodes[].galleryData.options.layout.type | type: LayoutType | description: Gallery layout type.
493
+ enum:
494
+ COLLAGE: Collage type
495
+ COLUMN: Column type
496
+ FULLSIZE: Fullsize images type
497
+ GRID: Grid type
498
+ MAGIC: Magic type
499
+ MASONRY: Masonry type
500
+ PANORAMA: Panorama type
501
+ SLIDER: Slider type
502
+ SLIDESHOW: Slideshow type
503
+ THUMBNAIL: Thumbnail type
504
+ - name: items[].description.nodes[].galleryData.options.thumbnails | type: Thumbnails | description: Styling for gallery thumbnail images.
505
+ - name: items[].description.nodes[].galleryData.options.thumbnails.placement | type: ThumbnailsAlignment | description: Thumbnail alignment.
506
+ enum:
507
+ BOTTOM: Bottom alignment
508
+ LEFT: Left alignment
509
+ NONE: No thumbnail
510
+ RIGHT: Right alignment
511
+ TOP: Top alignment
512
+ - name: items[].description.nodes[].galleryData.options.thumbnails.spacing | type: number | description: Spacing between thumbnails in pixels.
513
+ - name: items[].description.nodes[].gifData | type: GIFData | description: Data for a GIF node.
514
+ - name: items[].description.nodes[].gifData.containerData | type: PluginContainerData | description: Styling for the GIF's container.
515
+ - name: items[].description.nodes[].gifData.downsized | type: GIF | description: The source of the downsized GIF.
516
+ - name: items[].description.nodes[].gifData.downsized.gif | type: string | description: GIF format URL.
517
+ - name: items[].description.nodes[].gifData.downsized.mp4 | type: string | description: MP4 format URL.
518
+ - name: items[].description.nodes[].gifData.downsized.still | type: string | description: Thumbnail URL.
519
+ - name: items[].description.nodes[].gifData.gifType | type: GIFType | description: Type of GIF (Sticker or NORMAL). Defaults to `NORMAL`.
520
+ enum: NORMAL, STICKER
521
+ - name: items[].description.nodes[].gifData.height | type: number | description: Height in pixels.
522
+ - name: items[].description.nodes[].gifData.original | type: GIF | description: The source of the full size GIF.
523
+ - name: items[].description.nodes[].gifData.width | type: number | description: Width in pixels.
524
+ - name: items[].description.nodes[].headingData | type: HeadingData | description: Data for a heading node.
525
+ - name: items[].description.nodes[].headingData.indentation | type: number | description: Indentation level from 1-4.
526
+ - name: items[].description.nodes[].headingData.level | type: number | description: Heading level from 1-6.
527
+ - name: items[].description.nodes[].headingData.textStyle | type: TextStyle | description: Styling for the heading text.
528
+ - name: items[].description.nodes[].htmlData | type: HTMLData | description: Data for an embedded HTML node.
529
+ - name: items[].description.nodes[].htmlData.autoHeight | type: boolean | description: If container height is aligned with its content height. Defaults to `true`.
530
+ - name: items[].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`.
531
+ - name: items[].description.nodes[].htmlData.source | type: Source | description: The type of HTML code.
532
+ enum: ADSENSE, AI, HTML
533
+ - ONE-OF:
534
+ - name: items[].description.nodes[].htmlData.html | type: string | description: The HTML code for the node.
535
+ - name: items[].description.nodes[].htmlData.isAdsense | type: boolean | description: Whether this is an AdSense element. Use `source` instead.
536
+ - name: items[].description.nodes[].htmlData.url | type: string | description: The URL for the HTML code for the node.
537
+ - name: items[].description.nodes[].imageData | type: ImageData | description: Data for an image node.
538
+ - name: items[].description.nodes[].imageData.altText | type: string | description: Image's alternative text.
539
+ - name: items[].description.nodes[].imageData.containerData | type: PluginContainerData | description: Styling for the image's container.
540
+ - name: items[].description.nodes[].imageData.decorative | type: boolean | description: Sets whether the image is decorative and does not need an explanation. Defaults to `false`.
541
+ - name: items[].description.nodes[].imageData.disableDownload | type: boolean | description: Sets whether the image's download button is disabled. Defaults to `false`.
542
+ - name: items[].description.nodes[].imageData.disableExpand | type: boolean | description: Sets whether the image expands to full screen when clicked. Defaults to `false`.
543
+ - name: items[].description.nodes[].imageData.image | type: V1Media | description: Image file details.
544
+ - name: items[].description.nodes[].imageData.link | type: Link | description: Link details for images that are links.
545
+ - name: items[].description.nodes[].imageData.styles | type: ImageDataStyles | description: Styling for the image.
546
+ - name: items[].description.nodes[].imageData.styles.border | type: StylesBorder | description: Border attributes.
547
+ - name: items[].description.nodes[].imageData.styles.border.color | type: string | description: Border color as a hexadecimal value.
548
+ - name: items[].description.nodes[].imageData.styles.border.radius | type: number | description: Border radius in pixels.
549
+ - name: items[].description.nodes[].imageData.styles.border.width | type: number | description: Border width in pixels.
550
+ - name: items[].description.nodes[].layoutCellData | type: LayoutCellData | description: Data for a cell node.
551
+ - name: items[].description.nodes[].layoutCellData.colSpan | type: number | description: Size of the cell in 12 columns grid.
552
+ - name: items[].description.nodes[].layoutData | type: LayoutData | description: Data for a layout node. Reserved for future use.
553
+ - name: items[].description.nodes[].layoutData.backdropColor | type: string | description: Backdrop color as a hexadecimal value.
554
+ - name: items[].description.nodes[].layoutData.backdropImage | type: BackgroundImage | description: Backdrop image.radius in pixels.
555
+ - name: items[].description.nodes[].layoutData.backdropImage.media | type: V1Media | description: Background image.
556
+ - name: items[].description.nodes[].layoutData.backdropImage.opacity | type: number | description: Background image opacity.
557
+ - name: items[].description.nodes[].layoutData.backdropImage.position | type: ImagePosition | description: Position of background. Defaults to `CENTER`.
558
+ enum:
559
+ BOTTOM: Image positioned at the center bottom
560
+ BOTTOM_LEFT: Image positioned at the bottom left
561
+ BOTTOM_RIGHT: Image positioned at the bottom right
562
+ CENTER: Image positioned at the center
563
+ CENTER_LEFT: Image positioned on the left
564
+ CENTER_RIGHT: Image positioned on the right
565
+ TOP: Image positioned at the center top
566
+ TOP_LEFT: Image positioned at the top left
567
+ TOP_RIGHT: Image positioned at the top right
568
+ - name: items[].description.nodes[].layoutData.backdropImage.scaling | type: Scaling | description: Background image scaling.
569
+ enum:
570
+ AUTO: Auto image scaling
571
+ CONTAIN: Contain image scaling
572
+ COVER: Cover image scaling
573
+ - name: items[].description.nodes[].layoutData.backdropPaddingBottom | type: number | description: Backdrop bottom padding
574
+ - name: items[].description.nodes[].layoutData.backdropPaddingTop | type: number | description: Backdrop top padding.
575
+ - name: items[].description.nodes[].layoutData.backgroundColor | type: string | description: Background color as a hexadecimal value.
576
+ - name: items[].description.nodes[].layoutData.backgroundImage | type: BackgroundImage | description: Background image.
577
+ - name: items[].description.nodes[].layoutData.borderColor | type: string | description: Border color as a hexadecimal value.
578
+ - name: items[].description.nodes[].layoutData.borderRadius | type: number | description: Border
579
+ - name: items[].description.nodes[].layoutData.borderWidth | type: number | description: Border width in pixels.
580
+ - name: items[].description.nodes[].layoutData.cellPadding | type: Array<number> | description: Padding in pixels for cells. Follows CSS order: top, right, bottom, left
581
+ - name: items[].description.nodes[].layoutData.cellVerticalAlignment | type: VerticalAlignmentAlignment | description: Vertical alignment for the cell's items.
582
+ enum:
583
+ BOTTOM: Bottom alignment
584
+ MIDDLE: Middle alignment
585
+ TOP: Top alignment
586
+ - name: items[].description.nodes[].layoutData.containerData | type: PluginContainerData | description: Styling for the layout's container.
587
+ - name: items[].description.nodes[].layoutData.gap | type: number | description: Horizontal and vertical gap between columns
588
+ - name: items[].description.nodes[].layoutData.responsivenessBehaviour | type: ResponsivenessBehaviour | description: Responsiveness behaviour of columns when responsiveness applies. Either stacks or wrappers.
589
+ enum:
590
+ STACK: Stacking of columns
591
+ WRAP: Wrapping of columns
592
+ - name: items[].description.nodes[].layoutData.responsivenessBreakpoint | type: number | description: Size in pixels when responsiveness_behaviour applies
593
+ - name: items[].description.nodes[].linkPreviewData | type: LinkPreviewData | description: Data for a link preview node.
594
+ - name: items[].description.nodes[].linkPreviewData.containerData | type: PluginContainerData | description: Styling for the link preview's container.
595
+ - name: items[].description.nodes[].linkPreviewData.description | type: string | description: Preview description.
596
+ - name: items[].description.nodes[].linkPreviewData.html | type: string | description: The preview content as HTML.
597
+ - name: items[].description.nodes[].linkPreviewData.link | type: Link | description: Link details.
598
+ - name: items[].description.nodes[].linkPreviewData.styles | type: LinkPreviewDataStyles | description: Styling for the link preview.
599
+ - name: items[].description.nodes[].linkPreviewData.styles.backgroundColor | type: string | description: Background color as a hexadecimal value.
600
+ - name: items[].description.nodes[].linkPreviewData.styles.borderColor | type: string | description: Border color as a hexadecimal value.
601
+ - name: items[].description.nodes[].linkPreviewData.styles.borderRadius | type: number | description: Border radius in pixels.
602
+ - name: items[].description.nodes[].linkPreviewData.styles.borderWidth | type: number | description: Border width in pixels.
603
+ - name: items[].description.nodes[].linkPreviewData.styles.linkColor | type: string | description: Link color as a hexadecimal value.
604
+ - name: items[].description.nodes[].linkPreviewData.styles.subtitleColor | type: string | description: Subtitle color as a hexadecimal value.
605
+ - name: items[].description.nodes[].linkPreviewData.styles.thumbnailPosition | type: StylesPosition | description: Position of thumbnail. Defaults to `START`.
606
+ enum:
607
+ END: Thumbnail positioned at the end (right in LTR layouts, left in RTL layouts)
608
+ HIDDEN: Thumbnail hidden and not displayed
609
+ START: Thumbnail positioned at the start (left in LTR layouts, right in RTL layouts)
610
+ TOP: Thumbnail positioned at the top
611
+ - name: items[].description.nodes[].linkPreviewData.styles.titleColor | type: string | description: Title color as a hexadecimal value.
612
+ - name: items[].description.nodes[].linkPreviewData.thumbnailUrl | type: string | description: Preview thumbnail URL.
613
+ - name: items[].description.nodes[].linkPreviewData.title | type: string | description: Preview title.
614
+ - name: items[].description.nodes[].mapData | type: MapData | description: none
615
+ - name: items[].description.nodes[].mapData.containerData | type: PluginContainerData | description: Styling for the map's container.
616
+ - name: items[].description.nodes[].mapData.mapSettings | type: MapSettings | description: Map settings.
617
+ - name: items[].description.nodes[].mapData.mapSettings.address | type: string | description: The address to display on the map.
618
+ - name: items[].description.nodes[].mapData.mapSettings.draggable | type: boolean | description: Sets whether the map is draggable.
619
+ - name: items[].description.nodes[].mapData.mapSettings.initialZoom | type: number | description: Initial zoom value.
620
+ - name: items[].description.nodes[].mapData.mapSettings.lat | type: number | description: Location latitude.
621
+ - name: items[].description.nodes[].mapData.mapSettings.lng | type: number | description: Location longitude.
622
+ - name: items[].description.nodes[].mapData.mapSettings.locationName | type: string | description: Location name.
623
+ - name: items[].description.nodes[].mapData.mapSettings.mapType | type: MapType | description: Map type. `HYBRID` is a combination of the `ROADMAP` and `SATELLITE` map types.
624
+ enum:
625
+ HYBRID: Hybrid map type
626
+ ROADMAP: Roadmap map type
627
+ SATELITE: Satellite map type
628
+ TERRAIN: Terrain map type
629
+ - name: items[].description.nodes[].mapData.mapSettings.marker | type: boolean | description: Sets whether the location marker is visible.
630
+ - name: items[].description.nodes[].mapData.mapSettings.streetViewControl | type: boolean | description: Sets whether street view control is enabled.
631
+ - name: items[].description.nodes[].mapData.mapSettings.viewModeControl | type: boolean | description: Sets whether view mode control is enabled.
632
+ - name: items[].description.nodes[].mapData.mapSettings.zoomControl | type: boolean | description: Sets whether zoom control is enabled.
633
+ - name: items[].description.nodes[].orderedListData | type: OrderedListData | description: Data for an ordered list node.
634
+ - name: items[].description.nodes[].orderedListData.indentation | type: number | description: Indentation level from 0-4.
635
+ - name: items[].description.nodes[].orderedListData.offset | type: number | description: Offset level from 0-4.
636
+ - name: items[].description.nodes[].orderedListData.start | type: number | description: List start number.
637
+ - name: items[].description.nodes[].paragraphData | type: ParagraphData | description: Data for a paragraph node.
638
+ - name: items[].description.nodes[].paragraphData.indentation | type: number | description: Indentation level from 1-4.
639
+ - name: items[].description.nodes[].paragraphData.level | type: number | description: Paragraph level
640
+ - name: items[].description.nodes[].paragraphData.textStyle | type: TextStyle | description: Styling for the paragraph text.
641
+ - name: items[].description.nodes[].pollData | type: PollData | description: Data for a poll node.
642
+ - name: items[].description.nodes[].pollData.containerData | type: PluginContainerData | description: Styling for the poll's container.
643
+ - name: items[].description.nodes[].pollData.design | type: Design | description: Styling for the poll and voting options.
644
+ - name: items[].description.nodes[].pollData.design.options | type: OptionDesign | description: Styling for voting options.
645
+ - name: items[].description.nodes[].pollData.design.options.borderRadius | type: number | description: Border radius in pixels.
646
+ - name: items[].description.nodes[].pollData.design.poll | type: PollDesign | description: Styling for the poll.
647
+ - name: items[].description.nodes[].pollData.design.poll.background | type: Background | description: Background styling.
648
+ - name: items[].description.nodes[].pollData.design.poll.background.type | type: BackgroundType | description: Background type. For each option, include the relevant details.
649
+ enum:
650
+ COLOR: Color background type
651
+ GRADIENT: Gradiant background type
652
+ IMAGE: Image background type
653
+ - ONE-OF:
654
+ - name: items[].description.nodes[].pollData.design.poll.background.color | type: string | description: The background color as a hexademical value.
655
+ - name: items[].description.nodes[].pollData.design.poll.background.gradient | type: Gradient | description: Details for a gradient background.
656
+ - name: items[].description.nodes[].pollData.design.poll.background.gradient.angle | type: number | description: The gradient angle in degrees.
657
+ - name: items[].description.nodes[].pollData.design.poll.background.gradient.lastColor | type: string | description: The end color as a hexademical value.
658
+ - name: items[].description.nodes[].pollData.design.poll.background.gradient.startColor | type: string | description: The start color as a hexademical value.
659
+ - name: items[].description.nodes[].pollData.design.poll.background.image | type: V1Media | description: An image to use for the background.
660
+ - name: items[].description.nodes[].pollData.design.poll.borderRadius | type: number | description: Border radius in pixels.
661
+ - name: items[].description.nodes[].pollData.layout | type: PollDataLayout | description: Layout settings for the poll and voting options.
662
+ - name: items[].description.nodes[].pollData.layout.options | type: OptionLayout | description: Voting otpions layout settings.
663
+ - name: items[].description.nodes[].pollData.layout.options.enableImage | type: boolean | description: Sets whether to display option images. Defaults to `false`.
664
+ - name: items[].description.nodes[].pollData.layout.poll | type: PollLayout | description: Poll layout settings.
665
+ - name: items[].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.
666
+ enum:
667
+ LTR: Left-to-right
668
+ RTL: Right-to-left
669
+ - name: items[].description.nodes[].pollData.layout.poll.enableImage | type: boolean | description: Sets whether to display the main poll image. Defaults to `false`.
670
+ - name: items[].description.nodes[].pollData.layout.poll.type | type: PollLayoutType | description: The layout for displaying the voting options.
671
+ enum:
672
+ GRID: Grid
673
+ LIST: List
674
+ - name: items[].description.nodes[].pollData.poll | type: Poll | description: Poll data.
675
+ - name: items[].description.nodes[].pollData.poll.creatorId | type: string | description: Poll creator GUID.
676
+ - name: items[].description.nodes[].pollData.poll.id | type: string | description: Poll GUID.
677
+ - name: items[].description.nodes[].pollData.poll.image | type: V1Media | description: Main poll image.
678
+ - name: items[].description.nodes[].pollData.poll.options | type: Array<Option> | description: Voting options.
679
+ - name: items[].description.nodes[].pollData.poll.options[].id | type: string | description: Option GUID.
680
+ - name: items[].description.nodes[].pollData.poll.options[].image | type: V1Media | description: The image displayed with the option.
681
+ - name: items[].description.nodes[].pollData.poll.options[].title | type: string | description: Option title.
682
+ - name: items[].description.nodes[].pollData.poll.settings | type: PollSettings | description: The poll's permissions and display settings.
683
+ - name: items[].description.nodes[].pollData.poll.settings.permissions | type: Permissions | description: Permissions settings for voting.
684
+ - name: items[].description.nodes[].pollData.poll.settings.permissions.allowMultipleVotes | type: boolean | description: Sets whether one voter can vote multiple times. Defaults to `false`.
685
+ - name: items[].description.nodes[].pollData.poll.settings.permissions.view | type: ViewRole | description: Sets who can view the poll results.
686
+ enum:
687
+ CREATOR: Only Poll creator can view the results
688
+ EVERYONE: Anyone can see the results, even if one didn't vote
689
+ VOTERS: Anyone who voted can see the results
690
+ - name: items[].description.nodes[].pollData.poll.settings.permissions.vote | type: VoteRole | description: Sets who can vote.
691
+ enum:
692
+ ALL: Anyone
693
+ SITE_MEMBERS: Logged in member
694
+ - name: items[].description.nodes[].pollData.poll.settings.showVoters | type: boolean | description: Sets whether voters are displayed in the vote results. Defaults to `true`.
695
+ - name: items[].description.nodes[].pollData.poll.settings.showVotesCount | type: boolean | description: Sets whether the vote count is displayed. Defaults to `true`.
696
+ - name: items[].description.nodes[].pollData.poll.title | type: string | description: Poll title.
697
+ - name: items[].description.nodes[].tableCellData | type: TableCellData | description: Data for a table cell node.
698
+ - name: items[].description.nodes[].tableCellData.borderColors | type: BorderColors | description: The cell's border colors.
699
+ - name: items[].description.nodes[].tableCellData.borderColors.bottom | type: string | description: Bottom border color as a hexadecimal value.
700
+ - name: items[].description.nodes[].tableCellData.borderColors.left | type: string | description: Left border color as a hexadecimal value.
701
+ - name: items[].description.nodes[].tableCellData.borderColors.right | type: string | description: Right border color as a hexadecimal value.
702
+ - name: items[].description.nodes[].tableCellData.borderColors.top | type: string | description: Top border color as a hexadecimal value.
703
+ - name: items[].description.nodes[].tableCellData.borderWidths | type: BorderWidths | description: The cell's border widths.
704
+ - name: items[].description.nodes[].tableCellData.borderWidths.bottom | type: number | description: Bottom border width in pixels.
705
+ - name: items[].description.nodes[].tableCellData.borderWidths.left | type: number | description: Left border width in pixels.
706
+ - name: items[].description.nodes[].tableCellData.borderWidths.right | type: number | description: Right border width in pixels.
707
+ - name: items[].description.nodes[].tableCellData.borderWidths.top | type: number | description: Top border width in pixels.
708
+ - name: items[].description.nodes[].tableCellData.cellStyle | type: CellStyle | description: Styling for the cell's background color and text alignment.
709
+ - name: items[].description.nodes[].tableCellData.cellStyle.backgroundColor | type: string | description: Cell background color as a hexadecimal value.
710
+ - name: items[].description.nodes[].tableCellData.cellStyle.verticalAlignment | type: VerticalAlignment | description: Vertical alignment for the cell's text.
711
+ enum:
712
+ BOTTOM: Bottom alignment
713
+ MIDDLE: Middle alignment
714
+ TOP: Top alignment
715
+ - name: items[].description.nodes[].tableCellData.colspan | type: number | description: Defines how many columns the cell spans. Default: 1.
716
+ - name: items[].description.nodes[].tableCellData.rowspan | type: number | description: Defines how many rows the cell spans. Default: 1.
717
+ - name: items[].description.nodes[].tableData | type: TableData | description: Data for a table node.
718
+ - name: items[].description.nodes[].tableData.cellPadding | type: Array<number> | description: Padding in pixels for cells. Follows CSS order: top, right, bottom, left.
719
+ - name: items[].description.nodes[].tableData.cellSpacing | type: number | description: The spacing between cells in pixels. Defaults to `0`.
720
+ - name: items[].description.nodes[].tableData.columnHeader | type: boolean | description: Sets whether the table's first column is a header. Defaults to `false`.
721
+ - name: items[].description.nodes[].tableData.containerData | type: PluginContainerData | description: Styling for the table's container.
722
+ - name: items[].description.nodes[].tableData.dimensions | type: Dimensions | description: The table's dimensions.
723
+ - name: items[].description.nodes[].tableData.dimensions.colsMinWidth | type: Array<number> | description: An array representing the minimum width of each column in pixels.
724
+ - name: items[].description.nodes[].tableData.dimensions.colsWidthRatio | type: Array<number> | description: An array representing relative width of each column in relation to the other columns.
725
+ - name: items[].description.nodes[].tableData.dimensions.rowsHeight | type: Array<number> | description: An array representing the height of each row in pixels.
726
+ - name: items[].description.nodes[].tableData.rowHeader | type: boolean | description: Sets whether the table's first row is a header. Defaults to `false`.
727
+ - name: items[].description.nodes[].textData | type: TextData | description: Data for a text node. Used to apply decorations to text.
728
+ - name: items[].description.nodes[].textData.decorations | type: Array<Decoration> | description: The decorations to apply.
729
+ - name: items[].description.nodes[].textData.text | type: string | description: The text to apply decorations to.
730
+ - name: items[].description.nodes[].videoData | type: VideoData | description: Data for a video node.
731
+ - name: items[].description.nodes[].videoData.containerData | type: PluginContainerData | description: Styling for the video's container.
732
+ - name: items[].description.nodes[].videoData.disableDownload | type: boolean | description: Sets whether the video's download button is disabled. Defaults to `false`.
733
+ - name: items[].description.nodes[].videoData.options | type: PlaybackOptions | description: Video options.
734
+ - name: items[].description.nodes[].videoData.options.autoPlay | type: boolean | description: Sets whether the media will automatically start playing.
735
+ - name: items[].description.nodes[].videoData.options.playInLoop | type: boolean | description: Sets whether media's will be looped.
736
+ - name: items[].description.nodes[].videoData.options.showControls | type: boolean | description: Sets whether media's controls will be shown.
737
+ - name: items[].description.nodes[].videoData.thumbnail | type: V1Media | description: Video thumbnail details.
738
+ - name: items[].description.nodes[].videoData.title | type: string | description: Video title.
739
+ - name: items[].description.nodes[].videoData.video | type: V1Media | description: Video details.
740
+ - name: items[].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.
741
+ - name: items[].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.
742
+ - name: items[].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).
743
+ - name: items[].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.
744
+ - name: items[].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.
745
+ - name: items[].infoSections[]._id | type: string | description: Info section GUID.
746
+ - name: items[].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>
747
+ - name: items[].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.
748
+ - name: items[].infoSections[].title | type: string | description: Info section title. > **Note:** Returned only when you pass `"INFO_SECTION"` to the `fields` array in Products API requests.
749
+ - name: items[].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.
750
+ - name: items[].inventory | type: Inventory | description: Product inventory info.
751
+ - name: items[].inventory.availabilityStatus | type: InventoryAvailabilityStatus | description: Current availability status.
752
+ enum:
753
+ IN_STOCK: All variants are in stock and available for purchase.
754
+ OUT_OF_STOCK: All variants are out of stock.
755
+ PARTIALLY_OUT_OF_STOCK: Some variants are out of stock and some are in stock and available for purchase.
756
+ UNKNOWN_AVAILABILITY_STATUS
757
+ - name: items[].inventory.preorderAvailability | type: ProductPreorderAvailability | description: Preorder availability status.
758
+ enum:
759
+ ALL_VARIANTS: All the product variants are available for preorder.
760
+ NO_VARIANTS: None of the product variants are available for preorder.
761
+ SOME_VARIANTS: Some of the product variants are available for preorder.
762
+ UNKNOWN_PREORDER_AVAILABILITY_STATUS
763
+ - name: items[].inventory.preorderStatus | type: PreorderStatus | description: Current preorder status.
764
+ enum:
765
+ DISABLED: All variants are disabled for preorder.
766
+ ENABLED: All variants are enabled for preorder.
767
+ PARTIALLY_ENABLED: Some variants are disabled and some are enabled for preorder.
768
+ UNKNOWN_PREORDER_STATUS
769
+ - name: items[].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".
770
+ - name: items[].media | type: Media | description: Product media items.
771
+ - name: items[].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.
772
+ - name: items[].media.itemsInfo.items | type: Array<ProductMedia> | description: All media items (images, videos etc) associated with this product.
773
+ - name: items[].media.itemsInfo.items[].altText | type: string | description: Image alt text.
774
+ - name: items[].media.itemsInfo.items[].displayName | type: string | description: Media display name. Allows to override the default media name. Can be passed only when `setBy: url`.
775
+ - name: items[].media.itemsInfo.items[].mediaType | type: MediaType | description: Media type.
776
+ enum:
777
+ IMAGE: Image media type.
778
+ UNKNOWN_MEDIA_TYPE, VIDEO: Video media type.
779
+ - name: items[].media.itemsInfo.items[].thumbnail | type: Thumbnail | description: Media thumbnail. > **Note:** Returned only when you pass `"THUMBNAIL"` to the `fields` array in Products API requests.
780
+ - name: items[].media.itemsInfo.items[].thumbnail.altText | type: string | description: Thumbnail alt text.
781
+ - name: items[].media.itemsInfo.items[].thumbnail.height | type: number | description: Thumbnail height.
782
+ - name: items[].media.itemsInfo.items[].thumbnail.url | type: string | description: Thumbnail url.
783
+ - name: items[].media.itemsInfo.items[].thumbnail.width | type: number | description: Thumbnail width.
784
+ - name: items[].media.itemsInfo.items[].uploadId | type: string | description: GUID used to upload media to Wix Media Manager.
785
+ - ONE-OF:
786
+ - name: items[].media.itemsInfo.items[]._id | type: string | description: Set media by GUID of an existing file in Wix Media Manager.
787
+ - name: items[].media.itemsInfo.items[].url | type: string | description: Set media using an external media URL.
788
+ - ONE-OF:
789
+ - name: items[].media.itemsInfo.items[].image | type: string | description: Product image.
790
+ - name: items[].media.itemsInfo.items[].video | type: string | description: Product video.
791
+ - name: items[].media.main | type: ProductMedia | description: Main media (image, video, etc.) associated with this product.
792
+ - name: items[].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.
793
+ - name: items[].modifiers[]._id | type: string | description: GUID of a customization with `customizationType: MODIFIER`.
794
+ - name: items[].modifiers[].mandatory | type: boolean | description: Whether customer input is required for this modifier.
795
+ - name: items[].modifiers[].modifierRenderType | type: ModifierRenderType | description: Modifier render type.
796
+ enum:
797
+ FREE_TEXT: Free text.
798
+ SWATCH_CHOICES: Swatch choices.
799
+ TEXT_CHOICES: Text choices.
800
+ UNKNOWN_MODIFIER_RENDER_TYPE: Not implemented.
801
+ - name: items[].modifiers[].name | type: string | description: Modifier title.
802
+ - ONE-OF:
803
+ - name: items[].modifiers[].choicesSettings | type: ModifierChoicesSettings | description: Choice settings.
804
+ - name: items[].modifiers[].choicesSettings.choices | type: Array<ConnectedModifierChoice> | description: List of modifier choices.
805
+ - name: items[].modifiers[].choicesSettings.choices[].addedPrice | type: string | description: Added price.
806
+ - name: items[].modifiers[].choicesSettings.choices[].choiceId | type: string | description: Choice GUID.
807
+ - name: items[].modifiers[].choicesSettings.choices[].choiceType | type: ChoiceType | description: Choice type.
808
+ enum:
809
+ CHOICE_TEXT: Text choice.
810
+ IMAGE: Image choice.
811
+ MULTIPLE_COLORS: Multiple colors choice.
812
+ ONE_COLOR: Single color choice.
813
+ UNKNOWN_CHOICE_TYPE
814
+ - name: items[].modifiers[].choicesSettings.choices[].key | type: string | description: Modifier key. Used for eCommerce integration.
815
+ - name: items[].modifiers[].choicesSettings.choices[].linkedMedia | type: Array<ProductMedia> | description: Product media.
816
+ - name: items[].modifiers[].choicesSettings.choices[].name | type: string | description: Choice name.
817
+ - ONE-OF:
818
+ - name: items[].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).
819
+ - name: items[].modifiers[].freeTextSettings | type: FreeTextSettings | description: Free text modifier settings.
820
+ - name: items[].modifiers[].freeTextSettings.defaultAddedPrice | type: string | description: Default amount to be added to the product's price.
821
+ - name: items[].modifiers[].freeTextSettings.maxCharCount | type: number | description: Maximum number of characters.
822
+ - name: items[].modifiers[].freeTextSettings.minCharCount | type: number | description: Minimum number of characters.
823
+ - name: items[].modifiers[].freeTextSettings.title | type: string | description: Title of the text to be input by the customer.
824
+ - name: items[].name | type: string | description: Product name. Translatable.
825
+ - name: items[].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.
826
+ - name: items[].options[]._id | type: string | description: GUID of a customization with `customizationType: PRODUCT_OPTION`.
827
+ - name: items[].options[].name | type: string | description: Option name.
828
+ - name: items[].options[].optionRenderType | type: ProductOptionRenderType | description: Option render type.
829
+ enum:
830
+ SWATCH_CHOICES: Swatch choices.
831
+ TEXT_CHOICES: Text choices.
832
+ UNKNOWN_OPTION_RENDER_TYPE: Not implemented.
833
+ - ONE-OF:
834
+ - name: items[].options[].choicesSettings | type: ChoicesSettings | description: Choices settings.
835
+ - name: items[].options[].choicesSettings.choices | type: Array<ConnectedOptionChoice> | description: List of available choices for the option.
836
+ - name: items[].options[].choicesSettings.choices[].choiceId | type: string | description: The id of the choice.
837
+ - name: items[].options[].choicesSettings.choices[].choiceType | type: ChoiceType | description: The type of this choice.
838
+ - name: items[].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
839
+ - name: items[].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.
840
+ - name: items[].options[].choicesSettings.choices[].name | type: string | description: Choice name.
841
+ - name: items[].options[].choicesSettings.choices[].visible | type: boolean | description: Whether at least one variant with this choice is visible. Default: `false`
842
+ - ONE-OF:
843
+ - name: items[].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).
844
+ - name: items[].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.
845
+ - name: items[].productType | type: ProductType | description: Product type. When passing `productType: PHYSICAL`, you must also pass `physicalProperties`.
846
+ enum:
847
+ DIGITAL: Digital product.
848
+ PHYSICAL: Physical product.
849
+ UNKNOWN_PRODUCT_TYPE: Not implemented.
850
+ - name: items[].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.
851
+ - name: items[].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.
852
+ - name: items[].ribbon._id | type: string | description: Ribbon GUID.
853
+ - name: items[].ribbon.name | type: string | description: Ribbon name.
854
+ - name: items[].seoData | type: SeoSchema | description: Product SEO data.
855
+ - name: items[].seoData.settings | type: Settings | description: SEO general settings.
856
+ - name: items[].seoData.settings.keywords | type: Array<Keyword> | description: User-selected keyword terms for a specific page.
857
+ - name: items[].seoData.settings.keywords[].isMain | type: boolean | description: Whether the keyword is the main focus keyword.
858
+ - name: items[].seoData.settings.keywords[].origin | type: string | description: The source that added the keyword terms to the SEO settings.
859
+ - name: items[].seoData.settings.keywords[].term | type: string | description: Keyword value.
860
+ - name: items[].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).
861
+ - name: items[].seoData.tags | type: Array<Tag> | description: SEO tag information.
862
+ - name: items[].seoData.tags[].children | type: string | description: SEO tag inner content. For example, `<title> inner content </title>`.
863
+ - name: items[].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).
864
+ - name: items[].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.
865
+ - name: items[].seoData.tags[].meta | type: Record<string, any> | description: SEO tag metadata. For example, `{"height": 300, "width": 240}`.
866
+ - name: items[].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"}`.
867
+ - name: items[].seoData.tags[].type | type: string | description: SEO tag type. Supported values: `title`, `meta`, `script`, `link`.
868
+ - name: items[].slug | type: string | description: Product slug. If not provided, the slug is autogenerated based on the product name.
869
+ - name: items[].subscriptionDetails | type: SubscriptionDetails | description: Product subscriptions.
870
+ - name: items[].subscriptionDetails.allowOneTimePurchases | type: boolean | description: Whether to allow one-time purchases in addition to subscription-based purchases. Default: `false`
871
+ - name: items[].subscriptionDetails.subscriptions | type: Array<Subscription> | description: Subscriptions.
872
+ - name: items[].subscriptionDetails.subscriptions[]._id | type: string | description: Subscription GUID.
873
+ - name: items[].subscriptionDetails.subscriptions[].description | type: string | description: Subscription description.
874
+ - name: items[].subscriptionDetails.subscriptions[].discount | type: SubscriptionDiscount | description: Discount info (optional). For example, a $20 discount would be `amount: 20`, `type: AMOUNT`.
875
+ - name: items[].subscriptionDetails.subscriptions[].discount.type | type: DiscountType | description: Discount type.
876
+ enum:
877
+ AMOUNT: Discount by a specific amount.
878
+ PERCENT: Discount by a percentage.
879
+ UNKNOWN_DISCOUNT
880
+ - ONE-OF:
881
+ - name: items[].subscriptionDetails.subscriptions[].discount.amountOff | type: string | description: Amount to discount from the variant discounted_price.
882
+ - name: items[].subscriptionDetails.subscriptions[].discount.percentOff | type: number | description: Percentage to discount from variant discounted_price.
883
+ - name: items[].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.
884
+ enum: DAY, MONTH, UNDEFINED, WEEK, YEAR
885
+ - name: items[].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.
886
+ - name: items[].subscriptionDetails.subscriptions[].title | type: string | description: Subscription title.
887
+ - name: items[].subscriptionDetails.subscriptions[].visible | type: boolean | description: Whether the subscription is visible to site visitors. Default: `true`
888
+ - ONE-OF:
889
+ - name: items[].subscriptionDetails.subscriptions[].autoRenewal | type: boolean | description: Whether subscription is renewed automatically at the end of each period. Cannot be `false`, instead set `billingCycles`.
890
+ - name: items[].subscriptionDetails.subscriptions[].billingCycles | type: number | description: Number of billing cycles before subscription ends.
891
+ - name: items[].taxGroupId | type: string | description: Tax group GUID.
892
+ - name: items[].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.
893
+ - name: items[].variantSummary | type: VariantSummary | description: The total number of variants for the product.
894
+ - name: items[].variantSummary.variantCount | type: number | description: The total number of variants for the product.
895
+ - name: items[].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.
896
+ - name: items[].variantsInfo.variants | type: Array<Variant> | description: List of related variants.
897
+ - name: items[].variantsInfo.variants[]._id | type: string | description: Variant GUID.
898
+ - name: items[].variantsInfo.variants[].barcode | type: string | description: Variant barcode.
899
+ - name: items[].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.
900
+ - name: items[].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.
901
+ - name: items[].variantsInfo.variants[].choices[].optionChoiceIds.choiceId | type: string | description: Choice GUID.
902
+ - name: items[].variantsInfo.variants[].choices[].optionChoiceIds.optionId | type: string | description: Option GUID.
903
+ - name: items[].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.
904
+ - name: items[].variantsInfo.variants[].choices[].optionChoiceNames.choiceName | type: string | description: Choice name.
905
+ - name: items[].variantsInfo.variants[].choices[].optionChoiceNames.optionName | type: string | description: Option name.
906
+ - name: items[].variantsInfo.variants[].choices[].optionChoiceNames.renderType | type: ProductOptionRenderType | description: Render type.
907
+ - name: items[].variantsInfo.variants[].inventoryStatus | type: InventoryStatus | description: Variant inventory status.
908
+ - name: items[].variantsInfo.variants[].inventoryStatus.inStock | type: boolean | description: Whether the variant is in stock.
909
+ - name: items[].variantsInfo.variants[].inventoryStatus.preorderEnabled | type: boolean | description: Whether preorder is enabled for this variant.
910
+ - name: items[].variantsInfo.variants[].media | type: ProductMedia | description: Variant media.
911
+ - name: items[].variantsInfo.variants[].price | type: PriceInfo | description: Variant price.
912
+ - name: items[].variantsInfo.variants[].price.actualPrice | type: FixedMonetaryAmount | description: Variant price. Must be greater or equal to 0.
913
+ - name: items[].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.
914
+ - name: items[].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.
915
+ - name: items[].variantsInfo.variants[].revenueDetails.cost | type: FixedMonetaryAmount | description: Item cost.
916
+ - name: items[].variantsInfo.variants[].revenueDetails.profit | type: FixedMonetaryAmount | description: Profit. Calculated by reducing `cost` from `discountedPrice`.
917
+ - name: items[].variantsInfo.variants[].revenueDetails.profitMargin | type: number | description: Profit Margin. Calculated by dividing `profit` by `discountedPrice`. The result is rounded to 4 decimal places.
918
+ - name: items[].variantsInfo.variants[].sku | type: string | description: Variant SKU (stock keeping unit).
919
+ - name: items[].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.
920
+ - name: items[].variantsInfo.variants[].subscriptionPricesInfo.subscriptionPrices | type: Array<SubscriptionPrice> | description: Subscription prices.
921
+ - name: items[].variantsInfo.variants[].subscriptionPricesInfo.subscriptionPrices[].price | type: FixedMonetaryAmount | description: Subscription price calculated by applying subscription discount to the variant `price.actual_price`
922
+ - name: items[].variantsInfo.variants[].subscriptionPricesInfo.subscriptionPrices[].pricePerUnit | type: SubscriptionPricePerUnit | description: Price per unit info.
923
+ - name: items[].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.
924
+ - name: items[].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.
925
+ - name: items[].variantsInfo.variants[].subscriptionPricesInfo.subscriptionPrices[].subscriptionId | type: string | description: Subscription GUID.
926
+ - name: items[].variantsInfo.variants[].visible | type: boolean | description: Whether the variant is visible to site visitors. Default: `true`
927
+ - ONE-OF:
928
+ - name: items[].variantsInfo.variants[].digitalProperties | type: VariantDigitalProperties | description: Digital properties. Must be passed when `productType: DIGITAL`
929
+ - name: items[].variantsInfo.variants[].digitalProperties.digitalFile | type: SecuredMedia | description: Digital file which will be downloaded by customer after successful purchase.
930
+ - name: items[].variantsInfo.variants[].digitalProperties.digitalFile._id | type: string | description: Media GUID in media manager.
931
+ - name: items[].variantsInfo.variants[].digitalProperties.digitalFile.fileName | type: string | description: Original file name.
932
+ - name: items[].variantsInfo.variants[].digitalProperties.digitalFile.fileSize | type: string | description: Original file size.
933
+ - name: items[].variantsInfo.variants[].digitalProperties.digitalFile.fileType | type: FileType | description: File type.
934
+ enum:
935
+ SECURE_ARCHIVE: Secure archive file.
936
+ SECURE_DOCUMENT: Secure document file.
937
+ SECURE_MUSIC: Secure music file.
938
+ SECURE_PICTURE: Secure picture file.
939
+ SECURE_VIDEO: Secure video file.
940
+ UNSPECIFIED: Unspecified file type.
941
+ - name: items[].variantsInfo.variants[].physicalProperties | type: VariantPhysicalProperties | description: Physical properties. Must be passed when `productType: PHYSICAL`
942
+ - name: items[].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.
943
+ - name: items[].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.
944
+ - name: items[].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.
945
+ - name: items[].variantsInfo.variants[].physicalProperties.pricePerUnit.settings.measurementUnit | type: MeasurementUnit | description: Measurement unit. For example, to define price per 100 grams, set this field to "G".
946
+ enum: CBM, CL, CM, FLOZ, FT, G, GAL, IN, KG, L, LB, M, MG, ML, MM, OZ, PT, QT, SQFT, SQM, UNSPECIFIED, YD
947
+ - name: items[].variantsInfo.variants[].physicalProperties.pricePerUnit.settings.quantity | type: number | description: Quantity. For example, to define price per per 100 grams, set this field to `100`.
948
+ - name: items[].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$).
949
+ - name: items[].variantsInfo.variants[].physicalProperties.weight | type: number | description: Variant shipping weight. product.physicalProperties.shipping_weight_range values are taken from here.
950
+ - name: items[].visible | type: boolean | description: Whether the product is visible to site visitors on the site. Default: `true`
951
+ - name: items[].visibleInPos | type: boolean | description: Whether the product is visible in POS (point of sale). Default: `true` > **Note:** Always `false` for `productType: DIGITAL`.
952
+ - ONE-OF:
953
+ - name: items[].physicalProperties | type: PhysicalProperties | description: Physical properties. Required when `productType: PHYSICAL`.
954
+ - name: items[].physicalProperties.deliveryProfileId | type: string | description: Delivery profile GUID.
955
+ - name: items[].physicalProperties.fulfillerId | type: string | description: Fulfiller GUID.
956
+ - name: items[].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.
957
+ - name: items[].physicalProperties.pricePerUnitRange | type: PricePerUnitRange | description: Product price per unit range. The minimum and maximum price per unit of all the variants.
958
+ - name: items[].physicalProperties.pricePerUnitRange.maxValue | type: PricePerUnitRangePricePerUnit | description: Maximum price per unit across all variants.
959
+ - name: items[].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.
960
+ - name: items[].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$).
961
+ - name: items[].physicalProperties.pricePerUnitRange.minValue | type: PricePerUnitRangePricePerUnit | description: Minimum price per unit across all variants.
962
+ - name: items[].physicalProperties.shippingWeightRange | type: WeightRange | description: Product shipping weight range - Calculated from the lightest and heaviest variant shipping weights.
963
+ - name: items[].physicalProperties.shippingWeightRange.maxValue | type: number | description: Maximum weight across all variants associated with this product.
964
+ - name: items[].physicalProperties.shippingWeightRange.minValue | type: number | description: Minimum weight across all variants associated with this product.
965
+ - name: items[].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.
966
+ - name: items[].physicalProperties.weightMeasurementUnitInfo.weightMeasurementUnit | type: WeightUnit | description: Weight measurement unit.
967
+ enum:
968
+ KG: Kilograms.
969
+ LB: Pounds.
970
+ UNSPECIFIED_WEIGHT_UNIT: Weight unit can't be classified due to an error.
971
+ - name: length | type: number | description: Returns the number of items in the current page of results. `length` returns just the number of items in the current page, not the total number of items that match the query. The page size is defined by the [`limit()`](/products-query-builder/limit) function and can be retrieved using the [`pageSize`](#page-size) property. You can use the [`next()`](#next) and [`prev()`](#prev) functions returned by `productsV3` to navigate the pages of a query result.
972
+ - name: pageSize | type: number | description: Returns the requested page size. `pageSize` returns the page size set in [`limit()`](/products-query-builder/limit) in `ProductsQueryBuilder`.
973
+ - name: query | type: ProductsQueryBuilder | description: Returns the `ProductsQueryBuilder` object used to get the current results. Use `query` to create and run a new query by chaining additional `ProductsQueryBuilder` functions to it. You can filter only on properties that haven't already been used in the previous `ProductsQueryBuilder`.
974
+ Method: stores.productsV3.hasNext()
975
+ Description: Indicates whether the query has more results. You can use the [`next()`](#next) and [`prev()`](#prev) functions returned by `productsV3` to navigate the pages of a query result.
976
+ Return type: PRIMITIVE<boolean>
977
+ Method: stores.productsV3.hasPrev()
978
+ Description: Indicates whether the query has previous results. You can use the [`next()`](#next) and [`prev()`](#prev) functions returned by `productsV3` to navigate the pages of a query result.
979
+ Return type: PRIMITIVE<boolean>
980
+ Method: stores.productsV3.queryProducts().next()
981
+ Description: Retrieves the next page of query results. The `next()` function retrieves the next page of query results. The page size is defined by the [`limit()`](/products-query-builder/limit) function and can be retrieved using the [`pageSize`](#page-size) property. You can use the [`next()`](#next) and [`prev()`](#prev) functions returned by `productsV3` to navigate the pages of a query result. If items are added or removed between calls to `next()`, the values returned by `ProductsQueryBuilder` may change.
982
+ Return type: PROMISE<ProductsQueryResult>
983
+ Method: stores.productsV3.queryProducts().prev()
984
+ Description: Retrieves the previous page of query results. The `prev()` function retrieves the previous page of query results. The page size is defined by the [`limit()`](/products-query-builder/limit) function and can be retrieved using the [`pageSize`](#page-size) property. You can use the [`next()`](#next) and [`prev()`](#prev) functions returned by `productsV3` to navigate the pages of a query result. If items are added or removed between calls to `prev()`, the values returned may change.
985
+ Return type: PROMISE<ProductsQueryResult>
986
+ Method: stores.productsV3.queryProducts().ge(propertyName, value)
987
+ Description: Refines a query to match items where the specified property is greater than or equal to the specified value. The `ge()` function refines a `ProductsQueryBuilder` to match only items where the value of the specified `propertyName` is greater than or equal to the specified `value`. `ge()` matches only values of the same type. For example, `0` stored as a number doesn't match `'0'` stored as a string. If a property contains a number stored as a string (for example, `'0'`), that value is compared alphabetically and not numerically. If a property doesn't have a value, that value is ranked lowest. The following types of properties can be compared: - Number: Compares numerically. - Date: Compares JavaScript Date objects. - String: Compares lexicographically, so `'abc'` is greater than `'ABC'`.
988
+ Method parameters:
989
+ param name: propertyName | type: string | description: Property whose value is compared with `value`.
990
+ param name: value | type: any | description: Value to compare against.
991
+ Return type: REFERENCE<ProductsQueryBuilder>
992
+ Method: stores.productsV3.queryProducts().gt(propertyName, value)
993
+ Description: Refines a query to match items where the specified property is greater than the specified value. The `gt()` function refines a `ProductsQueryBuilder` to match only items where the value of the specified `propertyName` is greater than the specified `value`. `gt()` matches only values of the same type. For example, `0` stored as a number doesn't match `'0'` stored as a string. If a property contains a number stored as a string (for example, `'0'`), that value is compared alphabetically and not numerically. If a property doesn't have a value, that value is ranked lowest. The following types of properties can be compared: - Number: Compares numerically. - Date: Compares JavaScript Date objects. - String: Compares lexicographically, so `'abc'` is greater than `'ABC'`.
994
+ Method parameters:
995
+ param name: propertyName | type: string | description: Property whose value is compared with `value`.
996
+ param name: value | type: any | description: Value to compare against.
997
+ Return type: REFERENCE<ProductsQueryBuilder>
998
+ Method: stores.productsV3.queryProducts().hasSome(propertyName, value)
999
+ Description: Refines a query to match items whose specified property contains any of the specified values. The `hasSome()` function refines a `ProductsQueryBuilder` to match only items where the value of the specified `propertyName` equals any of the specified `values`. Matching strings with `hasSome()` is case-sensitive, so `'text'` isn't equal to `'Text'`. If the specified property is an array, `hasSome()` matches if any of that array's elements equal any of the specified values.
1000
+ Method parameters:
1001
+ param name: propertyName | type: string | description: Property whose value is compared with `values`.
1002
+ param name: value | type: Array<any> | description: none
1003
+ Return type: REFERENCE<ProductsQueryBuilder>
1004
+ Method: stores.productsV3.queryProducts().in(propertyName, value)
1005
+ Description: Refines a query to only match items where the specified property contains any of the values in the provided array of values. The `in()` function refines a `ProductsQueryBuilder` to match only items where the specified `propertyName` is equal to any of the values in the provided array. Matching strings with `in()` is case-sensitive, so `'text'` isn't equal to `'Text'`.
1006
+ Method parameters:
1007
+ param name: propertyName | type: string | description: none
1008
+ param name: value | type: any | description: none
1009
+ Return type: REFERENCE<ProductsQueryBuilder>
1010
+ Method: stores.productsV3.queryProducts().le(propertyName, value)
1011
+ Description: Refines a query to match items where the specified property is less than or equal to the specified value. The `le()` function refines a `ProductsQueryBuilder` to match only items where the value of the specified `propertyName` is less than or equal to the specified `value`. `le()` matches only values of the same type. For example, `0` stored as a number doesn't match `'0'` stored as a string. If a property contains a number stored as a string (for example, `'0'`), that value is compared alphabetically and not numerically. If a property doesn't have a value, that value is ranked lowest. The following types of properties can be compared: - Number: Compares numerically. - Date: Compares JavaScript Date objects. - String: Compares lexicographically, so `'ABC'` is less than `'abc'`.
1012
+ Method parameters:
1013
+ param name: propertyName | type: string | description: Property whose value is compared with `value`.
1014
+ param name: value | type: any | description: Value to compare against.
1015
+ Return type: REFERENCE<ProductsQueryBuilder>
1016
+ Method: stores.productsV3.queryProducts().limit(limit)
1017
+ Description: Limits the number of items the query returns. The `limit()` function defines the number of results a query returns in each page. Only one page of results is retrieved at a time. You can use the `next()` and `prev()` functions to navigate the pages of a query result.
1018
+ Method parameters:
1019
+ param name: limit | type: number | description: Number of items to return, which is also the `pageSize` of the results object.
1020
+ Return type: REFERENCE<ProductsQueryBuilder>
1021
+ Method: stores.productsV3.queryProducts().lt(propertyName, value)
1022
+ Description: Refines a query to match items where the specified property is less than the specified value. The `le()` function refines a `ProductsQueryBuilder` to match only items where the value of the specified `propertyName` is less than the specified `value`. `le()` matches only values of the same type. For example, `0` stored as a number doesn't match `'0'` stored as a string. If a property contains a number stored as a string (for example, `'0'`), that value is compared alphabetically and not numerically. If a property doesn't have a value, that value is ranked lowest. The following types of properties can be compared: - Number: Compares numerically. - Date: Compares JavaScript Date objects. - String: Compares lexicographically, so `'ABC'` is less than `'abc'`.
1023
+ Method parameters:
1024
+ param name: propertyName | type: string | description: Property whose value is compared with `value`.
1025
+ param name: value | type: any | description: Value to compare against.
1026
+ Return type: REFERENCE<ProductsQueryBuilder>
1027
+ Method: stores.productsV3.queryProducts().ne(propertyName, value)
1028
+ Description: Refines a query to match items where the specified property doesn't equal the specified value. The `ne()` function refines a `ProductsQueryBuilder` to match only items where the value of the specified `propertyName` doesn't equal the specified `value`. `ne()` matches only values of the same type. For example, `0` stored as a number doesn't match `'0'` stored as a string. Matching strings with `ne()` is case-sensitive, so `'text'` isn't equal to `'Text'`.
1029
+ Method parameters:
1030
+ param name: propertyName | type: string | description: Property whose value is compared with `value`.
1031
+ param name: value | type: any | description: Value to compare against.
1032
+ Return type: REFERENCE<ProductsQueryBuilder>
1033
+ Method: stores.productsV3.queryProducts().skipTo(cursor)
1034
+ Description: Refines a query that skips to a specific record. The `skipTo()` function refines a `ProductsQueryBuilder` to return items that appear before or after the item pointed to by the provided cursor. Get the relevant cursor for a specific item from the `cursors` object in previous call's response. Then you can skip to `cursors.prev` to return items before the cursor, or `cursors.next` to return items after the cursor. When using `skipTo()`, the filters and the sorting order of the original query can't be changed. Only the `limit()` property of the query can be changed.
1035
+ Method parameters:
1036
+ param name: cursor | type: string | description: A pointer to specific record
1037
+ Return type: REFERENCE<ProductsQueryBuilder>
1038
+ Method: stores.productsV3.queryProducts().startsWith(propertyName, value)
1039
+ Description: Refines a query to match items where the specified property starts with the specified value. The `startsWith()` function refines a `ProductsQueryBuilder` to match only items where the value of the specified `propertyName` starts with the specified `string`. Matching with `startsWith()` is case-sensitive, so `'TEXT'` doesn't start with `'text'`. You can only use `startsWith()` with a property whose value is a string.
1040
+ Method parameters:
1041
+ param name: propertyName | type: string | description: Property whose value is compared with `string`.
1042
+ param name: value | type: string | description: none
1043
+ Return type: REFERENCE<ProductsQueryBuilder>
1044
+ Possible Errors:
1045
+ HTTP Code: 403 | Status Code: PERMISSION_DENIED | Application Code: NO_PERMISSION_TO_INCLUDE_NOT_VISIBLE_PRODUCTS
1046
+ HTTP Code: 403 | Status Code: PERMISSION_DENIED | Application Code: NO_PERMISSION_TO_READ_MERCHANT_DATA
1047
+
1048
+
1049
+ ```
1050
+ </type_definition>
1051
+ </stores_productsV3_queryProducts>