Facets / Specifications

Facets are a way to provide structured details about a product, for example screen size.
They are grouped under a heading, to allow relevant information to be grouped together.

They are used in several ways:

  • Showing structured specifications on product detail pages
  • They provide the values by which each product Variant differs on
  • Certain facets can be used as filters on the site
Facets are visible on the product detail pageFacets are visible on the product detail page

Facets are visible on the product detail page

Facets are made up of three things:

  • The “Group”
    • The heading in the above screenshot, eg, “Audio”
    • Note: Groups are restricted - there is a set list of groups to choose from, see the page Groups for options.
  • The “Type”
    • The name of the facet, eg “Colour”
  • The “Value”
    • The value of the facet.

Filterable Facets

Certain facets are filterable when browsing products on Kogan.com

These facets have validation on them to ensure a consistent set of filterable values, and will return a "warning" in the API if you provide a value that is not valid.
We recommend that you check these warnings and correct the values, so your product can be filtered within the list view, otherwise when a customer applies the filter, your products will not be displayed.

Example of filterable facets on Kogan.comExample of filterable facets on Kogan.com

Example of filterable facets on Kogan.com

Examples

{
  "product_sku": "9780008287047",
  ...
  "facets": [
    {
      "group": "Details",
      "items": [
        {
          "type": "Isbn",
          "value": "9780008287047"
        },
        {
          "type": "Binding",
          "value": "Paperback"
        },
        {
          "type": "Publication Date",
          "value": "30/12/2019"
        },
        {
          "type": "Language",
          "value": "ENG"
        },
        {
          "type": "Number Of Pages",
          "value": "352"
        },
        {
          "type": "Product Type",
          "value": "Book"
        },
        {
          "type": "Publisher",
          "value": "HarperCollins Publishers"
        }
      ]
    }
  ]
}

Did this page help you?