Category and Brand Pages in Autocomplete

​

Step-by-step implementation

​

Step 1. Index category and brand page references

{"replace":{"key":"c1","content":{"markets":["uk"],"type":"category","defaults":{"title":"Dresses","url":"/dresses"}}}}
{"replace":{"key":"b2","content":{"markets":["uk"],"type":"brand","defaults":{"title":"Acme Co.","url":"/acme-co"}}}}

​

Step 2. Query autocomplete with content suggestions

{
  "contentLists": [
    {
      "id": "category-suggestions",
      "contentFilter": {
        "type": ["category"]
      }
    },
    {
      "id": "brand-suggestions",
      "contentFilter": {
        "type": ["brand"]
      }
    }
  ]
}

curl -X POST \
  "https://{cluster-id}.elevate-api.cloud/api/storefront/v3/queries/autocomplete?market=US&locale=en-US&sessionKey=4b116e34-0a7a-ce5d-5591-75c62f231967&customerKey=4b116e34-0a7a-ce5d-5591-75c62f231967&touchpoint=DESKTOP&q=acme" \
  -H 'Content-Type: application/json' \
  -d @request-body.json

const api = esales({
  clusterId: "cluster-id",
  market: "uk",
  locale: "en-GB",
  touchpoint: "desktop",
  session: () => ({
    customerKey: "0b05119e-eeb8-418a-bbfb-defa0dde417",
    sessionKey: "0b05119e-eeb8-418a-bbfb-defa0dde417"
  })
});

const results = await api.query.autocomplete(
  { q: "acme" },
  {
    contentLists: [
      {
        id: "category-suggestions",
        contentFilter: {
          type: ["category"]
        }
      },
      {
        id: "brand-suggestions",
        contentFilter: {
          type: ["brand"]
        }
      }
    ]
  }
);

​

Behavior and limitations

• Empty pages, meaning pages without product listings, may still appear as autocomplete suggestions.
• Elevate treats these entries as generic content and does not automatically associate them with actual category or brand structures.

​

Best practices

• Use descriptive values such as “category” or “brand” for the type field.
• Add keywords to maximize discoverability.
• Test autocomplete queries regularly to verify:
  • Correct category and brand suggestions appear.
  • Visitors are redirected to the intended destination pages.

​

Summary