Skip to content

Updating SAPI Facets

Michael Wynne edited this page Jan 23, 2026 · 1 revision

Updating SAPI and Facets

Necessary to do if you have custom taxonomies that NEED to be included as a facet on browse pages.

  1. /admin/config/search/search-api

    • Choose the relevant index/indices > fields.
  2. Using DH as an example: /admin/config/search/search-api/index/mukurtu_default_content_index/fields

    • "Add field"
    • Find the taxonomy > "Expand"
    • Find the "Name" subfield, eg: field_fish_species:entity:name > "Add"
    • Repeat as needed > "Done"
    • Update machine name(s), and set type to fulltext (this can be string if you DON'T need facets?) > Save changes
  3. Re-index

  4. /admin/config/search/facets

    • "Add facet"
    • Have to do per-field, per-block, per-page (as needed)? Unclear
  5. Clear caches

Clone this wiki locally