schema.graphqls 33 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556
  1. # Copyright © Magento, Inc. All rights reserved.
  2. # See COPYING.txt for license details.
  3. type Query {
  4. products (
  5. search: String @doc(description: "Performs a full-text search using the specified key words."),
  6. filter: ProductFilterInput @doc(description: "Identifies which product attributes to search for and return."),
  7. pageSize: Int = 20 @doc(description: "Specifies the maximum number of results to return at once. This attribute is optional."),
  8. currentPage: Int = 1 @doc(description: "Specifies which page of results to return. The default value is 1."),
  9. sort: ProductSortInput @doc(description: "Specifies which attribute to sort on, and whether to return the results in ascending or descending order.")
  10. ): Products
  11. @resolver(class: "Magento\\CatalogGraphQl\\Model\\Resolver\\Products") @doc(description: "The products query searches for products that match the criteria specified in the search and filter attributes")
  12. category (
  13. id: Int @doc(description: "Id of the category")
  14. ): CategoryTree
  15. @resolver(class: "Magento\\CatalogGraphQl\\Model\\Resolver\\CategoryTree")
  16. }
  17. enum CurrencyEnum @doc(description: "The list of available currency codes") {
  18. AFN
  19. ALL
  20. AZN
  21. DZD
  22. AOA
  23. ARS
  24. AMD
  25. AWG
  26. AUD
  27. BSD
  28. BHD
  29. BDT
  30. BBD
  31. BYR
  32. BZD
  33. BMD
  34. BTN
  35. BOB
  36. BAM
  37. BWP
  38. BRL
  39. GBP
  40. BND
  41. BGN
  42. BUK
  43. BIF
  44. KHR
  45. CAD
  46. CVE
  47. CZK
  48. KYD
  49. GQE
  50. CLP
  51. CNY
  52. COP
  53. KMF
  54. CDF
  55. CRC
  56. HRK
  57. CUP
  58. DKK
  59. DJF
  60. DOP
  61. XCD
  62. EGP
  63. SVC
  64. ERN
  65. EEK
  66. ETB
  67. EUR
  68. FKP
  69. FJD
  70. GMD
  71. GEK
  72. GEL
  73. GHS
  74. GIP
  75. GTQ
  76. GNF
  77. GYD
  78. HTG
  79. HNL
  80. HKD
  81. HUF
  82. ISK
  83. INR
  84. IDR
  85. IRR
  86. IQD
  87. ILS
  88. JMD
  89. JPY
  90. JOD
  91. KZT
  92. KES
  93. KWD
  94. KGS
  95. LAK
  96. LVL
  97. LBP
  98. LSL
  99. LRD
  100. LYD
  101. LTL
  102. MOP
  103. MKD
  104. MGA
  105. MWK
  106. MYR
  107. MVR
  108. LSM
  109. MRO
  110. MUR
  111. MXN
  112. MDL
  113. MNT
  114. MAD
  115. MZN
  116. MMK
  117. NAD
  118. NPR
  119. ANG
  120. YTL
  121. NZD
  122. NIC
  123. NGN
  124. KPW
  125. NOK
  126. OMR
  127. PKR
  128. PAB
  129. PGK
  130. PYG
  131. PEN
  132. PHP
  133. PLN
  134. QAR
  135. RHD
  136. RON
  137. RUB
  138. RWF
  139. SHP
  140. STD
  141. SAR
  142. RSD
  143. SCR
  144. SLL
  145. SGD
  146. SKK
  147. SBD
  148. SOS
  149. ZAR
  150. KRW
  151. LKR
  152. SDG
  153. SRD
  154. SZL
  155. SEK
  156. CHF
  157. SYP
  158. TWD
  159. TJS
  160. TZS
  161. THB
  162. TOP
  163. TTD
  164. TND
  165. TMM
  166. USD
  167. UGX
  168. UAH
  169. AED
  170. UYU
  171. UZS
  172. VUV
  173. VEB
  174. VEF
  175. VND
  176. CHE
  177. CHW
  178. XOF
  179. WST
  180. YER
  181. ZMK
  182. ZWD
  183. TRY
  184. AZM
  185. ROL
  186. TRL
  187. XPF
  188. }
  189. type Price @doc(description: "The Price object defines the price of a product as well as any tax-related adjustments.") {
  190. amount: Money @doc(description: "The price of a product plus a three-letter currency code")
  191. adjustments: [PriceAdjustment] @doc(description: "An array that provides information about tax, weee, or weee_tax adjustments")
  192. }
  193. type PriceAdjustment @doc(description: "The PricedAdjustment object defines the amount of money to apply as an adjustment, the type of adjustment to apply, and whether the item is included or excluded from the adjustment.") {
  194. amount: Money @doc(description: "The amount of the price adjustment and its currency code")
  195. code: PriceAdjustmentCodesEnum @doc(description: "Indicates whether the adjustment involves tax, weee, or weee_tax")
  196. description: PriceAdjustmentDescriptionEnum @doc(description: "Indicates whether the entity described by the code attribute is included or excluded from the adjustment")
  197. }
  198. enum PriceAdjustmentCodesEnum @doc(description: "Note: This enumeration contains values defined in modules other than the Catalog module.") {
  199. }
  200. enum PriceAdjustmentDescriptionEnum @doc(description: "This enumeration states whether a price adjustment is included or excluded.") {
  201. INCLUDED
  202. EXCLUDED
  203. }
  204. enum PriceTypeEnum @doc(description: "This enumeration the price type.") {
  205. FIXED
  206. PERCENT
  207. DYNAMIC
  208. }
  209. type Money @doc(description: "A Money object defines a monetary value, including a numeric value and a currency code.") {
  210. value: Float @doc(description: "A number expressing a monetary value")
  211. currency: CurrencyEnum @doc(description: "A three-letter currency code, such as USD or EUR")
  212. }
  213. type ProductPrices @doc(description: "The ProductPrices object contains the regular price of an item, as well as its minimum and maximum prices. Only composite products, which include bundle, configurable, and grouped products, can contain a minimum and maximum price.") {
  214. minimalPrice: Price @doc(description: "The lowest possible final price for all the options defined within a composite product. If you are specifying a price range, this would be the from value.")
  215. maximalPrice: Price @doc(description: "The highest possible final price for all the options defined within a composite product. If you are specifying a price range, this would be the to value.")
  216. regularPrice: Price @doc(description: "The base price of a product.")
  217. }
  218. type ProductLinks implements ProductLinksInterface @doc(description: "ProductLinks is an implementation of ProductLinksInterface.") {
  219. }
  220. interface ProductLinksInterface @typeResolver(class: "Magento\\CatalogGraphQl\\Model\\ProductLinkTypeResolverComposite") @doc(description:"ProductLinks contains information about linked products, including the link type and product type of each item.") {
  221. sku: String @doc(description: "The identifier of the linked product")
  222. link_type: String @doc(description: "One of related, associated, upsell, or crosssell")
  223. linked_product_sku: String @doc(description: "The SKU of the linked product")
  224. linked_product_type: String @doc(description: "The type of linked product (simple, virtual, bundle, downloadable, grouped, configurable)")
  225. position: Int @doc(description: "The position within the list of product links")
  226. }
  227. type ProductTierPrices @doc(description: "The ProductTierPrices object defines a tier price, which is a quantity discount offered to a specific customer group.") {
  228. customer_group_id: String @doc(description: "The ID of the customer group")
  229. qty: Float @doc(description: "The number of items that must be purchased to qualify for tier pricing")
  230. value: Float @doc(description: "The price of the fixed price item")
  231. percentage_value: Float @doc(description: "The percentage discount of the item")
  232. website_id: Float @doc(description: "The ID assigned to the website")
  233. }
  234. interface ProductInterface @typeResolver(class: "Magento\\CatalogGraphQl\\Model\\ProductInterfaceTypeResolverComposite") @doc(description: "The ProductInterface contains attributes that are common to all types of products. Note that descriptions may not be available for custom and EAV attributes.") {
  235. id: Int @doc(description: "The ID number assigned to the product") @resolver(class: "Magento\\CatalogGraphQl\\Model\\Resolver\\Product\\EntityIdToId")
  236. name: String @doc(description: "The product name. Customers use this name to identify the product.")
  237. sku: String @doc(description: "A number or code assigned to a product to identify the product, options, price, and manufacturer")
  238. description: ComplexTextValue @doc(description: "Detailed information about the product. The value can include simple HTML tags.") @resolver(class: "\\Magento\\CatalogGraphQl\\Model\\Resolver\\Product\\ProductComplexTextAttribute")
  239. short_description: ComplexTextValue @doc(description: "A short description of the product. Its use depends on the theme.") @resolver(class: "\\Magento\\CatalogGraphQl\\Model\\Resolver\\Product\\ProductComplexTextAttribute")
  240. special_price: Float @doc(description: "The discounted price of the product")
  241. special_from_date: String @doc(description: "The beginning date that a product has a special price")
  242. special_to_date: String @doc(description: "The end date that a product has a special price")
  243. attribute_set_id: Int @doc(description: "The attribute set assigned to the product")
  244. meta_title: String @doc(description: "A string that is displayed in the title bar and tab of the browser and in search results lists")
  245. meta_keyword: String @doc(description: "A comma-separated list of keywords that are visible only to search engines")
  246. meta_description: String @doc(description: "A brief overview of the product for search results listings, maximum 255 characters")
  247. image: ProductImage @doc(description: "The relative path to the main image on the product page") @resolver(class: "Magento\\CatalogGraphQl\\Model\\Resolver\\Product\\ProductImage")
  248. small_image: ProductImage @doc(description: "The relative path to the small image, which is used on catalog pages") @resolver(class: "Magento\\CatalogGraphQl\\Model\\Resolver\\Product\\ProductImage")
  249. thumbnail: ProductImage @doc(description: "The relative path to the product's thumbnail image") @resolver(class: "Magento\\CatalogGraphQl\\Model\\Resolver\\Product\\ProductImage")
  250. new_from_date: String @doc(description: "The beginning date for new product listings, and determines if the product is featured as a new product") @resolver(class: "Magento\\CatalogGraphQl\\Model\\Resolver\\Product\\NewFromTo")
  251. new_to_date: String @doc(description: "The end date for new product listings") @resolver(class: "Magento\\CatalogGraphQl\\Model\\Resolver\\Product\\NewFromTo")
  252. tier_price: Float @doc(description: "The price when tier pricing is in effect and the items purchased threshold has been reached")
  253. options_container: String @doc(description: "If the product has multiple options, determines where they appear on the product page")
  254. created_at: String @doc(description: "Timestamp indicating when the product was created")
  255. updated_at: String @doc(description: "Timestamp indicating when the product was updated")
  256. country_of_manufacture: String @doc(description: "The product's country of origin")
  257. type_id: String @doc(description: "One of simple, virtual, bundle, downloadable, grouped, or configurable")
  258. websites: [Website] @doc(description: "An array of websites in which the product is available") @resolver(class: "Magento\\CatalogGraphQl\\Model\\Resolver\\Product\\Websites")
  259. product_links: [ProductLinksInterface] @doc(description: "An array of ProductLinks objects") @resolver(class: "Magento\\CatalogGraphQl\\Model\\Resolver\\Product\\ProductLinks")
  260. media_gallery_entries: [MediaGalleryEntry] @doc(description: "An array of MediaGalleryEntry objects") @resolver(class: "Magento\\CatalogGraphQl\\Model\\Resolver\\Product\\MediaGalleryEntries")
  261. tier_prices: [ProductTierPrices] @doc(description: "An array of ProductTierPrices objects") @resolver(class: "Magento\\CatalogGraphQl\\Model\\Resolver\\Product\\TierPrices")
  262. price: ProductPrices @doc(description: "A ProductPrices object, indicating the price of an item") @resolver(class: "Magento\\CatalogGraphQl\\Model\\Resolver\\Product\\Price")
  263. gift_message_available: String @doc(description: "Indicates whether a gift message is available")
  264. manufacturer: Int @doc(description: "A number representing the product's manufacturer")
  265. categories: [CategoryInterface] @doc(description: "The categories assigned to a product") @resolver(class: "Magento\\CatalogGraphQl\\Model\\Resolver\\Categories")
  266. canonical_url: String @doc(description: "Canonical URL") @resolver(class: "Magento\\CatalogGraphQl\\Model\\Resolver\\Product\\CanonicalUrl")
  267. }
  268. interface PhysicalProductInterface @typeResolver(class: "Magento\\CatalogGraphQl\\Model\\ProductInterfaceTypeResolverComposite") @doc(description: "PhysicalProductInterface contains attributes specific to tangible products") {
  269. weight: Float @doc(description: "The weight of the item, in units defined by the store")
  270. }
  271. type CustomizableAreaOption implements CustomizableOptionInterface @doc(description: "CustomizableAreaOption contains information about a text area that is defined as part of a customizable option") {
  272. value: CustomizableAreaValue @doc(description: "An object that defines a text area")
  273. product_sku: String @doc(description: "The Stock Keeping Unit of the base product")
  274. }
  275. type CustomizableAreaValue @doc(description: "CustomizableAreaValue defines the price and sku of a product whose page contains a customized text area") {
  276. price: Float @doc(description: "The price assigned to this option")
  277. price_type: PriceTypeEnum @doc(description: "FIXED, PERCENT, or DYNAMIC")
  278. sku: String @doc(description: "The Stock Keeping Unit for this option")
  279. max_characters: Int @doc(description: "The maximum number of characters that can be entered for this customizable option")
  280. }
  281. type CategoryTree implements CategoryInterface @doc(description: "Category Tree implementation") {
  282. children: [CategoryTree] @doc(description: "Child categories tree") @resolve(class: "Magento\\CatalogGraphQl\\Model\\Resolver\\CategoryTree")
  283. }
  284. type CustomizableDateOption implements CustomizableOptionInterface @doc(description: "CustomizableDateOption contains information about a date picker that is defined as part of a customizable option") {
  285. value: CustomizableDateValue @doc(description: "An object that defines a date field in a customizable option.")
  286. product_sku: String @doc(description: "The Stock Keeping Unit of the base product")
  287. }
  288. type CustomizableDateValue @doc(description: "CustomizableDateValue defines the price and sku of a product whose page contains a customized date picker") {
  289. price: Float @doc(description: "The price assigned to this option")
  290. price_type: PriceTypeEnum @doc(description: "FIXED, PERCENT, or DYNAMIC")
  291. sku: String @doc(description: "The Stock Keeping Unit for this option")
  292. }
  293. type CustomizableDropDownOption implements CustomizableOptionInterface @doc(description: "CustomizableDropDownOption contains information about a drop down menu that is defined as part of a customizable option") {
  294. value: [CustomizableDropDownValue] @doc(description: "An array that defines the set of options for a drop down menu")
  295. }
  296. type CustomizableDropDownValue @doc(description: "CustomizableDropDownValue defines the price and sku of a product whose page contains a customized drop down menu") {
  297. option_type_id: Int @doc(description: "The ID assigned to the value")
  298. price: Float @doc(description: "The price assigned to this option")
  299. price_type: PriceTypeEnum @doc(description: "FIXED, PERCENT, or DYNAMIC")
  300. sku: String @doc(description: "The Stock Keeping Unit for this option")
  301. title: String @doc(description: "The display name for this option")
  302. sort_order: Int @doc(description: "The order in which the option is displayed")
  303. }
  304. type CustomizableFieldOption implements CustomizableOptionInterface @doc(description: "CustomizableFieldOption contains information about a text field that is defined as part of a customizable option") {
  305. value: CustomizableFieldValue @doc(description: "An object that defines a text field")
  306. product_sku: String @doc(description: "The Stock Keeping Unit of the base product")
  307. }
  308. type CustomizableFieldValue @doc(description: "CustomizableFieldValue defines the price and sku of a product whose page contains a customized text field") {
  309. price: Float @doc(description: "The price of the custom value")
  310. price_type: PriceTypeEnum @doc(description: "FIXED, PERCENT, or DYNAMIC")
  311. sku: String @doc(description: "The Stock Keeping Unit for this option")
  312. max_characters: Int @doc(description: "The maximum number of characters that can be entered for this customizable option")
  313. }
  314. type CustomizableFileOption implements CustomizableOptionInterface @doc(description: "CustomizableFileOption contains information about a file picker that is defined as part of a customizable option") {
  315. value: CustomizableFileValue @doc(description: "An object that defines a file value")
  316. product_sku: String @doc(description: "The Stock Keeping Unit of the base product")
  317. }
  318. type CustomizableFileValue @doc(description: "CustomizableFileValue defines the price and sku of a product whose page contains a customized file picker") {
  319. price: Float @doc(description: "The price assigned to this option")
  320. price_type: PriceTypeEnum @doc(description: "FIXED, PERCENT, or DYNAMIC")
  321. sku: String @doc(description: "The Stock Keeping Unit for this option")
  322. file_extension: String @doc(description: "The file extension to accept")
  323. image_size_x: Int @doc(description: "The maximum width of an image")
  324. image_size_y: Int @doc(description: "The maximum height of an image")
  325. }
  326. type ProductImage @doc(description: "Product image information. Contains image relative path, URL and label") {
  327. url: String @resolver(class: "Magento\\CatalogGraphQl\\Model\\Resolver\\Product\\ProductImage\\Url")
  328. label: String @resolver(class: "Magento\\CatalogGraphQl\\Model\\Resolver\\Product\\ProductImage\\Label")
  329. }
  330. interface CustomizableOptionInterface @typeResolver(class: "Magento\\CatalogGraphQl\\Model\\CustomizableOptionTypeResolver") @doc(description: "The CustomizableOptionInterface contains basic information about a customizable option. It can be implemented by several types of configurable options.") {
  331. title: String @doc(description: "The display name for this option")
  332. required: Boolean @doc(description: "Indicates whether the option is required")
  333. sort_order: Int @doc(description: "The order in which the option is displayed")
  334. option_id: Int @doc(description: "Option ID")
  335. }
  336. interface CustomizableProductInterface @typeResolver(class: "Magento\\CatalogGraphQl\\Model\\ProductInterfaceTypeResolverComposite") @doc(description: "CustomizableProductInterface contains information about customizable product options.") {
  337. options: [CustomizableOptionInterface] @doc(description: "An array of options for a customizable product") @resolver(class: "Magento\\CatalogGraphQl\\Model\\Resolver\\Product\\Options")
  338. }
  339. interface CategoryInterface @typeResolver(class: "Magento\\CatalogGraphQl\\Model\\CategoryInterfaceTypeResolver") @doc(description: "CategoryInterface contains the full set of attributes that can be returned in a category search") {
  340. id: Int @doc(description: "An ID that uniquely identifies the category")
  341. description: String @doc(description: "An optional description of the category") @resolver(class: "\\Magento\\CatalogGraphQl\\Model\\Resolver\\Category\\CategoryHtmlAttribute")
  342. name: String @doc(description: "The display name of the category")
  343. path: String @doc(description: "Category Path")
  344. path_in_store: String @doc(description: "Category path in store")
  345. url_key: String @doc(description: "The url key assigned to the category")
  346. url_path: String @doc(description: "The url path assigned to the category")
  347. position: Int @doc(description: "The position of the category relative to other categories at the same level in tree")
  348. level: Int @doc(description: "Indicates the depth of the category within the tree")
  349. created_at: String @doc(description: "Timestamp indicating when the category was created")
  350. updated_at: String @doc(description: "Timestamp indicating when the category was updated")
  351. product_count: Int @doc(description: "The number of products in the category") @resolver(class: "Magento\\CatalogGraphQl\\Model\\Resolver\\Category\\ProductsCount")
  352. default_sort_by: String @doc(description: "The attribute to use for sorting")
  353. products(
  354. pageSize: Int = 20 @doc(description: "Specifies the maximum number of results to return at once. This attribute is optional."),
  355. currentPage: Int = 1 @doc(description: "Specifies which page of results to return. The default value is 1."),
  356. sort: ProductSortInput @doc(description: "Specifies which attribute to sort on, and whether to return the results in ascending or descending order.")
  357. ): CategoryProducts @doc(description: "The list of products assigned to the category") @resolver(class: "Magento\\CatalogGraphQl\\Model\\Resolver\\Category\\Products")
  358. breadcrumbs: [Breadcrumb] @doc(description: "Breadcrumbs, parent categories info") @resolver(class: "Magento\\CatalogGraphQl\\Model\\Resolver\\Category\\Breadcrumbs")
  359. }
  360. type Breadcrumb @doc(description: "Breadcrumb item"){
  361. category_id: Int @doc(description: "Category ID")
  362. category_name: String @doc(description: "Category name")
  363. category_level: Int @doc(description: "Category level")
  364. category_url_key: String @doc(description: "Category URL key")
  365. }
  366. type CustomizableRadioOption implements CustomizableOptionInterface @doc(description: "CustomizableRadioOption contains information about a set of radio buttons that are defined as part of a customizable option") {
  367. value: [CustomizableRadioValue] @doc(description: "An array that defines a set of radio buttons")
  368. }
  369. type CustomizableRadioValue @doc(description: "CustomizableRadioValue defines the price and sku of a product whose page contains a customized set of radio buttons") {
  370. option_type_id: Int @doc(description: "The ID assigned to the value")
  371. price: Float @doc(description: "The price assigned to this option")
  372. price_type: PriceTypeEnum @doc(description: "FIXED, PERCENT, or DYNAMIC")
  373. sku: String @doc(description: "The Stock Keeping Unit for this option")
  374. title: String @doc(description: "The display name for this option")
  375. sort_order: Int @doc(description: "The order in which the radio button is displayed")
  376. }
  377. type VirtualProduct implements ProductInterface, CustomizableProductInterface @doc(description: "A virtual product is non-tangible product that does not require shipping and is not kept in inventory") {
  378. }
  379. type SimpleProduct implements ProductInterface, PhysicalProductInterface, CustomizableProductInterface @doc(description: "A simple product is tangible and are usually sold as single units or in fixed quantities")
  380. {
  381. }
  382. type Products @doc(description: "The Products object is the top-level object returned in a product search") {
  383. items: [ProductInterface] @doc(description: "An array of products that match the specified search criteria")
  384. page_info: SearchResultPageInfo @doc(description: "An object that includes the page_info and currentPage values specified in the query")
  385. total_count: Int @doc(description: "The number of products returned")
  386. filters: [LayerFilter] @resolver(class: "Magento\\CatalogGraphQl\\Model\\Resolver\\LayerFilters") @doc(description: "Layered navigation filters array")
  387. sort_fields: SortFields @doc(description: "An object that includes the default sort field and all available sort fields") @resolver(class: "Magento\\CatalogGraphQl\\Model\\Resolver\\Category\\SortFields")
  388. }
  389. type CategoryProducts @doc(description: "The category products object returned in the Category query") {
  390. items: [ProductInterface] @doc(description: "An array of products that are assigned to the category")
  391. page_info: SearchResultPageInfo @doc(description: "An object that includes the page_info and currentPage values specified in the query")
  392. total_count: Int @doc(description: "The number of products returned")
  393. }
  394. input ProductFilterInput @doc(description: "ProductFilterInput defines the filters to be used in the search. A filter contains at least one attribute, a comparison operator, and the value that is being searched for.") {
  395. name: FilterTypeInput @doc(description: "The product name. Customers use this name to identify the product.")
  396. sku: FilterTypeInput @doc(description: "A number or code assigned to a product to identify the product, options, price, and manufacturer")
  397. description: FilterTypeInput @doc(description: "Detailed information about the product. The value can include simple HTML tags.")
  398. short_description: FilterTypeInput @doc(description: "A short description of the product. Its use depends on the theme.")
  399. price: FilterTypeInput @doc(description: "The price of an item")
  400. special_price: FilterTypeInput @doc(description: "The discounted price of the product")
  401. special_from_date: FilterTypeInput @doc(description: "The beginning date that a product has a special price")
  402. special_to_date: FilterTypeInput @doc(description: "The end date that a product has a special price")
  403. weight: FilterTypeInput @doc(description: "The weight of the item, in units defined by the store")
  404. manufacturer: FilterTypeInput @doc(description: "A number representing the product's manufacturer")
  405. meta_title: FilterTypeInput @doc(description: "A string that is displayed in the title bar and tab of the browser and in search results lists")
  406. meta_keyword: FilterTypeInput @doc(description: "A comma-separated list of keywords that are visible only to search engines")
  407. meta_description: FilterTypeInput @doc(description: "A brief overview of the product for search results listings, maximum 255 characters")
  408. image: FilterTypeInput @doc(description: "The relative path to the main image on the product page")
  409. small_image: FilterTypeInput @doc(description: "The relative path to the small image, which is used on catalog pages")
  410. thumbnail: FilterTypeInput @doc(description: "The relative path to the product's thumbnail image")
  411. tier_price: FilterTypeInput @doc(description: "The price when tier pricing is in effect and the items purchased threshold has been reached")
  412. news_from_date: FilterTypeInput @doc(description: "The beginning date for new product listings, and determines if the product is featured as a new product")
  413. news_to_date: FilterTypeInput @doc(description: "The end date for new product listings")
  414. custom_layout_update: FilterTypeInput @doc(description: "XML code that is applied as a layout update to the product page")
  415. min_price: FilterTypeInput @doc(description:"The numeric minimal price of the product. Do not include the currency code.")
  416. max_price: FilterTypeInput @doc(description:"The numeric maximal price of the product. Do not include the currency code.")
  417. special_price: FilterTypeInput @doc(description:"The numeric special price of the product. Do not include the currency code.")
  418. category_id: FilterTypeInput @doc(description: "Category ID the product belongs to")
  419. options_container: FilterTypeInput @doc(description: "If the product has multiple options, determines where they appear on the product page")
  420. required_options: FilterTypeInput @doc(description: "Indicates whether the product has required options")
  421. has_options: FilterTypeInput @doc(description: "Indicates whether additional attributes have been created for the product")
  422. image_label: FilterTypeInput @doc(description: "The label assigned to a product image")
  423. small_image_label: FilterTypeInput @doc(description: "The label assigned to a product's small image")
  424. thumbnail_label: FilterTypeInput @doc(description: "The label assigned to a product's thumbnail image")
  425. created_at: FilterTypeInput @doc(description: "Timestamp indicating when the product was created")
  426. updated_at: FilterTypeInput @doc(description: "Timestamp indicating when the product was updated")
  427. country_of_manufacture: FilterTypeInput @doc(description: "The product's country of origin")
  428. custom_layout: FilterTypeInput @doc(description: "The name of a custom layout")
  429. gift_message_available: FilterTypeInput @doc(description: "Indicates whether a gift message is available")
  430. or: ProductFilterInput @doc(description: "The keyword required to perform a logical OR comparison")
  431. }
  432. type ProductMediaGalleryEntriesContent @doc(description: "ProductMediaGalleryEntriesContent contains an image in base64 format and basic information about the image") {
  433. base64_encoded_data: String @doc(description: "The image in base64 format")
  434. type: String @doc(description: "The MIME type of the file, such as image/png")
  435. name: String @doc(description: "The file name of the image")
  436. }
  437. type ProductMediaGalleryEntriesVideoContent @doc(description: "ProductMediaGalleryEntriesVideoContent contains a link to a video file and basic information about the video") {
  438. media_type: String @doc(description: "Must be external-video")
  439. video_provider: String @doc(description: "Describes the video source")
  440. video_url: String @doc(description: "The URL to the video")
  441. video_title: String @doc(description: "The title of the video")
  442. video_description: String @doc(description: "A description of the video")
  443. video_metadata: String @doc(description: "Optional data about the video")
  444. }
  445. input ProductSortInput @doc(description: "ProductSortInput specifies the attribute to use for sorting search results and indicates whether the results are sorted in ascending or descending order") {
  446. name: SortEnum @doc(description: "The product name. Customers use this name to identify the product.")
  447. sku: SortEnum @doc(description: "A number or code assigned to a product to identify the product, options, price, and manufacturer")
  448. description: SortEnum @doc(description: "Detailed information about the product. The value can include simple HTML tags.")
  449. short_description: SortEnum @doc(description: "A short description of the product. Its use depends on the theme.")
  450. price: SortEnum @doc(description: "The price of the item")
  451. special_price: SortEnum @doc(description: "The discounted price of the product")
  452. special_from_date: SortEnum @doc(description: "The beginning date that a product has a special price")
  453. special_to_date: SortEnum @doc(description: "The end date that a product has a special price")
  454. weight: SortEnum @doc(description: "The weight of the item, in units defined by the store")
  455. manufacturer: SortEnum @doc(description: "A number representing the product's manufacturer")
  456. meta_title: SortEnum @doc(description: "A string that is displayed in the title bar and tab of the browser and in search results lists")
  457. meta_keyword: SortEnum @doc(description: "A comma-separated list of keywords that are visible only to search engines")
  458. meta_description: SortEnum @doc(description: "A brief overview of the product for search results listings, maximum 255 characters")
  459. image: SortEnum @doc(description: "The relative path to the main image on the product page")
  460. small_image: SortEnum @doc(description: "The relative path to the small image, which is used on catalog pages")
  461. thumbnail: SortEnum @doc(description: "The relative path to the product's thumbnail image")
  462. tier_price: SortEnum @doc(description: "The price when tier pricing is in effect and the items purchased threshold has been reached")
  463. news_from_date: SortEnum @doc(description: "The beginning date for new product listings, and determines if the product is featured as a new product")
  464. news_to_date: SortEnum @doc(description: "The end date for new product listings")
  465. custom_layout_update: SortEnum @doc(description: "XML code that is applied as a layout update to the product page")
  466. options_container: SortEnum @doc(description: "If the product has multiple options, determines where they appear on the product page")
  467. required_options: SortEnum @doc(description: "Indicates whether the product has required options")
  468. has_options: SortEnum @doc(description: "Indicates whether additional attributes have been created for the product")
  469. image_label: SortEnum @doc(description: "The label assigned to a product image")
  470. small_image_label: SortEnum @doc(description: "The label assigned to a product's small image")
  471. thumbnail_label: SortEnum @doc(description: "The label assigned to a product's thumbnail image")
  472. created_at: SortEnum @doc(description: "Timestamp indicating when the product was created")
  473. updated_at: SortEnum @doc(description: "Timestamp indicating when the product was updated")
  474. country_of_manufacture: SortEnum @doc(description: "The product's country of origin")
  475. custom_layout: SortEnum @doc(description: "The name of a custom layout")
  476. gift_message_available: SortEnum @doc(description: "Indicates whether a gift message is available")
  477. }
  478. type MediaGalleryEntry @doc(description: "MediaGalleryEntry defines characteristics about images and videos associated with a specific product") {
  479. id: Int @doc(description: "The identifier assigned to the object")
  480. media_type: String @doc(description: "image or video")
  481. label: String @doc(description: "The alt text displayed on the UI when the user points to the image")
  482. position: Int @doc(description: "The media item's position after it has been sorted")
  483. disabled: Boolean @doc(description: "Whether the image is hidden from vie")
  484. types: [String] @doc(description: "Array of image types. It can have the following values: image, small_image, thumbnail")
  485. file: String @doc(description: "The path of the image on the server")
  486. content: ProductMediaGalleryEntriesContent @doc(description: "Contains a ProductMediaGalleryEntriesContent object")
  487. video_content: ProductMediaGalleryEntriesVideoContent @doc(description: "Contains a ProductMediaGalleryEntriesVideoContent object")
  488. }
  489. type LayerFilter {
  490. name: String @doc(description: "Layered navigation filter name")
  491. request_var: String @doc(description: "Request variable name for filter query")
  492. filter_items_count: Int @doc(description: "Count of filter items in filter group")
  493. filter_items: [LayerFilterItemInterface] @doc(description: "Array of filter items")
  494. }
  495. interface LayerFilterItemInterface @typeResolver(class: "Magento\\CatalogGraphQl\\Model\\LayerFilterItemTypeResolverComposite") {
  496. label: String @doc(description: "Filter label")
  497. value_string: String @doc(description: "Value for filter request variable to be used in query")
  498. items_count: Int @doc(description: "Count of items by filter")
  499. }
  500. type LayerFilterItem implements LayerFilterItemInterface {
  501. }
  502. type SortField {
  503. value: String @doc(description: "Attribute code of sort field")
  504. label: String @doc(description: "Label of sort field")
  505. }
  506. type SortFields @doc(description: "SortFields contains a default value for sort fields and all available sort fields") {
  507. default: String @doc(description: "Default value of sort fields")
  508. options: [SortField] @doc(description: "Available sort fields")
  509. }