Product attributes | BigCommerce Developer Center

International Enhancements for Multi-Storefront

This feature is currently available for Enterprise stores and Partner Sandboxes. If the feature is not working as expected, please contact technical support, as the feature likely needs to be enabled for the individual store. To become an enterprise customer, contact your BigCommerce Customer Service Manager or our support team.

Using the Catalog features of the Admin API, you can set and query product attributes, for example, storefront details, pre-order messages, and whether a product is featured.

Perform the following:

Set a product’s pre-order settings for the store or a locale within a channel. Pre-order messages communicate info about products that aren’t yet available for purchase.
Set a product’s storefront details for the store or a locale within a channel. Details include product warranty, availability, and search keywords.
Set a product as featured for the store or a channel. Channel values apply to all locales within the channel.

Attributes for the locale or channel override global values. If you remove an override, the product attribute defaults to its global store value.

For a full schema, see the GraphQL Admin API reference.

Input fields

Setting or removing information requires that you specify ID fields in the input. For more information on how to specify ID fields, see Input fields.

Pre-order settings

Set a product’s pre-order settings for a store or a locale within a storefront channel. You can set the pre-order message that shoppers see for products that aren’t yet available for purchase.

Set pre-order settings at the global level

The following example sets a product’s pre-order settings for a store, from which channels inherit by default.

Request

Response

Example mutation: Set pre-order settings at the global level

1 POST https://api.bigcommerce.com/stores/{{STORE_HASH}}/graphql
2 X-Auth-Token: {{ACCESS_TOKEN}}
3 Content-Type: application/json
4 Accept: application/json
5 
6 mutation ($input: SetProductPreOrderSettingsInput!) {
7   product {
8     setProductPreOrderSettings (input: $input) {
9       product {
10         preOrderSettings {
11           message
12         }
13       }
14     }
15   }
16 }

GraphQL variables

1 {
2   "input": {
3     "productId": "bc/store/product/111",
4     "data": {
5       "message": "Product will be released soon"
6     }
7   }
8 }

Set pre-order settings for a locale

The following example sets a product’s pre-order settings for the locale within a storefront channel. These settings override global store information.

Request

Response

Example mutation: Set pre-order settings for a locale

1 POST https://api.bigcommerce.com/stores/{{STORE_HASH}}/graphql
2 X-Auth-Token: {{ACCESS_TOKEN}}
3 Content-Type: application/json
4 Accept: application/json
5 
6 mutation ($input: SetProductPreOrderSettingsInput!) {
7   product {
8     setProductPreOrderSettings (input: $input) {
9       product {
10         overridesForLocale (localeContext: {channelId: "bc/store/channel/2", locale: "fr"}) {
11           preOrderSettings {
12             message
13           }
14         }
15       }
16     }
17   }
18 }

GraphQL variables

1 {
2   "input": {
3     "productId": "bc/store/product/111",
4     "localeContext": {
5       "locale": "fr",
6       "channelId": "bc/store/channel/2"
7     },
8     "data": {
9       "message": "Le produit sortira dans un mois"
10     }
11   }
12 }

Remove pre-order settings for a locale

The following example removes the overrides for a product’s pre-order settings. This mutation removes the overrides for the locale within the storefront channel, and the pre-order setting defaults to its global store value.

Request

Response

Example mutation: Remove pre-order settings for a locale

1 POST https://api.bigcommerce.com/stores/{{STORE_HASH}}/graphql
2 X-Auth-Token: {{ACCESS_TOKEN}}
3 Content-Type: application/json
4 Accept: application/json
5 
6 mutation ($input: RemoveProductPreOrderSettingsOverridesInput!) {
7   product {
8     removeProductPreOrderSettingsOverrides (input: $input) {
9       product {
10         overridesForLocale (localeContext: {channelId: "bc/store/channel/2", locale: "fr"}) {
11           preOrderSettings {
12             message
13           }
14         }
15       }
16     }
17   }
18 }

GraphQL variables

1 {
2   "input": {
3     "productId": "bc/store/product/111",
4     "localeContext": {
5       "locale": "fr",
6       "channelId": "bc/store/channel/2"
7     },
8     "overridesToRemove": ["PRODUCT_PRE_ORDER_MESSAGE"]
9   }
10 }

Query pre-order settings

The following example retrieves a product’s pre-order settings. You can retrieve global information for the store and overrides for a locale within a storefront channel.

Request

Response

Example query: Get pre-order settings for a product

1 POST https://api.bigcommerce.com/stores/{{STORE_HASH}}/graphql
2 X-Auth-Token: {{ACCESS_TOKEN}}
3 Content-Type: application/json
4 Accept: application/json
5 
6 query {
7   store {
8     product (id: "bc/store/product/111") {
9       preOrderSettings {
10         message
11       }
12       overridesForLocale (localeContext: {locale: "fr", channelId: "bc/store/channel/2"}) {
13         preOrderSettings {
14           message
15         }
16       }
17     }
18   }
19 }

Storefront details

Set a product’s storefront details for a store or a locale within a storefront channel. Set details like product warranty, availability, and search keywords.

Set storefront details at the global level

The following example sets a product’s storefront details for a store, from which channels inherit by default.

Request

Response

Example mutation: Set storefront details at the global level

1 POST https://api.bigcommerce.com/stores/{{STORE_HASH}}/graphql
2 X-Auth-Token: {{ACCESS_TOKEN}}
3 Content-Type: application/json
4 Accept: application/json
5 
6 mutation ($input: SetProductStorefrontDetailsInput!) {
7   product {
8     setProductStorefrontDetails (input: $input) {
9       product {
10         storefrontDetails {
11           warranty
12           availabilityDescription
13           searchKeywords
14         }
15       }
16     }
17   }
18 }

GraphQL variables

1 {
2   "input": {
3     "productId": "bc/store/product/111",
4     "data": {
5       "warranty": "1 year warranty",
6       "availabilityDescription": "Available in a month",
7       "searchKeywords": "Best selling"
8     }
9   }
10 }

Set storefront details for a locale

The following example sets a product’s storefront details for the locale within a storefront channel. These details override global store information.

Request

Response

Example mutation: Set storefront details for a locale

1 POST https://api.bigcommerce.com/stores/{{STORE_HASH}}/graphql
2 X-Auth-Token: {{ACCESS_TOKEN}}
3 Content-Type: application/json
4 Accept: application/json
5 
6 mutation ($input: SetProductStorefrontDetailsInput!) {
7   product {
8     setProductStorefrontDetails (input: $input) {
9       product {
10         overridesForLocale (localeContext: {locale: "fr", channelId: "bc/store/channel/2"}) {
11           storefrontDetails {
12             warranty
13             availabilityDescription
14             searchKeywords
15           }
16         }
17       }
18     }
19   }
20 }

GraphQL variables

1 {
2   "input": {
3     "productId": "bc/store/product/111",
4     "localeContext": {
5       "locale": "fr",
6       "channelId": "bc/store/channel/2"
7     },
8     "data": {
9       "warranty": "Garantie un an",
10       "availabilityDescription": "Disponible dans un mois",
11       "searchKeywords": "meilleure vente"
12     }
13   }
14 }

Remove storefront details for a locale

The following example removes the overrides for a product’s storefront details. This mutation removes the overrides for the locale within the storefront channel, and the storefront details default to their global store values.

Omitting the overridesToRemove field from the input removes all overrides for storefront details from the locale.

Request

Response

Example mutation: Remove storefront details for a locale

1 POST https://api.bigcommerce.com/stores/{{STORE_HASH}}/graphql
2 X-Auth-Token: {{ACCESS_TOKEN}}
3 Content-Type: application/json
4 Accept: application/json
5 
6 mutation ($input: RemoveProductStorefrontDetailsOverridesInput!) {
7   product {
8     removeProductStorefrontDetailsOverrides (input: $input) {
9       product {
10         overridesForLocale (localeContext: {channelId: "bc/store/channel/2", locale: "fr"}) {
11           storefrontDetails {
12             warranty
13             availabilityDescription
14             searchKeywords
15           }
16         }
17       }
18     }
19   }
20 }

GraphQL variables

1 {
2   "input": {
3     "productId": "bc/store/product/111",
4     "localeContext": {
5       "locale": "fr",
6       "channelId": "bc/store/channel/2"
7     },
8     "overridesToRemove": ["PRODUCT_AVAILABILITY_DESCRIPTION_FIELD", "PRODUCT_SEARCH_KEYWORDS", "PRODUCT_WARRANTY"]
9   }
10 }

Query storefront details

The following example retrieves a product’s storefront details. You can retrieve global information for the store and overrides for a locale within a storefront channel.

Request

Response

Example mutation: Get storefront details for a product

1 POST https://api.bigcommerce.com/stores/{{STORE_HASH}}/graphql
2 X-Auth-Token: {{ACCESS_TOKEN}}
3 Content-Type: application/json
4 Accept: application/json
5 
6 query {
7   store {
8     product (id: "bc/store/product/111") {
9       storefrontDetails {
10         warranty
11         availabilityDescription
12         searchKeywords
13       }
14       overridesForLocale (localeContext: {locale: "fr", channelId: "bc/store/channel/2"}) {
15         storefrontDetails {
16           warranty
17           availabilityDescription
18           searchKeywords
19         }
20       }
21     }
22   }
23 }

Featured products

Set whether to feature a product for a store or a storefront channel. Channel values apply to all locales within the channel.

Set featured flag at the global level

The following example sets whether to feature a product for a store, from which channels inherit by default.

Request

Response

Example mutation: Set featured flag at the global level

1 POST https://api.bigcommerce.com/stores/{{STORE_HASH}}/graphql
2 X-Auth-Token: {{ACCESS_TOKEN}}
3 Content-Type: application/json
4 Accept: application/json
5 
6 mutation ($input: SetProductIsFeaturedInput!) {
7   product {
8     setProductIsFeatured (input: $input) {
9       product {
10         isFeatured
11       }
12     }
13   }
14 }

GraphQL variables

1 {
2   "input": {
3     "productId": "bc/store/product/111",
4     "data": {
5       "isFeatured": true
6     }
7   }
8 }

Set featured flag for a channel

The following example sets whether to feature a product in a storefront channel. These override global store information.

Request

Response

Example mutation: Set featured flag for a channel

1 POST https://api.bigcommerce.com/stores/{{STORE_HASH}}/graphql
2 X-Auth-Token: {{ACCESS_TOKEN}}
3 Content-Type: application/json
4 Accept: application/json
5 
6 mutation ($input: SetProductIsFeaturedInput!) {
7   product {
8     setProductIsFeatured (input: $input) {
9       product {
10         overridesForChannel (channelId: "bc/store/channel/2") {
11           isFeatured
12         }
13       }
14     }
15   }
16 }

GraphQL variables

1 {
2   "input": {
3     "channelId": "bc/store/channel/2",
4     "productId": "bc/store/product/111",
5     "data": {
6       "isFeatured": false
7     }
8   }
9 }

Remove featured flag for a channel

The following example removes the overrides for whether a product is featured. This mutation removes the override from the storefront channel, and the featured flag defaults to its global store value.

Request

Response

Example mutation: Remove featured flag for a channel

1 POST https://api.bigcommerce.com/stores/{{STORE_HASH}}/graphql
2 X-Auth-Token: {{ACCESS_TOKEN}}
3 Content-Type: application/json
4 Accept: application/json
5 
6 mutation ($input: RemoveProductIsFeaturedOverrideInput!) {
7   product {
8     removeProductIsFeaturedOverride (input: $input) {
9       product {
10         overridesForChannel (channelId: "bc/store/channel/2") {
11           isFeatured
12         }
13       }
14     }
15   }
16 }

GraphQL variables

1 {
2   "input": {
3     "channelId": "bc/store/channel/2",
4     "productId": "bc/store/product/111"
5   }
6 }

Query featured flag

The following example retrieves whether a product is featured. You can retrieve global information for the store and overrides for a storefront channel.

Request

Response

Example mutation: Get featured flag for a product

1 POST https://api.bigcommerce.com/stores/{{STORE_HASH}}/graphql
2 X-Auth-Token: {{ACCESS_TOKEN}}
3 Content-Type: application/json
4 Accept: application/json
5 
6 query {
7   store {
8     product (id: "bc/store/product/111") {
9       isFeatured
10       overridesForChannel (channelId: "bc/store/channel/2") {
11         isFeatured
12       }
13     }
14   }
15 }