Docs
Store operations
Catalog and inventory
GraphQL Admin API
Product attributes

Product Attributes

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 (opens in a new tab).

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 (opens in a new tab).

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.

Example mutation: Set pre-order settings at the global level
POST https://api.bigcommerce.com/stores/{{STORE_HASH}}/graphql
X-Auth-Token: {{ACCESS_TOKEN}}
Content-Type: application/json
Accept: application/json
 
mutation ($input: SetProductPreOrderSettingsInput!) {
  product {
    setProductPreOrderSettings (input: $input) {
      product {
        preOrderSettings {
          message
        }
      }
    }
  }
}
GraphQL variables
{
  "input": {
    "productId": "bc/store/product/111",
    "data": {
      "message": "Product will be released soon"
    }
  }
}

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.

Example mutation: Set pre-order settings for a locale
POST https://api.bigcommerce.com/stores/{{STORE_HASH}}/graphql
X-Auth-Token: {{ACCESS_TOKEN}}
Content-Type: application/json
Accept: application/json
 
mutation ($input: SetProductPreOrderSettingsInput!) {
  product {
    setProductPreOrderSettings (input: $input) {
      product {
        overridesForLocale (localeContext: {channelId: "bc/store/channel/2", locale: "fr"}) {
          preOrderSettings {
            message
          }
        }
      }
    }
  }
}
GraphQL variables
{
  "input": {
    "productId": "bc/store/product/111",
    "localeContext": {
      "locale": "fr",
      "channelId": "bc/store/channel/2"
    },
    "data": {
      "message": "Le produit sortira dans un mois"
    }
  }
}

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.

Example mutation: Remove pre-order settings for a locale
POST https://api.bigcommerce.com/stores/{{STORE_HASH}}/graphql
X-Auth-Token: {{ACCESS_TOKEN}}
Content-Type: application/json
Accept: application/json
 
mutation ($input: RemoveProductPreOrderSettingsOverridesInput!) {
  product {
    removeProductPreOrderSettingsOverrides (input: $input) {
      product {
        overridesForLocale (localeContext: {channelId: "bc/store/channel/2", locale: "fr"}) {
          preOrderSettings {
            message
          }
        }
      }
    }
  }
}
GraphQL variables
{
  "input": {
    "productId": "bc/store/product/111",
    "localeContext": {
      "locale": "fr",
      "channelId": "bc/store/channel/2"
    },
    "overridesToRemove": ["PRODUCT_PRE_ORDER_MESSAGE"]
  }
}

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.

Example query: Get pre-order settings for a product
POST https://api.bigcommerce.com/stores/{{STORE_HASH}}/graphql
X-Auth-Token: {{ACCESS_TOKEN}}
Content-Type: application/json
Accept: application/json
 
query {
  store {
    product (id: "bc/store/product/111") {
      preOrderSettings {
        message
      }
      overridesForLocale (localeContext: {locale: "fr", channelId: "bc/store/channel/2"}) {
        preOrderSettings {
          message
        }
      }
    }
  }
}

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.

Example mutation: Set storefront details at the global level
POST https://api.bigcommerce.com/stores/{{STORE_HASH}}/graphql
X-Auth-Token: {{ACCESS_TOKEN}}
Content-Type: application/json
Accept: application/json
 
mutation ($input: SetProductStorefrontDetailsInput!) {
  product {
    setProductStorefrontDetails (input: $input) {
      product {
        storefrontDetails {
          warranty
          availabilityDescription
          searchKeywords
        }
      }
    }
  }
}
GraphQL variables
{
  "input": {
    "productId": "bc/store/product/111",
    "data": {
      "warranty": "1 year warranty",
      "availabilityDescription": "Available in a month",
      "searchKeywords": "Best selling"
    }
  }
}

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.

Example mutation: Set storefront details for a locale
POST https://api.bigcommerce.com/stores/{{STORE_HASH}}/graphql
X-Auth-Token: {{ACCESS_TOKEN}}
Content-Type: application/json
Accept: application/json
 
mutation ($input: SetProductStorefrontDetailsInput!) {
  product {
    setProductStorefrontDetails (input: $input) {
      product {
        overridesForLocale (localeContext: {locale: "fr", channelId: "bc/store/channel/2"}) {
          storefrontDetails {
            warranty
            availabilityDescription
            searchKeywords
          }
        }
      }
    }
  }
}
GraphQL variables
{
  "input": {
    "productId": "bc/store/product/111",
    "localeContext": {
      "locale": "fr",
      "channelId": "bc/store/channel/2"
    },
    "data": {
      "warranty": "Garantie un an",
      "availabilityDescription": "Disponible dans un mois",
      "searchKeywords": "meilleure vente"
    }
  }
}

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.

Example mutation: Remove storefront details for a locale
POST https://api.bigcommerce.com/stores/{{STORE_HASH}}/graphql
X-Auth-Token: {{ACCESS_TOKEN}}
Content-Type: application/json
Accept: application/json
 
mutation ($input: RemoveProductStorefrontDetailsOverridesInput!) {
  product {
    removeProductStorefrontDetailsOverrides (input: $input) {
      product {
        overridesForLocale (localeContext: {channelId: "bc/store/channel/2", locale: "fr"}) {
          storefrontDetails {
            warranty
            availabilityDescription
            searchKeywords
          }
        }
      }
    }
  }
}
GraphQL variables
{
  "input": {
    "productId": "bc/store/product/111",
    "localeContext": {
      "locale": "fr",
      "channelId": "bc/store/channel/2"
    },
    "overridesToRemove": ["PRODUCT_AVAILABILITY_DESCRIPTION_FIELD", "PRODUCT_SEARCH_KEYWORDS", "PRODUCT_WARRANTY"]
  }
}

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.

Example mutation: Get storefront details for a product
POST https://api.bigcommerce.com/stores/{{STORE_HASH}}/graphql
X-Auth-Token: {{ACCESS_TOKEN}}
Content-Type: application/json
Accept: application/json
 
query {
  store {
    product (id: "bc/store/product/111") {
      storefrontDetails {
        warranty
        availabilityDescription
        searchKeywords
      }
      overridesForLocale (localeContext: {locale: "fr", channelId: "bc/store/channel/2"}) {
        storefrontDetails {
          warranty
          availabilityDescription
          searchKeywords
        }
      }
    }
  }
}

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.

Example mutation: Set featured flag at the global level
POST https://api.bigcommerce.com/stores/{{STORE_HASH}}/graphql
X-Auth-Token: {{ACCESS_TOKEN}}
Content-Type: application/json
Accept: application/json
 
mutation ($input: SetProductIsFeaturedInput!) {
  product {
    setProductIsFeatured (input: $input) {
      product {
        isFeatured
      }
    }
  }
}
GraphQL variables
{
  "input": {
    "productId": "bc/store/product/111",
    "data": {
      "isFeatured": true
    }
  }
}

Set featured flag for a channel

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

Example mutation: Set featured flag for a channel
POST https://api.bigcommerce.com/stores/{{STORE_HASH}}/graphql
X-Auth-Token: {{ACCESS_TOKEN}}
Content-Type: application/json
Accept: application/json
 
mutation ($input: SetProductIsFeaturedInput!) {
  product {
    setProductIsFeatured (input: $input) {
      product {
        overridesForChannel (channelId: "bc/store/channel/2") {
          isFeatured
        }
      }
    }
  }
}
GraphQL variables
{
  "input": {
    "channelId": "bc/store/channel/2",
    "productId": "bc/store/product/111",
    "data": {
      "isFeatured": false
    }
  }
}

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.

Example mutation: Remove featured flag for a channel
POST https://api.bigcommerce.com/stores/{{STORE_HASH}}/graphql
X-Auth-Token: {{ACCESS_TOKEN}}
Content-Type: application/json
Accept: application/json
 
mutation ($input: RemoveProductIsFeaturedOverrideInput!) {
  product {
    removeProductIsFeaturedOverride (input: $input) {
      product {
        overridesForChannel (channelId: "bc/store/channel/2") {
          isFeatured
        }
      }
    }
  }
}
GraphQL variables
{
  "input": {
    "channelId": "bc/store/channel/2",
    "productId": "bc/store/product/111"
  }
}

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.

Example mutation: Get featured flag for a product
POST https://api.bigcommerce.com/stores/{{STORE_HASH}}/graphql
X-Auth-Token: {{ACCESS_TOKEN}}
Content-Type: application/json
Accept: application/json
 
query {
  store {
    product (id: "bc/store/product/111") {
      isFeatured
      overridesForChannel (channelId: "bc/store/channel/2") {
        isFeatured
      }
    }
  }
}
Did you find what you were looking for?