This is a beta release of documentation for Magento 2.4, published for previewing soon-to-be-released functionality. Content in this version is subject to change. Links to the v2.4 code base may not properly resolve until the code is officially released.

storeConfig query

The storeConfig query defines information about a store’s configuration. You can query a non-default store by changing the header in your GraphQL request.

Syntax

storeConfig: StoreConfig

Example usage

Query a store’s configuration

The following call returns all details of a store’s configuration.

Request:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
  storeConfig {
    id
    code
    website_id
    locale
    base_currency_code
    default_display_currency_code
    timezone
    weight_unit
    base_url
    base_link_url
    base_static_url
    base_media_url
    secure_base_url
    secure_base_link_url
    secure_base_static_url
    secure_base_media_url
    store_name
    send_friend {
      enabled_for_customers
      enabled_for_guests
    }
  }
}

Response:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
{
  "data": {
    "storeConfig": {
      "id": 1,
      "code": "default",
      "website_id": 1,
      "locale": "en_US",
      "base_currency_code": "USD",
      "default_display_currency_code": "USD",
      "timezone": "America/Chicago",
      "weight_unit": "lbs",
      "base_url": "http://magento2.vagrant193/",
      "base_link_url": "http://magento2.vagrant193/",
      "base_static_url": "http://magento2.vagrant193/pub/static/version1536249714/",
      "base_media_url": "http://magento2.vagrant193/pub/media/",
      "secure_base_url": "http://magento2.vagrant193/",
      "secure_base_link_url": "http://magento2.vagrant193/",
      "secure_base_static_url": "http://magento2.vagrant193/pub/static/version1536249714/",
      "secure_base_media_url": "http://magento2.vagrant193/pub/media/",
      "store_name": "My Store",
      "send_friend": {
        "enabled_for_customers": true,
        "enabled_for_guests": false
      }
    }
  }
}

Query a store’s theme

The following query returns information about the store’s default title, keywords, and welcome text.

Request:

1
2
3
4
5
6
7
{
  storeConfig {
    default_title
    default_keywords
    welcome
  }
}

Response:

1
2
3
4
5
6
7
8
9
{
  "data": {
    "storeConfig": {
      "default_title": "Magento Enterprise Edition",
      "default_keywords": "Magento, Varien, E-commerce",
      "welcome": "Default welcome msg!"
    }
  }
}

Query a store’s CMS configuration

The following query returns information about the store’s content pages.

Request:

1
2
3
4
5
6
7
8
9
10
{
  storeConfig {
    front
    cms_home_page
    no_route
    cms_no_route
    cms_no_cookies
    show_cms_breadcrumbs
  }
}

Response:

1
2
3
4
5
6
7
8
9
10
11
12
{
  "data": {
    "storeConfig": {
      "front": "cms",
      "cms_home_page": "home",
      "no_route": "cms/noroute/index",
      "cms_no_route": "no-route",
      "cms_no_cookies": "enable-cookies",
      "show_cms_breadcrumbs": 1
    }
  }
}

Query a store’s Catalog configuration

The following query returns information about the store’s catalog configuration.

Request:

1
2
3
4
5
6
7
8
9
10
11
12
13
{
  storeConfig {
    product_url_suffix
    category_url_suffix
    title_separator
    list_mode
    grid_per_page_values
    list_per_page_values
    grid_per_page
    list_per_page
    catalog_default_sort_by
  }
}

Response:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "data": {
    "storeConfig": {
      "product_url_suffix": ".html",
      "category_url_suffix": ".html",
      "title_separator": "-",
      "list_mode": "grid-list",
      "grid_per_page_values": "9,15,30",
      "list_per_page_values": "5,10,15,20,25",
      "grid_per_page": 9,
      "list_per_page": 10,
      "catalog_default_sort_by": "position"
    }
  }
}

Query a store’s fixed product tax configuration

The following query returns enumeration values that indicate the store’s fixed product tax configuration.

Request:

1
2
3
4
5
6
7
{
  storeConfig {
    category_fixed_product_tax_display_setting
    product_fixed_product_tax_display_setting
    sales_fixed_product_tax_display_setting
  }
}

Response:

1
2
3
4
5
6
7
8
9
{
  "data": {
    "storeConfig": {
      "category_fixed_product_tax_display_setting": "EXCLUDE_FPT_WITHOUT_DETAILS",
      "product_fixed_product_tax_display_setting": "EXCLUDE_FPT_AND_INCLUDE_WITH_DETAILS",
      "sales_fixed_product_tax_display_setting": "INCLUDE_FPT_WITHOUT_DETAILS"
    }
  }
}

Output attributes

Supported storeConfig attributes

Use the storeConfig attributes to retrieve information about the store’s configuration; such as, locale, currency codes, and secure and unsecure URLs.

Attribute Data Type Description Example
base_currency_code String The code representing the currency in which Magento processes all payment transactions USD
base_link_url String A fully-qualified URL that is used to create relative links to the base_url http://magentohost.example.com/
base_static_url String The fully-qualified URL that specifies the location of static view files http://magentohost.example.com/pub/static/
base_media_url String The fully-qualified URL that specifies the location of user media files http://magentohost.example.com/pub/media/
base_url String The store’s fully-qualified base URL http://magentohost.example.com/
code String A unique identifier for the store default
default_display_currency_code String The code representing the currency displayed on the store USD
id Integer The ID number assigned to the store 1
locale String The store’s locale en_US
secure_base_link_url String A secure fully-qualified URL that is used to create relative links to the base_url https://magentohost.example.com/
secure_base_media_url String The secure fully-qualified URL that specifies the location of user media files https://magentohost.example.com/pub/media/
secure_base_static_url String The secure fully-qualified URL that specifies the location of static view files https://magentohost.example.com/pub/static/
secure_base_url String The store’s fully-qualified secure base URL https://magentohost.example.com/
send_friend SendFriendConfiguration Email to a Friend configuration Not applicable
store_name String The store’s name My Store
timezone String The store’s time zone America/Chicago
website_id Integer The ID number assigned to the parent website 1
weight_unit String The weight unit for products lbs, kgs, or similar

SendFriendConfiguration attributes

Attribute Data Type Description
enabled_for_customers Boolean! Indicates whether the Email to a Friend feature is enabled for customers
enabled_for_guests Boolean! Indicates whether the Email to a Friend feature is enabled for guests

Supported theme attributes

Use the theme attributes to retrieve information about the store’s thematic elements; such as, footer and header information, copyright text, and logo information. These attributes are defined in the ThemeGraphQl module.

Attribute Data Type Description
absolute_footer String Contains scripts that must be included in the HTML before the closing <body> tag
copyright String The copyright statement that appears at the bottom of each page
default_description String The description that provides a summary of your site for search engine listings and should not be more than 160 characters in length
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)
head_includes String Contains scripts that must be included in the HTML before the closing <head> tag
head_shortcut_icon String Uploads the small graphic image 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
logo_alt String The Alt text that is associated with the logo
logo_height Int The height of your logo image in pixels
logo_width Int The width of your logo image in pixels
title_prefix String A prefix that appears before the title to create a two- or three-part title
title_suffix String A suffix that appears after the title to create a two-or three part title
welcome String Text that appears in the header of the page and includes the name of customers who are logged in

Supported CMS attributes

Use the cms attributes to retrieve information about the store’s default pages. These attributes are defined in the CmsGraphQl module.

Attribute Data Type Description
cms_home_page String Returns the name of the CMS page that identifies the home page for the store
cms_no_cookies String Identifies a specific CMS page that appears when cookies are not enabled for the browser
cms_no_route String Identifies a specific CMS page that you want to appear when a 404 “Page Not Found” error occurs
front String Indicates the landing page that is associated with the base URL
no_route String Contains the URL of the default page that you want to appear when if a 404 “Page not Found” error occurs
show_cms_breadcrumbs Int Determines if a breadcrumb trail appears on all CMS pages in the catalog. Options: 0 (No) or 1 (Yes)

Supported Catalog attributes

Use the catalog attributes to retrieve information about the store’s catalog. These attributes are defined in the CatalogGraphQl module.

Attribute Data Type Description Example
catalog_default_sort_by String The default sort order of the search results list position
category_url_suffix String The suffix applied to category pages, such as .htm or .html .html
grid_per_page Int The default number of products per page in Grid View 9
grid_per_page_values A list of numbers that define how many products can be displayed in List View 9,15,30  
list_mode String The format of the search results list grid-list
list_per_page Int The default number of products per page in List View 10
list_per_page_values String A list of numbers that define how many products can be displayed in List View 5,10,15,20,25
product_url_suffix String The suffix applied to product pages, such as .htm or .html .html
root_category_id Int The ID of the root category  
title_separator String Identifies the character that separates the category name and subcategory in the browser title bar -

Supported WEEE (fixed product tax) attributes

The Stores > Settings > Configuration > Sales > Tax > Fixed Product Taxes panel contains several fields that determine how to display fixed product tax (FPT) values and descriptions. Use the following attributes to determine the values of the Fixed Product Taxes fields. These attributes are defined in the WeeeGraphQl module.

Attribute Data Type Description
category_fixed_product_tax_display_setting FixedProductTaxDisplaySettings Corresponds to the Display Prices In Product Lists field. It indicates how FPT information is displayed on category pages
product_fixed_product_tax_display_setting FixedProductTaxDisplaySettings Corresponds to the Display Prices On Product View Page field. It indicates how FPT information is displayed on product pages
sales_fixed_product_tax_display_setting FixedProductTaxDisplaySettings Corresponds to the Display Prices In Sales Modules field. It indicates how FPT information is displayed on cart, checkout, and order pages

The FixedProductTaxDisplaySettings data type is an enumeration that describes whether displayed prices include fixed product taxes and whether Magento separately displays detailed information about the FPTs.

Value Description
EXCLUDE_FPT_AND_INCLUDE_WITH_DETAILS The displayed price does not include the FPT amount. You must display the values of ProductPrice.fixed_product_taxes and the price including the FPT separately. This value corresponds to Excluding FPT, Including FPT description and final price
EXCLUDE_FPT_WITHOUT_DETAILS The displayed price does not include the FPT amount. The values from ProductPrice.fixed_product_taxes are not displayed. This value corresponds to Excluding FPT
FPT_DISABLED The FPT feature is not enabled. You can omit ProductPrice.fixed_product_taxes from your query
INCLUDE_FPT_WITH_DETAILS The displayed price includes the FPT amount while displaying the values of ProductPrice.fixed_product_taxes separately. This value corresponds to Including FPT and FPT description
INCLUDE_FPT_WITHOUT_DETAILS The displayed price includes the FPT amount without displaying the ProductPrice.fixed_product_taxes values. This value corresponds to Including FPT only

Extend configuration data

You can add your own configuration to the storeConfig query within your own module.

To do this, configure the constructor argument extendedConfigData in the argument node in your area-specific etc/graphql/di.xml file.

The following example adds an array-item to the extendedConfigData array within the construct of the StoreConfigDataProvider.

1
2
3
4
5
6
7
8
9
10
<?xml version="1.0" ?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/config.xsd">
  <type name="Magento\StoreGraphQl\Model\Resolver\Store\StoreConfigDataProvider">
    <arguments xsi:type="array">
      <argument name="extendedConfigData">
        <item name="section_group_field" xsi:type="string">section/group/field</item>
      </argument>
    </arguments>
  </type>
</config>

You must also extend the type storeConfig within in the etc/schema.graphqls file, as shown below:

1
2
3
type StoreConfig {
    section_group_field : String  @doc(description: "Extended Config Data - section/group/field")
}