Expert Search

Added in: release-2026-07

The Expert Search display filter (liExpertSearch) lets power users filter a dashboard by writing a filter expression as JSON, directly in the search UI. It is a display filter, so it can be enabled on any dashboard that supports displayFilters, typically Media Library and table dashboards.

The expression uses the Livingdocs Search Filter DSL. It is validated as you type (an invalid expression is highlighted), can be auto-formatted, and is applied with the Execute button or Ctrl/Cmd+Enter. The resulting filter is merged with the dashboard’s other active filters.

Any indexed field can be queried. Make sure the metadata properties you filter on are set up as indexed fields, see Metadata.

Configuration

Add liExpertSearch to a dashboard’s displayFilters:

{
  handle: 'myDashboard',
  displayFilters: ['liExpertSearch']
}

Filter Expressions

Expert Search uses the Search Filters Query DSL. Every query expression and logical operator documented there is available, written as JSON with quoted keys and double-quoted strings.

{
  "or": [
    {
      "and": [
        {"key": "metadata.count", "range": {"lte": 2}},
        {"key": "metadata.active", "exists": true},
        {"not": {"key": "metadata.title", "term": "My Title"}}
      ]
    },
    {"key": "metadata.count", "term": 3}
  ]
}

A top-level array is treated as an AND.

Searching nested fields

Added in: release-2026-09

The nested operator matches a list of sub-objects, such as a media library entry’s usage log, where several conditions must hold on the same entry.

{
  "key": "usageLog",
  "nested": [
    {"key": "purpose", "term": "print"},
    {"key": "publicationDate", "range": {"gte": "now-2y"}}
  ]
}

Which usage log fields are indexed, and how to make per-purpose params searchable, is described in the Usage Log guide.