Product Modifier Options
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 information about a product modifier options, for example, option name and values.
You can perform the following:
- Set global modifier option information for the catalog. Channels inherit these by default.
- Create overrides for a channel locale using the
overridesForLocalemutation. - Remove overrides for a channel locale
- Query modifier option information, those set at the global level and the overrides.
You can also set and remove information for shared modifiers. The changes affect all products that you assign to the shared modifier. Querying modifier options returns all modifiers, including shared ones.
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.
Set product modifier options
Set information about a product modifier option for a store or a locale within a storefront channel.
The following mutations let you set the name and values for existing modifier options. You must first create the modifier option for the product through the control panel or the REST Create a product modifier endpoint.
The responses may include all modifier options, including those that are shared. However, to set shared modifier options, use the mutations in Set shared modifier options.
Set product modifier options at the global level
The following example sets global product modifier information for the store, from which channels inherit by default. You can set the modifier name and values.
Request
Response
Set product modifier options for a locale
The following example sets product modifier option information for the locale within the specified storefront channel. These will override global store information. You can set the modifier option name and values.
Request
Response
Remove product modifier options for a locale
The following example removes product modifier option information for the locale within the specified storefront channel.
Request
Response
Set shared modifier options
You can set information about a shared modifier option for a store or a locale within a storefront channel. You must first create the shared modifier options through the control panel. Changing a shared modifier option affects all products that you assign to the shared modifier option. You cannot customize shared modifier options on a product level.
The following mutations let you set the name and values for existing shared modifiers.
Set shared modifier options at the global level
The following example sets global shared modifier information for the store, from which channels inherit by default. You can set the name and values for existing modifiers.
Request
Response
Set shared modifier options for a locale
The following example sets shared modifier information for the locale within the specified storefront channel. These override global store information. You can set the name and values for existing modifiers.
Request
Response
Remove shared modifier options for a locale
The following example removes shared modifier option information for the locale within the specified storefront channel.
Request
Response
Query modifier options
The following example retrieves modifier information. You can retrieve global information for the store and overrides for the locale within the specified storefront channel. The query returns all modifier options, including those that are shared.
Request
Response
You can retrieve overrides for multiple locales in a channel, as shown in the following example: