Overview

Control how individual fields match with $smart,$eq, $in, range,$phrase, $fuzzy,$regex, and $boost field operators in Upstash Redis Search.

Field operators provide precise control over how individual fields are matched. Use these when simple value matching doesn’t meet your needs.

Quick Reference

Operator	Supported Field Types	Description	Example
$smart	all	Intelligent multi-stage matching (default behavior)	{"name": {"$smart": "wireless"}}
$eq	all	Exact equality	{"status": {"$eq": "active"}}
$in	all	Match any of multiple values	{"status": {"$in": ["active", "pending"]}}
$gt, $gte, $lt, $lte	numeric, date, keyword	Range comparison	{"price": {"$gt": 10, "$lt": 100}}
$phrase	text	Phrase matching with optional slop and prefix	{"text": {"$phrase": {"query": "hello world", "slop": 1}}}
$fuzzy	text	Typo-tolerant matching (Levenshtein distance)	{"name": {"$fuzzy": {"term": "wireles", "distance": 1}}}
$regex	text	Regular expression pattern matching	{"name": {"$regex": "wire.*"}}
$boost	modifier (on any operator)	Adjust relevance score weight	{"name": {"$eq": "wireless", "$boost": 2.0}}