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']
}

Query Expressions

A query expression targets a single field via its key and one of the operators below.

Term

An exact value match.

{
  "key": "metadata.title",
  "term": "My Title"
}

An array behaves like an OR over the values.

{
  "key": "metadata.language.locale",
  "term": ["de", "fr"]
}

Range

Match within a range. Any of gt, gte, lt, lte can be combined.

{
  "key": "metadata.count",
  "range": {"gt": 1, "lt": 5}
}

Exists

Check whether a property is set.

{
  "key": "metadata.teaserImage.mediaId",
  "exists": true
}

Logical Operators

Logical operators group expressions and change the default AND behaviour. Each operator takes an object or an array containing expressions or nested operators.

AND

All conditions must match.

{
  "and": [
    {"key": "metadata.news", "term": true},
    {"key": "metadata.teaserImage.mediaId", "exists": false}
  ]
}

OR

Any condition may match.

{
  "or": [
    {"key": "metadata.image.mediaId", "exists": true},
    {"key": "metadata.teaserImage.mediaId", "exists": true}
  ]
}

NOT

Negate the contained expression.

{
  "not": {"key": "metadata.language.locale", "term": "de"}
}

Example

Logical operators and query expressions can be combined into more complex queries. A top-level array is treated as an AND.

{
  "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}
  ]
}