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 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.

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"
        }
      ]
    }
  ]
}