ESCI Label Scheme

The ESCI label scheme grades a (query, product) pair as Exact, Substitute, Complement or Irrelevant. It was introduced with Amazon’s Shopping Queries Dataset and has since travelled well beyond it: in-house judgment programs, LLM-judge guidelines and relevance models now use the four grades without touching the dataset itself. The scheme matters because it labels shopping intent rather than text match.


The Four Grades

GradeLabelMeaning
EExactThe product directly matches the query
SSubstituteThe product could stand in for what was asked, but isn’t an exact match
CComplementThe product goes with what was asked — an accessory or companion item
IIrrelevantThe product is not relevant to the query

Substitute and Complement are the two near-misses that dominate product search: a product that could replace the requested one, and a product that is used together with it. A binary relevant/not-relevant scale has to fold one or both of them into a single bucket; ESCI keeps them apart.

Why It Differs from Topical Relevance

In web or document search, relevance is mostly topicality — is the result about the query? For e-commerce, Do LLM Judges Actually Agree With Us argues that the useful grading is substitutability: ESCI is a judgment about shopping intent rather than about text, and that relocates the hard boundary. A phone case is topically about the phone, but it is a Complement, not an answer to the query for the phone.

Compared with the label schemes of the other public e-commerce sets (see E-commerce Search Evaluation Datasets):

SchemeUsed byGrades
ESCIAmazon ESCI Dataset, ESCI-S DatasetExact / Substitute / Complement / Irrelevant
Exact / Partial / IrrelevantWANDS DatasetNear-misses collapsed into one Partial grade
Continuous 1–3Home Depot Product Search RelevanceAveraged crowd scores
BinaryMS MARCORelevant / not relevant

WANDS’s single Partial grade is simpler to annotate, but you can’t tell a substitute from an accessory.

Using the Grades

As graded evaluation labels. Because the grades are ordinal, they can serve as gain values for NDCG directly, which binary relevance sets cannot.

As training data. The standard construction for fine-tuning a retriever treats Exact and Substitute as positives and drops Complement, since a complementary product is a different intent rather than a relevance signal. Fine-Tuning Sparse Embeddings for E-Commerce Search trains SPLADE this way.

As a diagnostic. The grades can also be turned into retrieval metrics. In Distilling Retrieval Pipelines to a Single Embedding Model, Daniel Tunkelang tracks an “ESCI precision” and a complement retrieval rate: across 74K queries, his fine-tuned query encoder moved ESCI precision from 96.0% to 97.0% and cut the complement retrieval rate from 14.2% to 7.7% compared with the model before fine-tuning — one experiment on his own pipeline.

The four grades can also be the output of a judge rather than its target. In Using Jev as a Search Reranker - Benchmarks and How to Implement, Jev returns a probability for each relationship, and the ranking score is an expected utility over them: 1.00·P(exact) + 0.55·P(substitute) + 0.15·P(complement), with irrelevant worth 0. The weights are the application’s statement of how much a substitute is worth against an exact match. That is the value judgement the scheme leaves open, here made explicit and tunable. It also separates a 99%-exact candidate from one split 51/49 between exact and substitute, which a hard label cannot do.

Adoption Beyond the Dataset

Where the Scheme Is Hard

The grade boundaries are not equally easy to judge.

  • Graded near-misses are the weak boundary for LLM judges. Allegro’s judge reached per-class F1 around 0.94 on exact matches and 0.83 on complements, but only 0.51 and 0.33 on its own finer split of the substitute region (“highly substitutable” vs. “substitutable”). Exact-vs-garbage is easy; substitute-vs-slightly-worse-substitute is not.
  • Exact vs. Complement leaks. sQuIrRel’s one systematic error was complementary product-type confusion, which the paper puts at around 20% — vacuum cleaner for the query “vacuum cleaner handle” — and which looks like an exact-versus-complement miss.
  • Human labels are noisy too. The public ESCI labels were crowdsourced before LLM labeling, so label noise should be expected.

Datasets

People