Search documentation

Boolean connectors

Every connector CaseDiver understands, what it does to your search, and the rules the parser actually applies — including the places where our behaviour differs from Westlaw and Lexis.

Start here

You do not need connectors. Type a citation, a case name, or a sentence describing your issue and CaseDiver runs all four of its engines at once. Connectors are for the case where you know exactly which words must appear, and where.

Everything below applies to the term engine — the one that reads opinion bodies word by word. Connectors are ignored by citation lookup and case-name matching, which have nothing to do with the words inside the opinion.

ConnectorMeaning
ANDBoth terms must appear somewhere in the opinion.
OREither term will do.
NOTThe term must not appear.
"exact phrase"These words, in this order, as written.
/sBoth terms in the same sentence.
/pBoth terms in the same paragraph.
w/5Both terms within five words of each other.

Typing no connectors

Two or more words with nothing between them are treated as all required. There is no implicit OR: a query is a set of conditions the opinion has to satisfy, not a bag of hints.

qualified immunity excessive force

All three words must appear in the opinion, anywhere in it.

Does not match: An opinion about qualified immunity that never uses the phrase excessive force.

Common words are dropped from a connector-free query, because they cost recall and buy nothing: the, of, in, is, was, can, and about thirty others. The moment you type any connector this stops — see stemming and noise words.

Capitals matter

AND, OR and NOT are connectors only in capital letters. In lowercase they are ordinary search terms.

This is the one rule worth remembering.

trust and estate searches for the three words trust, and, estate — and since and is a noise word, effectively for trust estate. trust AND estate is a boolean instruction. Both return results. Nothing in the result list tells you which one you ran.

The rule exists because lawyers write ordinary prose into search boxes. act of god and force majeure clause is a phrase someone means literally, and silently converting its and into an operator would change the question being asked. Requiring capitals means a connector is never an accident.

Proximity connectors are the exception: W/5 and w/5 both work, because there is no English word they could be confused with.

AND

Both terms must appear somewhere in the opinion. They can be a hundred pages apart: AND says nothing about where.

respondeat superior AND punitive damages

The opinion contains both concepts, in any order, at any distance.

Because a connector-free query already requires every word, negligence AND causation and negligence causation return the same cases. The one thing typing AND changes is that noise-word filtering switches off for the whole query.

OR

Either term satisfies the search. Use it for the several names one doctrine goes by, or for a statutory term and its shorthand.

rescission OR recission OR cancellation

Any one of the three appears. Useful when the courts themselves are inconsistent — including the common misspelling.

excessive force AND baton OR taser

Excessive force is required, and either baton or taser will satisfy the second half.

OR attaches to the term immediately before it.

The parser reads left to right in a single pass. When it sees OR it takes the previous term back out of the required list and opens an alternatives group with it. The group then stays open and keeps collecting terms until an AND, a NOT or a proximity connector closes it.

So baton OR taser handcuffs reads as baton or taser or handcuffs — not (baton or taser) and handcuffs. If you want the second reading, write it: baton OR taser AND handcuffs.

NOT

Excludes opinions containing the term. NOT applies to the single term that follows it, not to the rest of the query.

qualified immunity NOT prisoner

Qualified immunity is required; any opinion using the word prisoner is dropped.

Does not match: A leading qualified-immunity case that happens to mention a prisoner once, in a footnote.

That last line is the thing to watch. Exclusion is document-wide and absolute: one passing use of the word in an unrelated part of a long opinion is enough to remove it. Prefer narrowing your required terms, or a proximity connector, over excluding a word that might legitimately appear.

To exclude a phrase, quote it: NOT "summary judgment" removes the phrase, while NOT summary judgment excludes only summary and leaves judgment as a required term.

Exact phrase

Double quotes require the words in that order, as a unit. Stemming still applies — "clearly established" also matches clearly establishes. This is the most reliable connector on the page and the most under-used. For an unstemmed word form, use #established instead.

"clearly established law"

The three words adjacent and in order.

Does not match: An opinion saying the law was clearly established, in those words but not that order.

A quoted phrase is also a single operand for every other connector, which is what makes multi-word proximity searches possible:

"deliberate indifference" /s "serious medical need"

Both phrases, intact, in the same sentence.

An unclosed quote is read forgivingly: everything after the quotation mark is treated as the phrase. "good faith exception searches for the phrase good faith exception, which is what was almost certainly meant.

/s — same sentence

Both terms must appear in the same sentence. This is the connector that separates a case that decides your issue from a case that merely mentions both halves of it.

employer /s negligent hiring

The employer and the negligent hiring appear in one sentence — which is where a court states a rule.

Does not match: An opinion discussing employer liability on page 3 and negligent hiring on page 40.

Order does not matter. employer /s negligent and negligent /s employer return the same cases; proximity constrains distance, never sequence. Use a quoted phrase when you need a specific word order.

Both operands also become required terms in their own right, so an opinion missing either word entirely never reaches the proximity check.

/p — same paragraph

Both terms in the same paragraph. Looser than /s and the right choice when a court would state the rule in one sentence and apply it in the next.

"forum non conveniens" /p "private interest factors"

Both phrases in one paragraph — the analysis and the factors it turns on, discussed together.

As a rule of thumb: reach for /p when a single sentence is too tight to hold both ideas, and for /s when you are hunting for the sentence that states a holding.

w/n — within n words

Both terms within n words of each other, in either direction. w/5 and the bare form /5 are the same connector.

summary w/3 judgment

The two words no more than three words apart.

Matches: summary judgment; judgment on summary disposition.

notice w/10 termination

Notice and termination close enough to be about each other — a contract-notice provision rather than two unrelated discussions.

The distance counts words, and the maximum is 255. Small numbers are more useful than large ones: past about twenty words you are describing a paragraph, and /p says that more clearly.

How proximity is verified

Worth knowing, because it explains the one behaviour that looks like a bug and is not.

Postgres full-text search has a single positional operator, a fixed word distance, and no concept of a sentence or a paragraph at all. So proximity cannot be answered by the text index alone. CaseDiver handles it in two stages: the index finds opinions containing all the required terms, then the positional constraint is enforced on top of that result — as a tight word span over the opinion body in the primary index (roughly a sentence for /s, roughly a paragraph for /p), or, on the verification path, by splitting the actual opinion text into sentences and paragraphs and checking each candidate.

That text splitter is written for legal prose specifically. A period after F. Supp., Cir., Inc., Stat. or an initial does not end a sentence, so /s does not silently fail on the citation-dense sentences that matter most.

A proximity search can legitimately return nothing.

The constraint is enforced, not scored. If no opinion puts your two terms in one sentence, the honest answer is an empty list — CaseDiver will not quietly relax /s into AND and hand back cases that do not satisfy what you typed. When that happens, widen deliberately: /s to /p, or a phrase to its terms.

Order of operations

CaseDiver reads a query left to right, once. There is no operator precedence: AND does not bind tighter than OR, and no part of the query is evaluated before another.

Most legal queries are flat runs of terms with the occasional alternatives group, and for those the single pass is exactly right. It matters only when you write something whose meaning depends on grouping.

battery OR assault AND consent

Left to right: an alternatives group of battery/assault is opened, AND closes it, then consent is added as a required term. So: (battery or assault) and consent.

That happens to be the reading most people intend. But do not rely on precedence to get there — rely on order. Put the alternatives together, and close the group with the required term that follows.

Parentheses

Parentheses are stripped, not honoured. They are accepted so that a query pasted from another platform does not error, and they are read as a hint about where an alternatives group belongs — but they do not create nesting.

Do not build a query that depends on nesting.

(battery OR assault) AND (consent OR waiver) does not evaluate as two independent groups. Write the alternatives in order instead, and let each AND close the group before it: battery OR assault AND consent OR waiver.

If a query genuinely needs nested logic, run the halves as two searches. Two clean result lists you can compare beat one query whose grouping you are guessing at.

Stemming and noise words

Terms are matched with English stemming, so a search for one form of a word finds its other forms. negligent finds negligence and negligently; testify finds testified and testimony. You do not need a truncation character, and there is no wildcard to type.

Stemming applies inside quoted phrases too. A phrase constrains word order and adjacency, not exact spelling.

Noise wordsthe, of, in, to, is, was, by, with, what, can and about twenty-five others — are dropped from a query that contains no connectors, because on their own they match everything.

QueryWhat is searched
the duty of careduty, care — the and of are dropped.
duty AND careduty, care — and noise filtering is now off for the whole query.
"act of god" /s negligenceThe phrase intact, including of, plus negligence. A connector is present, so nothing is dropped.

The rule in one line: the moment you type any connector, every word you typed is taken literally. If you meant every word, say so with a connector.

Not supported

Deliberately absent. Each of these either has a better equivalent here or would produce results that only look right.

ElsewhereHere
term!No truncation character. Stemming already covers word forms — search negligent and you get negligence.
te*mNo single-character wildcard.
%No but-not operator. Use NOT.
&Not an AND. Type the word AND in capitals.
+3No directional proximity. w/n is symmetric; use a quoted phrase when order matters.
atleast5(term)No term-frequency operator. Ranking already favours opinions where a term is central rather than incidental.
ti(term)No field restrictions in the query text. Case names have their own engine, and jurisdiction, court and date are filters, not query syntax.

Connectors and the four engines

A CaseDiver search runs up to four engines at once and merges the results. Connectors are instructions to one of them.

EngineWhat connectors do
CitationNothing. A reporter citation or docket number is a lookup; connectors are ignored.
Case nameNothing. Party names are matched by fuzzy name comparison, which tolerates reversed parties, abbreviations and misspellings on its own.
TermsEverything on this page. This is the engine connectors are for.
ConceptNothing directly — it searches by meaning, not by words. A connector-heavy query is not the kind of input it is good at.

Because they run together, a citation in your query is never buried under a loose conceptual match. It also means a connector query and a plain-English query can be mixed: the parts each engine can use are routed to it.

To run the term engine alone, pin the search type to Terms above the search box. Pinning is a real restriction — if a pinned engine has nothing to work with, you get an honest empty result rather than a quiet fallback to a different engine's guesses.

What belongs in a filter instead

Jurisdiction, court level and date are filters, not query terms. This is not a style preference — putting them in the query text actively produces wrong results.

Fifth Circuit qualified immunity

Typed as text, Fifth Circuit is a phrase to match, so an opinion that discusses Fifth Circuit precedent scores well — including a Ninth Circuit case distinguishing it. That is the opposite of what you asked for.

CaseDiver recognises unambiguous court phrases and lifts them into the jurisdiction filter for you, telling you it has done so. But it lifts only the unambiguous ones: a bare state name is left alone, because Texas Instruments and New York Times are parties, not jurisdictions. Set the jurisdiction with the picker and the ambiguity never arises.

The same goes for dates: use the date filters, including the last 5, 10 and 25 year quick ranges, rather than typing a year into the query. A year in the query text is just a number that appears in the opinion.

Worked examples

Queries that use the connectors the way they are meant to be used.

"deliberate indifference" /s "serious medical need"

The Eighth Amendment medical-care standard, stated in a single sentence. Two phrases as proximity operands is the highest-precision query on this page.

employer /s negligent AND hiring OR retention OR supervision

Employer and negligent in one sentence, plus any one of hiring, retention or supervision. The AND closes the sentence pair before the alternatives group opens.

"forum non conveniens" /p "public interest factors" NOT arbitration

Both phrases in one paragraph, with arbitration cases excluded entirely.

notice w/10 cure AND breach

A notice-and-cure provision — the two words close enough to be about each other — in an opinion that also discusses breach.

rescission OR recission AND "material misrepresentation"

Either spelling of rescission, including the misspelling courts frequently use, together with the phrase.

qualified immunity excessive force taser

No connectors at all: all four words required, anywhere in the opinion. Often the right first search — start here, and add connectors only when you have too many results to read.

Try these on the research page →