Skip to main content

Searchable Fields

The Searchable Fields API returns a list of all fields available for searching, filtering, faceting, and sorting in your search queries. This includes both the standard product fields that are indexed by default and any custom fields you've added through Indexable Fields.

Using Searchable Fields

Use this endpoint to:

  • Discover available fields: See all fields that can be used in search queries
  • Build dynamic UIs: Programmatically generate filter and facet options based on available fields
  • Validate configurations: Verify that your indexable fields have been properly added to the schema

Field Properties

Each searchable field includes:

PropertyDescription
nameThe field name to use in search queries
typeThe data type (string, int32, int64, float, bool)
facetableWhether the field can be used for faceting
sortableWhether the field can be used for sorting
localeThe language code for text fields

Standard vs Custom Fields

  • Standard fields: Built-in fields like name, description, sku, meta.search.nodes.name that are always available
  • Custom fields: Fields added through Indexable Fields from your product extensions
Ask External AI