StoreConfig

Contains information about a store's configuration.

Fields

Field Name
Description
absolute_footer - String
Contains scripts that must be included in the HTML before the closing `<body>` tag.
allow_gift_receipt - String
Indicates if the gift sender has the option to send a gift receipt. Possible values: 1 (Yes) and 0 (No).
allow_gift_wrapping_on_order - String
Indicates whether gift wrapping can be added for the entire order. Possible values: 1 (Yes) and 0 (No).
allow_gift_wrapping_on_order_items - String
Indicates whether gift wrapping can be added for individual order items. Possible values: 1 (Yes) and 0 (No).
allow_guests_to_write_product_reviews - String
Indicates whether guest users can write product reviews. Possible values: 1 (Yes) and 0 (No).
allow_items - String
The value of the Allow Gift Messages for Order Items option
allow_order - String
The value of the Allow Gift Messages on Order Level option
allow_printed_card - String
Indicates if a printed card can accompany an order. Possible values: 1 (Yes) and 0 (No).
autocomplete_on_storefront - Boolean
Indicates whether to enable autocomplete on login and forgot password forms.
base_currency_code - String
The base currency code.
base_link_url - String
A fully-qualified URL that is used to create relative links to the `base_url`.
base_media_url - String
The fully-qualified URL that specifies the location of media files.
base_static_url - String
The fully-qualified URL that specifies the location of static view files.
base_url - String
The store’s fully-qualified base URL.
braintree_3dsecure_allowspecific - Boolean
Braintree 3D Secure, should 3D Secure be used for specific countries.
braintree_3dsecure_always_request_3ds - Boolean
Braintree 3D Secure, always request 3D Secure flag.
braintree_3dsecure_specificcountry - String
Braintree 3D Secure, the specific countries to use 3D Secure in, to be used if allow specific is status is enabled.
braintree_3dsecure_threshold_amount - String
Braintree 3D Secure, threshold above which 3D Secure should be requested.
braintree_3dsecure_verify_3dsecure - Boolean
Braintree 3D Secure enabled/active status.
braintree_ach_direct_debit_vault_active - Boolean
Braintree ACH vault status.
braintree_applepay_merchant_name - String
Braintree Apple Pay merchant name.
braintree_applepay_vault_active - Boolean
Braintree Apple Pay vault status.
braintree_cc_vault_active - String
Braintree cc vault status.
braintree_cc_vault_cvv - Boolean
Braintree cc vault CVV re-verification enabled status.
braintree_environment - String
Braintree environment.
braintree_googlepay_btn_color - String
Braintree Google Pay button color.
braintree_googlepay_cctypes - String
Braintree Google Pay Card types supported.
braintree_googlepay_merchant_id - String
Braintree Google Pay merchant ID.
braintree_googlepay_vault_active - Boolean
Braintree Google Pay vault status.
braintree_local_payment_allowed_methods - String
Braintree Local Payment Methods allowed payment methods.
braintree_local_payment_fallback_button_text - String
Braintree Local Payment Methods fallback button text.
braintree_local_payment_redirect_on_fail - String
Braintree Local Payment Methods redirect URL on failed payment.
braintree_merchant_account_id - String
Braintree Merchant Account ID.
braintree_paypal_button_location_cart_type_credit_color - String
Braintree PayPal Credit mini-cart & cart button style color.
braintree_paypal_button_location_cart_type_credit_label - String
Braintree PayPal Credit mini-cart & cart button style label.
braintree_paypal_button_location_cart_type_credit_shape - String
Braintree PayPal Credit mini-cart & cart button style shape.
braintree_paypal_button_location_cart_type_credit_show - Boolean
Braintree PayPal Credit mini-cart & cart button show status.
braintree_paypal_button_location_cart_type_messaging_layout - String
Braintree PayPal Pay Later messaging mini-cart & cart style layout.
braintree_paypal_button_location_cart_type_messaging_logo - String
Braintree PayPal Pay Later messaging mini-cart & cart style logo.
braintree_paypal_button_location_cart_type_messaging_logo_position - String
Braintree PayPal Pay Later messaging mini-cart & cart style logo position.
braintree_paypal_button_location_cart_type_messaging_show - Boolean
Braintree PayPal Pay Later messaging mini-cart & cart show status.
braintree_paypal_button_location_cart_type_messaging_text_color - String
Braintree PayPal Pay Later messaging checkout style text color.
braintree_paypal_button_location_cart_type_paylater_color - String
Braintree PayPal Pay Later mini-cart & cart button style color.
braintree_paypal_button_location_cart_type_paylater_label - String
Braintree PayPal Pay Later mini-cart & cart button style label.
braintree_paypal_button_location_cart_type_paylater_shape - String
Braintree PayPal Pay Later mini-cart & cart button style shape.
braintree_paypal_button_location_cart_type_paylater_show - Boolean
Braintree PayPal Pay Later mini-cart & cart button show status.
braintree_paypal_button_location_cart_type_paypal_color - String
Braintree PayPal mini-cart & cart button style color.
braintree_paypal_button_location_cart_type_paypal_label - String
Braintree PayPal mini-cart & cart button style label.
braintree_paypal_button_location_cart_type_paypal_shape - String
Braintree PayPal mini-cart & cart button style shape.
braintree_paypal_button_location_cart_type_paypal_show - Boolean
Braintree PayPal mini-cart & cart button show.
braintree_paypal_button_location_checkout_type_credit_color - String
Braintree PayPal Credit checkout button style color.
braintree_paypal_button_location_checkout_type_credit_label - String
Braintree PayPal Credit checkout button style label.
braintree_paypal_button_location_checkout_type_credit_shape - String
Braintree PayPal Credit checkout button style shape.
braintree_paypal_button_location_checkout_type_credit_show - Boolean
Braintree PayPal Credit checkout button show status.
braintree_paypal_button_location_checkout_type_messaging_layout - String
Braintree PayPal Pay Later messaging checkout style layout.
braintree_paypal_button_location_checkout_type_messaging_logo - String
Braintree PayPal Pay Later messaging checkout style logo.
braintree_paypal_button_location_checkout_type_messaging_logo_position - String
Braintree PayPal Pay Later messaging checkout style logo position.
braintree_paypal_button_location_checkout_type_messaging_show - Boolean
Braintree PayPal Pay Later messaging checkout show status.
braintree_paypal_button_location_checkout_type_messaging_text_color - String
Braintree PayPal Pay Later messaging checkout style text color.
braintree_paypal_button_location_checkout_type_paylater_color - String
Braintree PayPal Pay Later checkout button style color.
braintree_paypal_button_location_checkout_type_paylater_label - String
Braintree PayPal Pay Later checkout button style label.
braintree_paypal_button_location_checkout_type_paylater_shape - String
Braintree PayPal Pay Later checkout button style shape.
braintree_paypal_button_location_checkout_type_paylater_show - Boolean
Braintree PayPal Pay Later checkout button show status.
braintree_paypal_button_location_checkout_type_paypal_color - String
Braintree PayPal checkout button style color.
braintree_paypal_button_location_checkout_type_paypal_label - String
Braintree PayPal checkout button style label.
braintree_paypal_button_location_checkout_type_paypal_shape - String
Braintree PayPal checkout button style shape.
braintree_paypal_button_location_checkout_type_paypal_show - Boolean
Braintree PayPal checkout button show.
braintree_paypal_button_location_productpage_type_credit_color - String
Braintree PayPal Credit PDP button style color.
braintree_paypal_button_location_productpage_type_credit_label - String
Braintree PayPal Credit PDP button style label.
braintree_paypal_button_location_productpage_type_credit_shape - String
Braintree PayPal Credit PDP button style shape.
braintree_paypal_button_location_productpage_type_credit_show - Boolean
Braintree PayPal Credit PDP button show status.
braintree_paypal_button_location_productpage_type_messaging_layout - String
Braintree PayPal Pay Later messaging PDP style layout.
braintree_paypal_button_location_productpage_type_messaging_logo - String
Braintree PayPal Pay Later messaging PDP style logo.
braintree_paypal_button_location_productpage_type_messaging_logo_position - String
Braintree PayPal Pay Later messaging PDP style logo position.
braintree_paypal_button_location_productpage_type_messaging_show - Boolean
Braintree PayPal Pay Later messaging PDP show status.
braintree_paypal_button_location_productpage_type_messaging_text_color - String
Braintree PayPal Pay Later messaging PDP style text color.
braintree_paypal_button_location_productpage_type_paylater_color - String
Braintree PayPal Pay Later PDP button style color.
braintree_paypal_button_location_productpage_type_paylater_label - String
Braintree PayPal Pay Later PDP button style label.
braintree_paypal_button_location_productpage_type_paylater_shape - String
Braintree PayPal Pay Later PDP button style shape.
braintree_paypal_button_location_productpage_type_paylater_show - Boolean
Braintree PayPal Pay Later PDP button show status.
braintree_paypal_button_location_productpage_type_paypal_color - String
Braintree PayPal PDP button style color.
braintree_paypal_button_location_productpage_type_paypal_label - String
Braintree PayPal PDP button style label.
braintree_paypal_button_location_productpage_type_paypal_shape - String
Braintree PayPal PDP button style shape.
braintree_paypal_button_location_productpage_type_paypal_show - Boolean
Braintree PayPal PDP button show.
braintree_paypal_credit_uk_merchant_name - String
Braintree PayPal Credit Merchant Name on the FCA Register.
braintree_paypal_display_on_shopping_cart - Boolean
Should display Braintree PayPal in mini-cart & cart?
braintree_paypal_merchant_country - String
Braintree PayPal merchant's country.
braintree_paypal_merchant_name_override - String
Braintree PayPal override for Merchant Name.
braintree_paypal_require_billing_address - Boolean
Does Braintree PayPal require the customer's billing address?
braintree_paypal_send_cart_line_items - Boolean
Does Braintree PayPal require the order line items?
braintree_paypal_vault_active - Boolean
Braintree PayPal vault status.
cart_expires_in_days - Int
Extended Config Data - checkout/cart/delete_quote_after
cart_gift_wrapping - String
Indicates if gift wrapping prices are displayed on the Shopping Cart page. Possible values: 1 (Yes) and 0 (No).
cart_printed_card - String
Indicates if printed card prices are displayed on the Shopping Cart page. Possible values: 1 (Yes) and 0 (No).
cart_summary_display_quantity - Int
Extended Config Data - checkout/cart_link/use_qty
catalog_default_sort_by - String
The default sort order of the search results list.
category_fixed_product_tax_display_setting - FixedProductTaxDisplaySettings
Corresponds to the 'Display Prices In Product Lists' field in the Admin. It indicates how FPT information is displayed on category pages.
category_url_suffix - String
The suffix applied to category pages, such as `.htm` or `.html`.
check_money_order_enable_for_specific_countries - Boolean
Indicates whether only specific countries can use this payment method.
check_money_order_enabled - Boolean
Indicates whether the Check/Money Order payment method is enabled.
check_money_order_make_check_payable_to - String
The name of the party to whom the check must be payable.
check_money_order_max_order_total - String
The maximum order amount required to qualify for the Check/Money Order payment method.
check_money_order_min_order_total - String
The minimum order amount required to qualify for the Check/Money Order payment method.
check_money_order_new_order_status - String
The status of new orders placed using the Check/Money Order payment method.
check_money_order_payment_from_specific_countries - String
A comma-separated list of specific countries allowed to use the Check/Money Order payment method.
check_money_order_send_check_to - String
The full street address or PO Box where the checks are mailed.
check_money_order_sort_order - Int
A number indicating the position of the Check/Money Order payment method in the list of available payment methods during checkout.
check_money_order_title - String
The title of the Check/Money Order payment method displayed on the storefront.
cms_home_page - String
The name of the CMS page that identifies the home page for the store.
cms_no_cookies - String
A specific CMS page that displays when cookies are not enabled for the browser.
cms_no_route - String
A specific CMS page that displays when a 404 'Page Not Found' error occurs.
code - String
A code assigned to the store to identify it. (Deprecated: Use `store_code` instead.)
configurable_thumbnail_source - String
Indicates whether the `parent` or child (`itself`) thumbnail should be used in the cart for configurable products.
contact_enabled - Boolean!
Indicates whether the Contact Us form in enabled.
copyright - String
The copyright statement that appears at the bottom of each page.
countries_with_required_region - String
Extended Config Data - general/region/state_required
create_account_confirmation - Boolean
Indicates if the new accounts need confirmation.
customer_access_token_lifetime - Float
Customer access token lifetime.
default_country - String
Extended Config Data - general/country/default
default_description - String
The description that provides a summary of your site for search engine listings. It should not be more than 160 characters in length.
default_display_currency_code - String
The default display currency code.
default_keywords - String
A series of keywords that describe your store, each separated by a comma.
default_title - String
The title that appears at the title bar of each page when viewed in a browser.
demonotice - Int
Controls the display of the demo store notice at the top of the page. Options: 0 (No) or 1 (Yes).
display_state_if_optional - Boolean
Extended Config Data - general/region/display_all
enable_multiple_wishlists - String
Indicates whether customers can have multiple wish lists. Possible values: 1 (Yes) and 0 (No).
front - String
The landing page that is associated with the base URL.
grid_per_page - Int
The default number of products per page in Grid View.
grid_per_page_values - String
A list of numbers that define how many products can be displayed in Grid View.
head_includes - String
Scripts that must be included in the HTML before the closing `<head>` tag.
head_shortcut_icon - String
The small graphic image (favicon) that appears in the address bar and tab of the browser.
header_logo_src - String
The path to the logo that appears in the header.
id - Int
The ID number assigned to the store. (Deprecated: Use `store_code` instead.)
is_default_store - Boolean
Indicates whether the store view has been designated as the default within the store group.
is_default_store_group - Boolean
Indicates whether the store group has been designated as the default within the website.
is_guest_checkout_enabled - Boolean
Extended Config Data - checkout/options/guest_checkout
is_negotiable_quote_active - Boolean
Indicates whether negotiable quote functionality is enabled.
is_one_page_checkout_enabled - Boolean
Extended Config Data - checkout/options/onepage_checkout_enabled
is_requisition_list_active - String
Indicates whether requisition lists are enabled. Possible values: 1 (Yes) and 0 (No).
list_mode - String
The format of the search results list.
list_per_page - Int
The default number of products per page in List View.
list_per_page_values - String
A list of numbers that define how many products can be displayed in List View.
locale - String
The store locale.
logo_alt - String
The Alt text that is associated with the logo.
logo_height - Int
The height of the logo image, in pixels.
logo_width - Int
The width of the logo image, in pixels.
magento_reward_general_is_enabled - String
Indicates whether reward points functionality is enabled. Possible values: 1 (Enabled) and 0 (Disabled).
magento_reward_general_is_enabled_on_front - String
Indicates whether reward points functionality is enabled on the storefront. Possible values: 1 (Enabled) and 0 (Disabled).
magento_reward_general_min_points_balance - String
The minimum point balance customers must have before they can redeem them. A null value indicates no minimum.
magento_reward_general_publish_history - String
When enabled, customers can see a detailed history of their reward points. Possible values: 1 (Enabled) and 0 (Disabled).
magento_reward_points_invitation_customer - String
The number of points for a referral when an invitee registers on the site.
magento_reward_points_invitation_customer_limit - String
The maximum number of registration referrals that will qualify for rewards. A null value indicates no limit.
magento_reward_points_invitation_order - String
The number of points for a referral, when an invitee places their first order on the site.
magento_reward_points_invitation_order_limit - String
The number of order conversions that can earn points for the customer who sends the invitation. A null value indicates no limit.
magento_reward_points_newsletter - String
The number of points earned by registered customers who subscribe to a newsletter.
magento_reward_points_order - String
Indicates customers earn points for shopping according to the reward point exchange rate. In Luma, this also controls whether to show a message in the shopping cart about the rewards points earned for the purchase, as well as the customer’s current reward point balance.
magento_reward_points_register - String
The number of points customer gets for registering.
magento_reward_points_review - String
The number of points for writing a review.
magento_reward_points_review_limit - String
The maximum number of reviews that will qualify for the rewards. A null value indicates no limit.
magento_wishlist_general_is_enabled - String
Indicates whether wishlists are enabled (1) or disabled (0).
max_items_in_order_summary - Int
Extended Config Data - checkout/options/max_items_display_count
maximum_number_of_wishlists - String
If multiple wish lists are enabled, the maximum number of wish lists the customer can have.
minicart_display - Boolean
Extended Config Data - checkout/sidebar/display
minicart_max_items - Int
Extended Config Data - checkout/sidebar/count
minimum_password_length - String
The minimum number of characters required for a valid password.
newsletter_enabled - Boolean!
Indicates whether newsletters are enabled.
no_route - String
The default page that displays when a 404 'Page not Found' error occurs.
optional_zip_countries - String
Extended Config Data - general/country/optional_zip_countries
order_cancellation_enabled - Boolean!
Indicates whether orders can be cancelled by customers or not.
order_cancellation_reasons - [CancellationReason]!
An array containing available cancellation reasons.
payment_payflowpro_cc_vault_active - String
Payflow Pro vault status.
printed_card_price - String
The default price of a printed card that accompanies an order.
product_fixed_product_tax_display_setting - FixedProductTaxDisplaySettings
Corresponds to the 'Display Prices On Product View Page' field in the Admin. It indicates how FPT information is displayed on product pages.
product_reviews_enabled - String
Indicates whether product reviews are enabled. Possible values: 1 (Yes) and 0 (No).
product_url_suffix - String
The suffix applied to product pages, such as `.htm` or `.html`.
quickorder_active - Boolean!
Indicates whether quick order functionality is enabled.
required_character_classes_number - String
The number of different character classes (lowercase, uppercase, digits, special characters) required in a password.
returns_enabled - String!
Indicates whether RMA is enabled on the storefront. Possible values: enabled/disabled.
root_category_id - Int
The ID of the root category. (Deprecated: Use `root_category_uid` instead.)
root_category_uid - ID
The unique ID for a `CategoryInterface` object.
sales_fixed_product_tax_display_setting - FixedProductTaxDisplaySettings
Corresponds to the 'Display Prices In Sales Modules' field in the Admin. It indicates how FPT information is displayed on cart, checkout, and order pages.
sales_gift_wrapping - String
Indicates if gift wrapping prices are displayed on the Orders page. Possible values: 1 (Yes) and 0 (No).
sales_printed_card - String
Indicates if printed card prices are displayed on the Orders page. Possible values: 1 (Yes) and 0 (No).
secure_base_link_url - String
A secure fully-qualified URL that is used to create relative links to the `base_url`.
secure_base_media_url - String
The secure fully-qualified URL that specifies the location of media files.
secure_base_static_url - String
The secure fully-qualified URL that specifies the location of static view files.
secure_base_url - String
The store’s fully-qualified secure base URL.
send_friend - SendFriendConfiguration
Email to a Friend configuration.
shopping_cart_display_full_summary - Boolean
Extended Config Data - tax/cart_display/full_summary
shopping_cart_display_grand_total - Boolean
Extended Config Data - tax/cart_display/grandtotal
shopping_cart_display_price - Int
Extended Config Data - tax/cart_display/price
shopping_cart_display_shipping - Int
Extended Config Data - tax/cart_display/shipping
shopping_cart_display_subtotal - Int
Extended Config Data - tax/cart_display/subtotal
shopping_cart_display_tax_gift_wrapping - TaxWrappingEnum
Extended Config Data - tax/cart_display/gift_wrapping
shopping_cart_display_zero_tax - Boolean
Extended Config Data - tax/cart_display/zero_tax
show_cms_breadcrumbs - Int
Indicates whether a breadcrumb trail appears on all CMS pages in the catalog. 0 (No) or 1 (Yes).
store_code - ID
The unique ID of the store view. In the Admin, this is called the Store View Code. When making a GraphQL call, assign this value to the `Store` header to provide the scope.
store_group_code - ID
The unique ID assigned to the store group. In the Admin, this is called the Store Name.
store_group_name - String
The label assigned to the store group.
store_name - String
The label assigned to the store view.
store_sort_order - Int
The store view sort order.
timezone - String
The time zone of the store.
title_prefix - String
A prefix that appears before the title to create a two- or three-part title.
title_separator - String
The character that separates the category name and subcategory in the browser title bar.
title_suffix - String
A suffix that appears after the title to create a two- or three-part title.
use_store_in_url - Boolean
Indicates whether the store code should be used in the URL.
website_code - ID
The unique ID for the website.
website_id - Int
The ID number assigned to the website store. (Deprecated: The field should not be used on the storefront.)
website_name - String
The label assigned to the website.
weight_unit - String
The unit of weight.
welcome - String
Text that appears in the header of the page and includes the name of the logged in customer.
zero_subtotal_enable_for_specific_countries - Boolean
Indicates whether only specific countries can use this payment method.
zero_subtotal_enabled - Boolean
Indicates whether the Zero Subtotal payment method is enabled.
zero_subtotal_new_order_status - String
The status of new orders placed using the Zero Subtotal payment method.
zero_subtotal_payment_action - String
When the new order status is 'Processing', this can be set to `authorize_capture` to automatically invoice all items that have a zero balance.
zero_subtotal_payment_from_specific_countries - String
A comma-separated list of specific countries allowed to use the Zero Subtotal payment method.
zero_subtotal_sort_order - Int
A number indicating the position of the Zero Subtotal payment method in the list of available payment methods during checkout.
zero_subtotal_title - String
The title of the Zero Subtotal payment method displayed on the storefront.

Example

{
  "absolute_footer": "xyz789",
  "allow_gift_receipt": "abc123",
  "allow_gift_wrapping_on_order": "abc123",
  "allow_gift_wrapping_on_order_items": "abc123",
  "allow_guests_to_write_product_reviews": "xyz789",
  "allow_items": "xyz789",
  "allow_order": "abc123",
  "allow_printed_card": "abc123",
  "autocomplete_on_storefront": true,
  "base_currency_code": "xyz789",
  "base_link_url": "xyz789",
  "base_media_url": "xyz789",
  "base_static_url": "abc123",
  "base_url": "xyz789",
  "braintree_3dsecure_allowspecific": false,
  "braintree_3dsecure_always_request_3ds": false,
  "braintree_3dsecure_specificcountry": "abc123",
  "braintree_3dsecure_threshold_amount": "abc123",
  "braintree_3dsecure_verify_3dsecure": false,
  "braintree_ach_direct_debit_vault_active": false,
  "braintree_applepay_merchant_name": "xyz789",
  "braintree_applepay_vault_active": false,
  "braintree_cc_vault_active": "abc123",
  "braintree_cc_vault_cvv": true,
  "braintree_environment": "xyz789",
  "braintree_googlepay_btn_color": "xyz789",
  "braintree_googlepay_cctypes": "xyz789",
  "braintree_googlepay_merchant_id": "xyz789",
  "braintree_googlepay_vault_active": true,
  "braintree_local_payment_allowed_methods": "xyz789",
  "braintree_local_payment_fallback_button_text": "xyz789",
  "braintree_local_payment_redirect_on_fail": "abc123",
  "braintree_merchant_account_id": "xyz789",
  "braintree_paypal_button_location_cart_type_credit_color": "xyz789",
  "braintree_paypal_button_location_cart_type_credit_label": "xyz789",
  "braintree_paypal_button_location_cart_type_credit_shape": "xyz789",
  "braintree_paypal_button_location_cart_type_credit_show": false,
  "braintree_paypal_button_location_cart_type_messaging_layout": "xyz789",
  "braintree_paypal_button_location_cart_type_messaging_logo": "abc123",
  "braintree_paypal_button_location_cart_type_messaging_logo_position": "abc123",
  "braintree_paypal_button_location_cart_type_messaging_show": false,
  "braintree_paypal_button_location_cart_type_messaging_text_color": "abc123",
  "braintree_paypal_button_location_cart_type_paylater_color": "abc123",
  "braintree_paypal_button_location_cart_type_paylater_label": "xyz789",
  "braintree_paypal_button_location_cart_type_paylater_shape": "xyz789",
  "braintree_paypal_button_location_cart_type_paylater_show": true,
  "braintree_paypal_button_location_cart_type_paypal_color": "xyz789",
  "braintree_paypal_button_location_cart_type_paypal_label": "abc123",
  "braintree_paypal_button_location_cart_type_paypal_shape": "abc123",
  "braintree_paypal_button_location_cart_type_paypal_show": false,
  "braintree_paypal_button_location_checkout_type_credit_color": "abc123",
  "braintree_paypal_button_location_checkout_type_credit_label": "xyz789",
  "braintree_paypal_button_location_checkout_type_credit_shape": "abc123",
  "braintree_paypal_button_location_checkout_type_credit_show": false,
  "braintree_paypal_button_location_checkout_type_messaging_layout": "abc123",
  "braintree_paypal_button_location_checkout_type_messaging_logo": "abc123",
  "braintree_paypal_button_location_checkout_type_messaging_logo_position": "abc123",
  "braintree_paypal_button_location_checkout_type_messaging_show": true,
  "braintree_paypal_button_location_checkout_type_messaging_text_color": "xyz789",
  "braintree_paypal_button_location_checkout_type_paylater_color": "abc123",
  "braintree_paypal_button_location_checkout_type_paylater_label": "abc123",
  "braintree_paypal_button_location_checkout_type_paylater_shape": "xyz789",
  "braintree_paypal_button_location_checkout_type_paylater_show": false,
  "braintree_paypal_button_location_checkout_type_paypal_color": "xyz789",
  "braintree_paypal_button_location_checkout_type_paypal_label": "abc123",
  "braintree_paypal_button_location_checkout_type_paypal_shape": "abc123",
  "braintree_paypal_button_location_checkout_type_paypal_show": true,
  "braintree_paypal_button_location_productpage_type_credit_color": "xyz789",
  "braintree_paypal_button_location_productpage_type_credit_label": "abc123",
  "braintree_paypal_button_location_productpage_type_credit_shape": "xyz789",
  "braintree_paypal_button_location_productpage_type_credit_show": false,
  "braintree_paypal_button_location_productpage_type_messaging_layout": "abc123",
  "braintree_paypal_button_location_productpage_type_messaging_logo": "abc123",
  "braintree_paypal_button_location_productpage_type_messaging_logo_position": "abc123",
  "braintree_paypal_button_location_productpage_type_messaging_show": false,
  "braintree_paypal_button_location_productpage_type_messaging_text_color": "abc123",
  "braintree_paypal_button_location_productpage_type_paylater_color": "abc123",
  "braintree_paypal_button_location_productpage_type_paylater_label": "abc123",
  "braintree_paypal_button_location_productpage_type_paylater_shape": "xyz789",
  "braintree_paypal_button_location_productpage_type_paylater_show": false,
  "braintree_paypal_button_location_productpage_type_paypal_color": "xyz789",
  "braintree_paypal_button_location_productpage_type_paypal_label": "abc123",
  "braintree_paypal_button_location_productpage_type_paypal_shape": "abc123",
  "braintree_paypal_button_location_productpage_type_paypal_show": true,
  "braintree_paypal_credit_uk_merchant_name": "xyz789",
  "braintree_paypal_display_on_shopping_cart": true,
  "braintree_paypal_merchant_country": "abc123",
  "braintree_paypal_merchant_name_override": "abc123",
  "braintree_paypal_require_billing_address": true,
  "braintree_paypal_send_cart_line_items": false,
  "braintree_paypal_vault_active": true,
  "cart_expires_in_days": 123,
  "cart_gift_wrapping": "xyz789",
  "cart_printed_card": "xyz789",
  "cart_summary_display_quantity": 123,
  "catalog_default_sort_by": "abc123",
  "category_fixed_product_tax_display_setting": "INCLUDE_FPT_WITHOUT_DETAILS",
  "category_url_suffix": "xyz789",
  "check_money_order_enable_for_specific_countries": true,
  "check_money_order_enabled": true,
  "check_money_order_make_check_payable_to": "abc123",
  "check_money_order_max_order_total": "abc123",
  "check_money_order_min_order_total": "xyz789",
  "check_money_order_new_order_status": "xyz789",
  "check_money_order_payment_from_specific_countries": "xyz789",
  "check_money_order_send_check_to": "abc123",
  "check_money_order_sort_order": 987,
  "check_money_order_title": "abc123",
  "cms_home_page": "xyz789",
  "cms_no_cookies": "xyz789",
  "cms_no_route": "abc123",
  "code": "abc123",
  "configurable_thumbnail_source": "xyz789",
  "contact_enabled": true,
  "copyright": "xyz789",
  "countries_with_required_region": "abc123",
  "create_account_confirmation": true,
  "customer_access_token_lifetime": 123.45,
  "default_country": "abc123",
  "default_description": "xyz789",
  "default_display_currency_code": "abc123",
  "default_keywords": "xyz789",
  "default_title": "abc123",
  "demonotice": 987,
  "display_state_if_optional": true,
  "enable_multiple_wishlists": "xyz789",
  "front": "abc123",
  "grid_per_page": 987,
  "grid_per_page_values": "abc123",
  "head_includes": "xyz789",
  "head_shortcut_icon": "abc123",
  "header_logo_src": "xyz789",
  "id": 987,
  "is_default_store": false,
  "is_default_store_group": true,
  "is_guest_checkout_enabled": true,
  "is_negotiable_quote_active": false,
  "is_one_page_checkout_enabled": true,
  "is_requisition_list_active": "abc123",
  "list_mode": "xyz789",
  "list_per_page": 987,
  "list_per_page_values": "abc123",
  "locale": "xyz789",
  "logo_alt": "abc123",
  "logo_height": 987,
  "logo_width": 123,
  "magento_reward_general_is_enabled": "abc123",
  "magento_reward_general_is_enabled_on_front": "xyz789",
  "magento_reward_general_min_points_balance": "xyz789",
  "magento_reward_general_publish_history": "abc123",
  "magento_reward_points_invitation_customer": "abc123",
  "magento_reward_points_invitation_customer_limit": "abc123",
  "magento_reward_points_invitation_order": "abc123",
  "magento_reward_points_invitation_order_limit": "abc123",
  "magento_reward_points_newsletter": "xyz789",
  "magento_reward_points_order": "abc123",
  "magento_reward_points_register": "abc123",
  "magento_reward_points_review": "xyz789",
  "magento_reward_points_review_limit": "xyz789",
  "magento_wishlist_general_is_enabled": "xyz789",
  "max_items_in_order_summary": 123,
  "maximum_number_of_wishlists": "abc123",
  "minicart_display": false,
  "minicart_max_items": 123,
  "minimum_password_length": "xyz789",
  "newsletter_enabled": true,
  "no_route": "xyz789",
  "optional_zip_countries": "xyz789",
  "order_cancellation_enabled": false,
  "order_cancellation_reasons": [CancellationReason],
  "payment_payflowpro_cc_vault_active": "xyz789",
  "printed_card_price": "abc123",
  "product_fixed_product_tax_display_setting": "INCLUDE_FPT_WITHOUT_DETAILS",
  "product_reviews_enabled": "xyz789",
  "product_url_suffix": "xyz789",
  "quickorder_active": true,
  "required_character_classes_number": "abc123",
  "returns_enabled": "abc123",
  "root_category_id": 987,
  "root_category_uid": 4,
  "sales_fixed_product_tax_display_setting": "INCLUDE_FPT_WITHOUT_DETAILS",
  "sales_gift_wrapping": "abc123",
  "sales_printed_card": "xyz789",
  "secure_base_link_url": "xyz789",
  "secure_base_media_url": "xyz789",
  "secure_base_static_url": "xyz789",
  "secure_base_url": "xyz789",
  "send_friend": SendFriendConfiguration,
  "shopping_cart_display_full_summary": true,
  "shopping_cart_display_grand_total": true,
  "shopping_cart_display_price": 123,
  "shopping_cart_display_shipping": 987,
  "shopping_cart_display_subtotal": 123,
  "shopping_cart_display_tax_gift_wrapping": "DISPLAY_EXCLUDING_TAX",
  "shopping_cart_display_zero_tax": false,
  "show_cms_breadcrumbs": 123,
  "store_code": "4",
  "store_group_code": 4,
  "store_group_name": "xyz789",
  "store_name": "abc123",
  "store_sort_order": 987,
  "timezone": "abc123",
  "title_prefix": "xyz789",
  "title_separator": "abc123",
  "title_suffix": "abc123",
  "use_store_in_url": false,
  "website_code": 4,
  "website_id": 987,
  "website_name": "abc123",
  "weight_unit": "abc123",
  "welcome": "abc123",
  "zero_subtotal_enable_for_specific_countries": false,
  "zero_subtotal_enabled": false,
  "zero_subtotal_new_order_status": "xyz789",
  "zero_subtotal_payment_action": "xyz789",
  "zero_subtotal_payment_from_specific_countries": "xyz789",
  "zero_subtotal_sort_order": 123,
  "zero_subtotal_title": "xyz789"
}

StorefrontProperties

Indicates where an attribute can be displayed.

Fields

Field Name
Description
position - Int
The relative position of the attribute in the layered navigation block.
use_in_layered_navigation - UseInLayeredNavigationOptions
Indicates whether the attribute is filterable with results, without results, or not at all.
use_in_product_listing - Boolean
Indicates whether the attribute is displayed in product listings.
use_in_search_results_layered_navigation - Boolean
Indicates whether the attribute can be used in layered navigation on search results pages.
visible_on_catalog_pages - Boolean
Indicates whether the attribute is displayed on product pages.

Example

{
  "position": 123,
  "use_in_layered_navigation": "NO",
  "use_in_product_listing": true,
  "use_in_search_results_layered_navigation": true,
  "visible_on_catalog_pages": true
}

String

The String scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.

Example

"xyz789"

SubmitNegotiableQuoteTemplateForReviewInput

Specifies the quote template properties to update.

Input Fields

Input Field
Description
comment - String
A comment for the seller to review.
max_order_commitment - Int
Commitment for maximum orders
min_order_commitment - Int
Commitment for minimum orders
name - String
The title assigned to the negotiable quote template.
template_id - ID!
The unique ID of a `NegotiableQuoteTemplate` object.

Example

{
  "comment": "xyz789",
  "max_order_commitment": 123,
  "min_order_commitment": 987,
  "name": "abc123",
  "template_id": 4
}

SubscribeEmailToNewsletterOutput

Contains the result of the subscribeEmailToNewsletter operation.

Fields

Field Name
Description
status - SubscriptionStatusesEnum
The status of the subscription request.

Example

{"status": "NOT_ACTIVE"}

SubscriptionStatusesEnum

Indicates the status of the request.

Values

Enum Value
Description
NOT_ACTIVE
SUBSCRIBED
UNSUBSCRIBED
UNCONFIRMED

Example

""NOT_ACTIVE""

SwatchData

Describes the swatch type and a value.

Fields

Field Name
Description
type - String
The type of swatch filter item: 1 - text; 2 - image.
value - String
The value for the swatch item. It could be text or an image link.

Example

{
  "type": "abc123",
  "value": "abc123"
}

SwatchDataInterface

Fields

Field Name
Description
value - String
The value can be represented as color (HEX code), image link, or text.

Possible Types

SwatchDataInterface Types
ImageSwatchData
TextSwatchData
ColorSwatchData

Example

{"value": "abc123"}

SwatchInputTypeEnum

Swatch attribute metadata input types.

Values

Enum Value
Description
BOOLEAN
DATE
DATETIME
DROPDOWN
FILE
GALLERY
HIDDEN
IMAGE
MEDIA_IMAGE
MULTILINE
MULTISELECT
PRICE
SELECT
TEXT
TEXTAREA
UNDEFINED
VISUAL
WEIGHT

Example

""BOOLEAN""

SwatchLayerFilterItem

Fields

Field Name
Description
items_count - Int
The count of items per filter. (Deprecated: Use `AggregationOption.count` instead.)
label - String
The label for a filter. (Deprecated: Use `AggregationOption.label` instead.)
swatch_data - SwatchData
Data required to render a swatch filter item.
value_string - String
The value of a filter request variable to be used in query. (Deprecated: Use `AggregationOption.value` instead.)

Example

{
  "items_count": 123,
  "label": "xyz789",
  "swatch_data": SwatchData,
  "value_string": "xyz789"
}

SwatchLayerFilterItemInterface

Fields

Field Name
Description
swatch_data - SwatchData
Data required to render a swatch filter item.

Possible Types

SwatchLayerFilterItemInterface Types
SwatchLayerFilterItem

Example

{"swatch_data": SwatchData}

SyncPaymentOrderInput

Synchronizes the payment order details

Input Fields

Input Field
Description
cartId - String!
The customer cart ID
id - String!
PayPal order ID

Example

{
  "cartId": "abc123",
  "id": "abc123"
}

TaxItem

Contains tax item details.

Fields

Field Name
Description
amount - Money!
The amount of tax applied to the item.
rate - Float!
The rate used to calculate the tax.
title - String!
A title that describes the tax.

Example

{
  "amount": Money,
  "rate": 987.65,
  "title": "xyz789"
}

TaxWrappingEnum

Values

Enum Value
Description
DISPLAY_EXCLUDING_TAX
DISPLAY_INCLUDING_TAX
DISPLAY_TYPE_BOTH

Example

""DISPLAY_EXCLUDING_TAX""

TextSwatchData

Fields

Field Name
Description
value - String
The value can be represented as color (HEX code), image link, or text.

Example

{"value": "abc123"}

TierPrice

Defines a price based on the quantity purchased.

Fields

Field Name
Description
discount - ProductDiscount
The price discount that this tier represents.
final_price - Money
The price of the product at this tier.
quantity - Float
The minimum number of items that must be purchased to qualify for this price tier.

Example

{
  "discount": ProductDiscount,
  "final_price": Money,
  "quantity": 987.65
}

UpdateCartItemsInput

Modifies the specified items in the cart.

Input Fields

Input Field
Description
cart_id - String!
The unique ID of a `Cart` object.
cart_items - [CartItemUpdateInput]!
An array of items to be updated.

Example

{
  "cart_id": "abc123",
  "cart_items": [CartItemUpdateInput]
}

UpdateCartItemsOutput

Contains details about the cart after updating items.

Fields

Field Name
Description
cart - Cart!
The cart after updating products.

Example

{"cart": Cart}

UpdateCompanyOutput

Contains the response to the request to update the company.

Fields

Field Name
Description
company - Company!
The updated company instance.

Example

{"company": Company}

UpdateCompanyRoleOutput

Contains the response to the request to update the company role.

Fields

Field Name
Description
role - CompanyRole!
The updated company role instance.

Example

{"role": CompanyRole}

UpdateCompanyStructureOutput

Contains the response to the request to update the company structure.

Fields

Field Name
Description
company - Company!
The updated company instance.

Example

{"company": Company}

UpdateCompanyTeamOutput

Contains the response to the request to update a company team.

Fields

Field Name
Description
team - CompanyTeam!
The updated company team instance.

Example

{"team": CompanyTeam}

UpdateCompanyUserOutput

Contains the response to the request to update the company user.

Fields

Field Name
Description
user - Customer!
The updated company user instance.

Example

{"user": Customer}

UpdateGiftRegistryInput

Defines updates to a GiftRegistry object.

Input Fields

Input Field
Description
dynamic_attributes - [GiftRegistryDynamicAttributeInput]
Additional attributes specified as a code-value pair. Unspecified dynamic attributes are not changed.
event_name - String
The updated name of the event.
message - String
The updated message describing the event.
privacy_settings - GiftRegistryPrivacySettings
Indicates whether the gift registry is PRIVATE or PUBLIC.
shipping_address - GiftRegistryShippingAddressInput
The updated shipping address for all gift registry items.
status - GiftRegistryStatus
Indicates whether the gift registry is ACTIVE or INACTIVE.

Example

{
  "dynamic_attributes": [
    GiftRegistryDynamicAttributeInput
  ],
  "event_name": "xyz789",
  "message": "xyz789",
  "privacy_settings": "PRIVATE",
  "shipping_address": GiftRegistryShippingAddressInput,
  "status": "ACTIVE"
}

UpdateGiftRegistryItemInput

Defines updates to an item in a gift registry.

Input Fields

Input Field
Description
gift_registry_item_uid - ID!
The unique ID of a `giftRegistryItem` object.
note - String
The updated description of the item.
quantity - Float!
The updated quantity of the gift registry item.

Example

{
  "gift_registry_item_uid": 4,
  "note": "xyz789",
  "quantity": 123.45
}

UpdateGiftRegistryItemsOutput

Contains the results of a request to update gift registry items.

Fields

Field Name
Description
gift_registry - GiftRegistry
The gift registry after updating updating items.

Example

{"gift_registry": GiftRegistry}

UpdateGiftRegistryOutput

Contains the results of a request to update a gift registry.

Fields

Field Name
Description
gift_registry - GiftRegistry
The updated gift registry.

Example

{"gift_registry": GiftRegistry}

UpdateGiftRegistryRegistrantInput

Defines updates to an existing registrant.

Input Fields

Input Field
Description
dynamic_attributes - [GiftRegistryDynamicAttributeInput]
As a result of the update, only the values of provided attributes will be affected. If the attribute is missing in the request, its value will not be changed.
email - String
The updated email address of the registrant.
firstname - String
The updated first name of the registrant.
gift_registry_registrant_uid - ID!
The unique ID of a `giftRegistryRegistrant` object.
lastname - String
The updated last name of the registrant.

Example

{
  "dynamic_attributes": [
    GiftRegistryDynamicAttributeInput
  ],
  "email": "xyz789",
  "firstname": "xyz789",
  "gift_registry_registrant_uid": "4",
  "lastname": "xyz789"
}

UpdateGiftRegistryRegistrantsOutput

Contains the results a request to update registrants.

Fields

Field Name
Description
gift_registry - GiftRegistry
The gift registry after updating registrants.

Example

{"gift_registry": GiftRegistry}

UpdateNegotiableQuoteItemsQuantityOutput

Contains the updated negotiable quote.

Fields

Field Name
Description
quote - NegotiableQuote
The updated negotiable quote.

Example

{"quote": NegotiableQuote}

UpdateNegotiableQuoteQuantitiesInput

Specifies the items to update.

Input Fields

Input Field
Description
items - [NegotiableQuoteItemQuantityInput]!
An array of items to update.
quote_uid - ID!
The unique ID of a `NegotiableQuote` object.

Example

{
  "items": [NegotiableQuoteItemQuantityInput],
  "quote_uid": 4
}

UpdateNegotiableQuoteTemplateItemsQuantityOutput

Contains the updated negotiable quote template.

Fields

Field Name
Description
quote_template - NegotiableQuoteTemplate
The updated negotiable quote template.

Example

{"quote_template": NegotiableQuoteTemplate}

UpdateNegotiableQuoteTemplateQuantitiesInput

Specifies the items to update.

Input Fields

Input Field
Description
items - [NegotiableQuoteTemplateItemQuantityInput]!
An array of items to update.
template_id - ID!
The unique ID of a `NegotiableQuoteTemplate` object.

Example

{
  "items": [NegotiableQuoteTemplateItemQuantityInput],
  "template_id": 4
}

UpdateProductsInWishlistOutput

Contains the customer's wish list and any errors encountered.

Fields

Field Name
Description
user_errors - [WishListUserInputError]!
An array of errors encountered while updating products in a wish list.
wishlist - Wishlist!
Contains the wish list with all items that were successfully updated.

Example

{
  "user_errors": [WishListUserInputError],
  "wishlist": Wishlist
}

UpdatePurchaseOrderApprovalRuleInput

Defines the changes to be made to an approval rule.

Input Fields

Input Field
Description
applies_to - [ID]
An updated list of company user role IDs to which this purchase order approval rule should be applied. When an empty array is provided, the rule is applied to all user roles in the system, including those created in the future.
approvers - [ID]
An updated list of B2B user roles that can approve this purchase order approval rule.
condition - CreatePurchaseOrderApprovalRuleConditionInput
The updated condition of the purchase order approval rule.
description - String
The updated approval rule description.
name - String
The updated approval rule name.
status - PurchaseOrderApprovalRuleStatus
The updated status of the purchase order approval rule.
uid - ID!
Unique identifier for the purchase order approval rule.

Example

{
  "applies_to": [4],
  "approvers": ["4"],
  "condition": CreatePurchaseOrderApprovalRuleConditionInput,
  "description": "abc123",
  "name": "abc123",
  "status": "ENABLED",
  "uid": 4
}

UpdateRequisitionListInput

An input object that defines which requistion list characteristics to update.

Input Fields

Input Field
Description
description - String
The updated description of the requisition list.
name - String!
The new name of the requisition list.

Example

{
  "description": "xyz789",
  "name": "xyz789"
}

UpdateRequisitionListItemsInput

Defines which items in a requisition list to update.

Input Fields

Input Field
Description
entered_options - [EnteredOptionInput]
An array of customer-entered options.
item_id - ID!
The ID of the requisition list item to update.
quantity - Float
The new quantity of the item.
selected_options - [String]
An array of selected option IDs.

Example

{
  "entered_options": [EnteredOptionInput],
  "item_id": "4",
  "quantity": 987.65,
  "selected_options": ["abc123"]
}

UpdateRequisitionListItemsOutput

Output of the request to update items in the specified requisition list.

Fields

Field Name
Description
requisition_list - RequisitionList
The requisition list after updating items.

Example

{"requisition_list": RequisitionList}

UpdateRequisitionListOutput

Output of the request to rename the requisition list.

Fields

Field Name
Description
requisition_list - RequisitionList
The renamed requisition list.

Example

{"requisition_list": RequisitionList}

UpdateWishlistOutput

Contains the name and visibility of an updated wish list.

Fields

Field Name
Description
name - String!
The wish list name.
uid - ID!
The unique ID of a `Wishlist` object.
visibility - WishlistVisibilityEnum!
Indicates whether the wish list is public or private.

Example

{
  "name": "abc123",
  "uid": "4",
  "visibility": "PUBLIC"
}

UrlRewrite

Contains URL rewrite details.

Fields

Field Name
Description
parameters - [HttpQueryParameter]
An array of request parameters.
url - String
The request URL.

Example

{
  "parameters": [HttpQueryParameter],
  "url": "xyz789"
}

UrlRewriteEntityTypeEnum

This enumeration defines the entity type.

Values

Enum Value
Description
CMS_PAGE
PRODUCT
CATEGORY

Example

""CMS_PAGE""

UseInLayeredNavigationOptions

Defines whether the attribute is filterable in layered navigation.

Values

Enum Value
Description
NO
FILTERABLE_WITH_RESULTS
FILTERABLE_NO_RESULT

Example

""NO""

UserCompaniesInput

Defines the input for returning matching companies the customer is assigned to.

Input Fields

Input Field
Description
currentPage - Int
Specifies which page of results to return. The default value is 1.
pageSize - Int
Specifies the maximum number of results to return at once. This attribute is optional.
sort - [CompaniesSortInput]
Defines the sorting of the results.

Example

{
  "currentPage": 123,
  "pageSize": 123,
  "sort": [CompaniesSortInput]
}

UserCompaniesOutput

An object that contains a list of companies customer is assigned to.

Fields

Field Name
Description
items - [CompanyBasicInfo]!
An array of companies customer is assigned to.
page_info - SearchResultPageInfo!
Provides navigation for the query response.

Example

{
  "items": [CompanyBasicInfo],
  "page_info": SearchResultPageInfo
}

ValidatePurchaseOrderError

Contains details about a failed validation attempt.

Fields

Field Name
Description
message - String!
The returned error message.
type - ValidatePurchaseOrderErrorType!
Error type.

Example

{"message": "xyz789", "type": "NOT_FOUND"}

ValidatePurchaseOrderErrorType

Values

Enum Value
Description
NOT_FOUND
OPERATION_NOT_APPLICABLE
COULD_NOT_SAVE
NOT_VALID_DATA
UNDEFINED

Example

""NOT_FOUND""

ValidatePurchaseOrdersInput

Defines the purchase orders to be validated.

Input Fields

Input Field
Description
purchase_order_uids - [ID]!
An array of the purchase order IDs.

Example

{"purchase_order_uids": [4]}

ValidatePurchaseOrdersOutput

Contains the results of validation attempts.

Fields

Field Name
Description
errors - [ValidatePurchaseOrderError]!
An array of error messages encountered while performing the operation.
purchase_orders - [PurchaseOrder]!
An array of the purchase orders in the request.

Example

{
  "errors": [ValidatePurchaseOrderError],
  "purchase_orders": [PurchaseOrder]
}

ValidationRule

Defines a customer attribute validation rule.

Fields

Field Name
Description
name - ValidationRuleEnum
Validation rule name applied to a customer attribute.
value - String
Validation rule value.

Example

{
  "name": "DATE_RANGE_MAX",
  "value": "abc123"
}

ValidationRuleEnum

List of validation rule names applied to a customer attribute.

Values

Enum Value
Description
DATE_RANGE_MAX
DATE_RANGE_MIN
FILE_EXTENSIONS
INPUT_VALIDATION
MAX_TEXT_LENGTH
MIN_TEXT_LENGTH
MAX_FILE_SIZE
MAX_IMAGE_HEIGHT
MAX_IMAGE_WIDTH

Example

""DATE_RANGE_MAX""

VaultMethodInput

Vault payment inputs

Input Fields

Input Field
Description
payment_source - String
The payment source for the payment method
payments_order_id - String
The payment services order ID
paypal_order_id - String
PayPal order ID
public_hash - String
The public hash of the token.

Example

{
  "payment_source": "xyz789",
  "payments_order_id": "abc123",
  "paypal_order_id": "xyz789",
  "public_hash": "xyz789"
}

VaultTokenInput

Contains required input for payment methods with Vault support.

Input Fields

Input Field
Description
public_hash - String!
The public hash of the payment token.

Example

{"public_hash": "xyz789"}

VirtualCartItem

An implementation for virtual product cart items.

Fields

Field Name
Description
customizable_options - [SelectedCustomizableOption]!
An array containing customizable options the shopper selected.
discount - [Discount]
Contains discount for quote line item.
errors - [CartItemError]
An array of errors encountered while loading the cart item
id - String!
(Deprecated: Use `uid` instead.)
is_available - Boolean!
True if requested quantity is less than available stock, false otherwise.
max_qty - Float
Line item max qty in quote template
min_qty - Float
Line item min qty in quote template
note_from_buyer - [ItemNote]
The buyer's quote line item note.
note_from_seller - [ItemNote]
The seller's quote line item note.
prices - CartItemPrices
Contains details about the price of the item, including taxes and discounts.
product - ProductInterface!
Details about an item in the cart.
quantity - Float!
The quantity of this item in the cart.
uid - ID!
The unique ID for a `CartItemInterface` object.

Example

{
  "customizable_options": [SelectedCustomizableOption],
  "discount": [Discount],
  "errors": [CartItemError],
  "id": "xyz789",
  "is_available": true,
  "max_qty": 123.45,
  "min_qty": 987.65,
  "note_from_buyer": [ItemNote],
  "note_from_seller": [ItemNote],
  "prices": CartItemPrices,
  "product": ProductInterface,
  "quantity": 123.45,
  "uid": "4"
}

VirtualProduct

Defines a virtual product, which is a non-tangible product that does not require shipping and is not kept in inventory.

Fields

Field Name
Description
attribute_set_id - Int
The attribute set assigned to the product. (Deprecated: The field should not be used on the storefront.)
canonical_url - String
The relative canonical URL. This value is returned only if the system setting 'Use Canonical Link Meta Tag For Products' is enabled.
categories - [CategoryInterface]
The categories assigned to a product.
color - Int
(Deprecated: Use the `custom_attributes` field instead.)
country_of_manufacture - String
The product's country of origin.
created_at - String
Timestamp indicating when the product was created. (Deprecated: The field should not be used on the storefront.)
crosssell_products - [ProductInterface]
An array of cross-sell products.
custom_attributesV2 - ProductCustomAttributes
Product custom attributes.
description - ComplexTextValue
Detailed information about the product. The value can include simple HTML tags.
gift_message_available - String
Indicates whether a gift message is available.
id - Int
The ID number assigned to the product. (Deprecated: Use the `uid` field instead.)
image - ProductImage
The relative path to the main image on the product page.
is_returnable - String
Indicates whether the product can be returned.
manufacturer - Int
A number representing the product's manufacturer. (Deprecated: Use the `custom_attributes` field instead.)
media_gallery - [MediaGalleryInterface]
An array of media gallery objects.
media_gallery_entries - [MediaGalleryEntry]
An array of MediaGalleryEntry objects. (Deprecated: Use `media_gallery` instead.)
meta_description - String
A brief overview of the product for search results listings, maximum 255 characters.
meta_keyword - String
A comma-separated list of keywords that are visible only to search engines.
meta_title - String
A string that is displayed in the title bar and tab of the browser and in search results lists.
name - String
The product name. Customers use this name to identify the product.
new_from_date - String
The beginning date for new product listings, and determines if the product is featured as a new product.
new_to_date - String
The end date for new product listings.
only_x_left_in_stock - Float
Product stock only x left count
options - [CustomizableOptionInterface]
An array of options for a customizable product.
options_container - String
If the product has multiple options, determines where they appear on the product page.
price - ProductPrices
Indicates the price of an item. (Deprecated: Use `price_range` for product price information.)
price_range - PriceRange!
The range of prices for the product
price_tiers - [TierPrice]
An array of `TierPrice` objects.
product_links - [ProductLinksInterface]
An array of `ProductLinks` objects.
rating_summary - Float!
The average of all the ratings given to the product.
redirect_code - Int!
Contains 0 when there is no redirect error. A value of 301 indicates the URL of the requested resource has been changed permanently, while a value of 302 indicates a temporary redirect.
related_products - [ProductInterface]
An array of related products.
relative_url - String
The internal relative URL. If the specified URL is a redirect, the query returns the redirected URL, not the original.
review_count - Int!
The total count of all the reviews given to the product.
reviews - ProductReviews!
The list of products reviews.
short_description - ComplexTextValue
A short description of the product. Its use depends on the theme.
sku - String
A number or code assigned to a product to identify the product, options, price, and manufacturer.
small_image - ProductImage
The relative path to the small image, which is used on catalog pages.
special_from_date - String
The beginning date that a product has a special price. (Deprecated: The field should not be used on the storefront.)
special_price - Float
The discounted price of the product.
special_to_date - String
The end date for a product with a special price.
staged - Boolean!
Indicates whether the product is staged for a future campaign.
stock_status - ProductStockStatus
Stock status of the product
swatch_image - String
The file name of a swatch image.
thumbnail - ProductImage
The relative path to the product's thumbnail image.
tier_price - Float
The price when tier pricing is in effect and the items purchased threshold has been reached. (Deprecated: Use `price_tiers` for product tier price information.)
tier_prices - [ProductTierPrices]
An array of ProductTierPrices objects. (Deprecated: Use `price_tiers` for product tier price information.)
type - UrlRewriteEntityTypeEnum
One of PRODUCT, CATEGORY, or CMS_PAGE.
type_id - String
One of simple, virtual, bundle, downloadable, grouped, or configurable. (Deprecated: Use `__typename` instead.)
uid - ID!
The unique ID for a `ProductInterface` object.
updated_at - String
Timestamp indicating when the product was updated. (Deprecated: The field should not be used on the storefront.)
upsell_products - [ProductInterface]
An array of up-sell products.
url_key - String
The part of the URL that identifies the product
url_path - String
(Deprecated: Use product's `canonical_url` or url rewrites instead)
url_rewrites - [UrlRewrite]
URL rewrites list
url_suffix - String
The part of the product URL that is appended after the url key
websites - [Website]
An array of websites in which the product is available. (Deprecated: The field should not be used on the storefront.)

Example

{
  "attribute_set_id": 987,
  "canonical_url": "xyz789",
  "categories": [CategoryInterface],
  "color": 123,
  "country_of_manufacture": "abc123",
  "created_at": "abc123",
  "crosssell_products": [ProductInterface],
  "custom_attributesV2": ProductCustomAttributes,
  "description": ComplexTextValue,
  "gift_message_available": "abc123",
  "id": 987,
  "image": ProductImage,
  "is_returnable": "xyz789",
  "manufacturer": 987,
  "media_gallery": [MediaGalleryInterface],
  "media_gallery_entries": [MediaGalleryEntry],
  "meta_description": "abc123",
  "meta_keyword": "abc123",
  "meta_title": "xyz789",
  "name": "abc123",
  "new_from_date": "abc123",
  "new_to_date": "xyz789",
  "only_x_left_in_stock": 123.45,
  "options": [CustomizableOptionInterface],
  "options_container": "abc123",
  "price": ProductPrices,
  "price_range": PriceRange,
  "price_tiers": [TierPrice],
  "product_links": [ProductLinksInterface],
  "rating_summary": 987.65,
  "redirect_code": 123,
  "related_products": [ProductInterface],
  "relative_url": "xyz789",
  "review_count": 987,
  "reviews": ProductReviews,
  "short_description": ComplexTextValue,
  "sku": "xyz789",
  "small_image": ProductImage,
  "special_from_date": "abc123",
  "special_price": 123.45,
  "special_to_date": "xyz789",
  "staged": true,
  "stock_status": "IN_STOCK",
  "swatch_image": "xyz789",
  "thumbnail": ProductImage,
  "tier_price": 987.65,
  "tier_prices": [ProductTierPrices],
  "type": "CMS_PAGE",
  "type_id": "xyz789",
  "uid": "4",
  "updated_at": "xyz789",
  "upsell_products": [ProductInterface],
  "url_key": "abc123",
  "url_path": "xyz789",
  "url_rewrites": [UrlRewrite],
  "url_suffix": "xyz789",
  "websites": [Website]
}

VirtualProductCartItemInput

Defines a single product to add to the cart.

Input Fields

Input Field
Description
customizable_options - [CustomizableOptionInput]
An array that defines customizable options for the product.
data - CartItemInput!
An object containing the `sku`, `quantity`, and other relevant information about the product.

Example

{
  "customizable_options": [CustomizableOptionInput],
  "data": CartItemInput
}

VirtualRequisitionListItem

Contains details about virtual products added to a requisition list.

Fields

Field Name
Description
customizable_options - [SelectedCustomizableOption]!
Selected custom options for an item in the requisition list.
product - ProductInterface!
Details about a requisition list item.
quantity - Float!
The amount added.
uid - ID!
The unique ID for the requisition list item.

Example

{
  "customizable_options": [SelectedCustomizableOption],
  "product": ProductInterface,
  "quantity": 123.45,
  "uid": 4
}

VirtualWishlistItem

Contains a virtual product wish list item.

Fields

Field Name
Description
added_at - String!
The date and time the item was added to the wish list.
customizable_options - [SelectedCustomizableOption]!
Custom options selected for the wish list item.
description - String
The description of the item.
id - ID!
The unique ID for a `WishlistItemInterface` object.
product - ProductInterface
Product details of the wish list item.
quantity - Float!
The quantity of this wish list item.

Example

{
  "added_at": "xyz789",
  "customizable_options": [SelectedCustomizableOption],
  "description": "xyz789",
  "id": "4",
  "product": ProductInterface,
  "quantity": 123.45
}

Website

Deprecated. It should not be used on the storefront. Contains information about a website.

Fields

Field Name
Description
code - String
A code assigned to the website to identify it. (Deprecated: The field should not be used on the storefront.)
default_group_id - String
The default group ID of the website. (Deprecated: The field should not be used on the storefront.)
id - Int
The ID number assigned to the website. (Deprecated: The field should not be used on the storefront.)
is_default - Boolean
Indicates whether this is the default website. (Deprecated: The field should not be used on the storefront.)
name - String
The website name. Websites use this name to identify it easier. (Deprecated: The field should not be used on the storefront.)
sort_order - Int
The attribute to use for sorting websites. (Deprecated: The field should not be used on the storefront.)

Example

{
  "code": "xyz789",
  "default_group_id": "abc123",
  "id": 987,
  "is_default": false,
  "name": "abc123",
  "sort_order": 123
}

WishListUserInputError

An error encountered while performing operations with WishList.

Fields

Field Name
Description
code - WishListUserInputErrorType!
A wish list-specific error code.
message - String!
A localized error message.

Example

{
  "code": "PRODUCT_NOT_FOUND",
  "message": "abc123"
}

WishListUserInputErrorType

A list of possible error types.

Values

Enum Value
Description
PRODUCT_NOT_FOUND
UNDEFINED

Example

""PRODUCT_NOT_FOUND""

Wishlist

Contains a customer wish list.

Fields

Field Name
Description
id - ID
The unique ID for a `Wishlist` object.
items - [WishlistItem]
(Deprecated: Use the `items_v2` field instead.)
items_count - Int
The number of items in the wish list.
items_v2 - WishlistItems
An array of items in the customer's wish list.
name - String
The name of the wish list.
sharing_code - String
An encrypted code that Magento uses to link to the wish list.
updated_at - String
The time of the last modification to the wish list.
visibility - WishlistVisibilityEnum!
Indicates whether the wish list is public or private.

Example

{
  "id": 4,
  "items": [WishlistItem],
  "items_count": 123,
  "items_v2": WishlistItems,
  "name": "abc123",
  "sharing_code": "xyz789",
  "updated_at": "xyz789",
  "visibility": "PUBLIC"
}

WishlistCartUserInputError

Contains details about errors encountered when a customer added wish list items to the cart.

Fields

Field Name
Description
code - WishlistCartUserInputErrorType!
An error code that describes the error encountered.
message - String!
A localized error message.
wishlistId - ID!
The unique ID of the `Wishlist` object containing an error.
wishlistItemId - ID!
The unique ID of the wish list item containing an error.

Example

{
  "code": "PRODUCT_NOT_FOUND",
  "message": "abc123",
  "wishlistId": 4,
  "wishlistItemId": "4"
}

WishlistCartUserInputErrorType

A list of possible error types.

Values

Enum Value
Description
PRODUCT_NOT_FOUND
NOT_SALABLE
INSUFFICIENT_STOCK
UNDEFINED

Example

""PRODUCT_NOT_FOUND""

WishlistItem

Contains details about a wish list item.

Fields

Field Name
Description
added_at - String
The time when the customer added the item to the wish list.
description - String
The customer's comment about this item.
id - Int
The unique ID for a `WishlistItem` object.
product - ProductInterface
Details about the wish list item.
qty - Float
The quantity of this wish list item

Example

{
  "added_at": "abc123",
  "description": "abc123",
  "id": 987,
  "product": ProductInterface,
  "qty": 123.45
}

WishlistItemCopyInput

Specifies the IDs of items to copy and their quantities.

Input Fields

Input Field
Description
quantity - Float
The quantity of this item to copy to the destination wish list. This value can't be greater than the quantity in the source wish list.
wishlist_item_id - ID!
The unique ID of the `WishlistItemInterface` object to be copied.

Example

{"quantity": 123.45, "wishlist_item_id": 4}

WishlistItemInput

Defines the items to add to a wish list.

Input Fields

Input Field
Description
entered_options - [EnteredOptionInput]
An array of options that the customer entered.
parent_sku - String
For complex product types, the SKU of the parent product.
quantity - Float!
The amount or number of items to add.
selected_options - [ID]
An array of strings corresponding to options the customer selected.
sku - String!
The SKU of the product to add. For complex product types, specify the child product SKU.

Example

{
  "entered_options": [EnteredOptionInput],
  "parent_sku": "abc123",
  "quantity": 987.65,
  "selected_options": ["4"],
  "sku": "abc123"
}

WishlistItemInterface

The interface for wish list items.

Fields

Field Name
Description
added_at - String!
The date and time the item was added to the wish list.
customizable_options - [SelectedCustomizableOption]!
Custom options selected for the wish list item.
description - String
The description of the item.
id - ID!
The unique ID for a `WishlistItemInterface` object.
product - ProductInterface
Product details of the wish list item.
quantity - Float!
The quantity of this wish list item.

Possible Types

Example

{
  "added_at": "abc123",
  "customizable_options": [SelectedCustomizableOption],
  "description": "abc123",
  "id": "4",
  "product": ProductInterface,
  "quantity": 123.45
}

WishlistItemMoveInput

Specifies the IDs of the items to move and their quantities.

Input Fields

Input Field
Description
quantity - Float
The quantity of this item to move to the destination wish list. This value can't be greater than the quantity in the source wish list.
wishlist_item_id - ID!
The unique ID of the `WishlistItemInterface` object to be moved.

Example

{
  "quantity": 987.65,
  "wishlist_item_id": "4"
}

WishlistItemUpdateInput

Defines updates to items in a wish list.

Input Fields

Input Field
Description
description - String
Customer-entered comments about the item.
entered_options - [EnteredOptionInput]
An array of options that the customer entered.
quantity - Float
The new amount or number of this item.
selected_options - [ID]
An array of strings corresponding to options the customer selected.
wishlist_item_id - ID!
The unique ID for a `WishlistItemInterface` object.

Example

{
  "description": "xyz789",
  "entered_options": [EnteredOptionInput],
  "quantity": 123.45,
  "selected_options": [4],
  "wishlist_item_id": 4
}

WishlistItems

Contains an array of items in a wish list.

Fields

Field Name
Description
items - [WishlistItemInterface]!
A list of items in the wish list.
page_info - SearchResultPageInfo
Contains pagination metadata.

Example

{
  "items": [WishlistItemInterface],
  "page_info": SearchResultPageInfo
}

WishlistOutput

Deprecated: Use the Wishlist type instead.

Fields

Field Name
Description
items - [WishlistItem]
An array of items in the customer's wish list (Deprecated: Use the `Wishlist.items` field instead.)
items_count - Int
The number of items in the wish list. (Deprecated: Use the `Wishlist.items_count` field instead.)
name - String
When multiple wish lists are enabled, the name the customer assigns to the wishlist. (Deprecated: This field is related to Commerce functionality and is always `null` in Open Source.)
sharing_code - String
An encrypted code that links to the wish list. (Deprecated: Use the `Wishlist.sharing_code` field instead.)
updated_at - String
The time of the last modification to the wish list. (Deprecated: Use the `Wishlist.updated_at` field instead.)

Example

{
  "items": [WishlistItem],
  "items_count": 123,
  "name": "abc123",
  "sharing_code": "abc123",
  "updated_at": "xyz789"
}

WishlistVisibilityEnum

Defines the wish list visibility types.

Values

Enum Value
Description
PUBLIC
PRIVATE

Example

""PUBLIC""

createEmptyCartInput

Assigns a specific cart_id to the empty cart.

Input Fields

Input Field
Description
cart_id - String
The ID to assign to the cart.

Example

{"cart_id": "xyz789"}