This option specifies a list of terms allowed to be displayed in faceted navigation values.

This option applies to all facets, see faceted_navigation.white_list.[facet] for setting a white list for a specific facet.

The value is a comma separated list of terms. Only the term from this list will be displayed as values for the given facet. The matches are case-insensitive.

Setting the key

Set this configuration key in the search package or data source configuration.

Use the configuration key editor to add or edit the faceted_navigation.white_list key, and set the value. This can be set to any valid List<String> value.

Default value

Empty (no whitelist)


Only allow "Sydney" on every facet:



  • Because the list is comma-separated, whitelisting values that contain comma is not possible. To whitelist faceted navigation categories creating commas, a custom plugin is required.