Skip to main content

Smart Query Syntax

The following are properties you can use to create smart queries to get the results you want. You can use the interface to create your smart query or create a smart query manually.

Creating a smart query manually, allows you to create more complex custom smart queries.

Combine the properties with logical operators to create a custom smart query that results in quickly finding the books you want.

Each property has filter conditions to narrow down the search and options available that correspond to your library. Here's how to use each filter condition when creating a smart query manually.

note

Searches for text are always case insensitive. For example, when searching for "example", any occurrence of "example" is found, such as "example", "Example", and "EXAMPLE".

Whole words vs. partial matches

By default, text properties like title: and summary: match whole words — or a word's grammatical root — rather than any part of a word. For example, title:"secur" matches "security", "secure", and "securing" because they share that root, but title:"secu" and title:"securit" do not. The same applies to inflected forms in other languages: title:"kod" won't match "kodu", and title:"bezpie" won't match "bezpieczeństwo".

To match part of a word, add an asterisk (*) as a wildcard:

  • title:"secu*" — titles starting with "secu" (security, secure, securing…)
  • title:"*code" — titles ending with "code"
  • title:"*secu*" — titles containing "secu" anywhere

You can also use the search box at the top of your library, which searches across all of a book's metadata (including the description) and finds partial words.

Click the following filter conditions to see examples of how to use them.

Contains

To find all books with "jeeves" in the title:

title:"jeeves"

This matches the whole word "jeeves". To match part of a word, add an asterisk (*) wildcard — for example, title:"secu*" (starts with), title:"*code" (ends with), or title:"*secu*" (contains anywhere). See the note near the top of this page for details.

Doesn't contain

To find all books that do not have "jeeves" in the title:

not title:"jeeves"

Is empty

To find all books that are not in any series:

not series:*

Is not empty

To find all books that are in any series:

series:*

Greater than

To find all books that you have read more than 10% of:

progress:>"10"

Less than

To find all books added less than one week ago:

added:<"1 weeks ago"