StorefrontCategorySettings

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/bigcommerce/main/json-schema/bigcommerce-storefront-category-settings-schema.json",
  "title": "StorefrontCategorySettings",
  "x-generated": "2026-10-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/bigcommerce-storefront-category-api-openapi.yml#/components/schemas/StorefrontCategorySettings",
  "type": "object",
  "properties": {
    "category_tree_depth": {
      "type": "integer",
      "maximum": 8,
      "minimum": 1
    },
    "default_product_sort": {
      "$ref": "#/$defs/ProductSortEnumValues"
    },
    "listing_mode": {
      "$ref": "#/$defs/CategoryListingModeEnumValues"
    }
  },
  "x-tags": [
    "Models"
  ],
  "$defs": {
    "CategoryListingModeEnumValues": {
      "type": "string",
      "enum": [
        "current_category_only",
        "child_categories",
        "child_categories_if_category_empty"
      ],
      "title": "CategoryListingModeEnumValues",
      "x-tags": [
        "Models"
      ]
    },
    "ProductSortEnumValues": {
      "description": "The available sorts for PLP pages.",
      "type": "string",
      "default": "bestselling",
      "enum": [
        "featured",
        "bestselling",
        "newest",
        "alphaasc",
        "alphadesc",
        "pricedesc",
        "priceasc",
        "avgcustomerreview",
        "relevance"
      ],
      "title": "ProductSortEnumValues",
      "x-internal": false
    }
  }
}