BigCommerce Docs

curl -X PUT https://api.bigcommerce.com/stores/store_hash/v3/settings/search/filters \
     -H "X-Auth-Token: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '[
  {
    "collapsed_by_default": false,
    "display_name": "Size",
    "display_product_count": true,
    "id": "124",
    "is_enabled": true,
    "items_to_show": 15,
    "sort_by": "alpha",
    "type": "product"
  },
  {
    "collapsed_by_default": false,
    "display_name": "Brand",
    "display_product_count": true,
    "id": "BRD001",
    "is_enabled": true,
    "items_to_show": 10,
    "sort_by": "alpha",
    "type": "brand"
  },
  {
    "collapsed_by_default": false,
    "display_name": "Color",
    "display_product_count": true,
    "id": "CLR002",
    "is_enabled": true,
    "items_to_show": 10,
    "sort_by": "alpha",
    "type": "product"
  },
  {
    "collapsed_by_default": true,
    "display_name": "Ships for Free",
    "display_product_count": true,
    "id": "MISC003",
    "is_enabled": true,
    "items_to_show": 0,
    "sort_by": "alpha",
    "type": "other"
  }
]'

{
  "data": [
    {
      "collapsed_by_default": false,
      "display_name": "Size",
      "display_product_count": true,
      "id": "126",
      "is_enabled": true,
      "items_to_show": 10,
      "sort_by": "alpha",
      "type": "product"
    },
    {
      "collapsed_by_default": false,
      "display_name": "Brand",
      "display_product_count": true,
      "id": "BRD001",
      "is_enabled": true,
      "items_to_show": 10,
      "sort_by": "alpha",
      "type": "brand"
    },
    {
      "collapsed_by_default": false,
      "display_name": "Color",
      "display_product_count": true,
      "id": "CLR002",
      "is_enabled": true,
      "items_to_show": 10,
      "sort_by": "alpha",
      "type": "product"
    },
    {
      "collapsed_by_default": true,
      "display_name": "Ships for Free",
      "display_product_count": true,
      "id": "MISC003",
      "is_enabled": true,
      "items_to_show": 0,
      "sort_by": "alpha",
      "type": "other"
    }
  ],
  "meta": {}
}

Updates enabled default Product Filtering filters.

Updates enabled default [Product Filtering](https://support.bigcommerce.com/s/article/Product-Filtering-Settings) filters.

Authentication

X-Auth-Tokenstring

OAuth scopes

UI Name	Permission	Parameter
Information & Settings	modify	`store_v2_information`
Information & Settings	read-only	`store_v2_information_read_only`

NOTE: Analytics endpoints require the Content (store_v2_content and store_v2_content_read_only) OAuth scope.

Authentication header

Header	Argument	Description
`X-Auth-Token`	`access_token`	For more about API accounts that generate `access_token`s, see our Guide to API Accounts.

### OAuth scopes | UI Name | Permission | Parameter | |:--------|:-----------|:----------| | Information & Settings | modify | `store_v2_information` | | Information & Settings | read-only | `store_v2_information_read_only` | NOTE: Analytics endpoints require the Content (`store_v2_content` and `store_v2_content_read_only`) OAuth scope. ### Authentication header | Header | Argument | Description | |:-------|:---------|:------------| | `X-Auth-Token` | `access_token` | For more about API accounts that generate `access_token`s, see our [Guide to API Accounts](/developer/docs/overview/api-fundamentals/api-accounts#api-accounts). | ### Further reading For example requests and more information about authenticating BigCommerce APIs, see [Authentication and Example Requests](/developer/docs/overview/api-fundamentals/api-accounts#x-auth-token-header-example-requests). For more about BigCommerce OAuth scopes, see our [Guide to API Accounts](/developer/docs/overview/api-fundamentals/api-accounts#oauth-scopes). For a list of API status codes, see [API Status Codes](/developer/api-reference/rest/overview#rest-http-status-codes).

Request

This endpoint expects a list of objects.

EnabledProductFilterobjectRequired

A filter that uses product options and custom field data.

EnabledPriceFilterobjectRequired

A filter based on the product’s price, shown as a price range on the storefront.

EnabledCategoryFilterobjectRequired

A storefront filter for product category

EnabledBrandFilterobjectRequired

A storefront filter for product brand

EnabledRatingFilterobjectRequired

A filter based on product review ratings.

EnabledMiscFilterobjectRequired

Miscellaneous filters which appear as a group.

Response

datalist of objects

metaobject

Response metadata.

Update Enabled Filters

Authentication

OAuth scopes

Authentication header

Further reading

Path parameters

Request

Response

OAuth scopes

Authentication header

Further reading