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".

Filter Conditions

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"

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"

Properties

Click the following properties to see examples of how to use them in a manual query.

title

To find all books with specific text in the title:

title:"jeeves"

summary

To find all books with specific text in the summary:

summary:"jeeves"

tags

To find all books with specific tags:

tags:("comedy","humor")

If you're only searching for one tag, you do not need the parentheses:

tags:"comedy"

authors

To find all books by more than one author:

authors:("Agatha Christie","Dorothy L. Sayers")

If you're only searching for one author, you do not need the parentheses:

authors:"Agatha Christie"

series

To find all books in more than one series:

series:("Hercule Poirot","Lord Peter Wimsey")

If you're only searching for one series, you do not need the parentheses:

series:"Hercule Poirot"

lists

To find all books in specific lists:

lists:"currently_reading" and lists:"plan_to_read"

Books found using the above smart query will be in both lists. To find all books in either list, use "or" instead of "and".

lists:"currently_reading" or lists:"plan_to_read"

The following options are available for lists:

• favorites
• currently_reading
• plan_to_read
• completed

shelves

To find all books on specific custom shelves:

shelves:("British Mysteries","Comedy")

You can add any custom shelves to this smart query, except for smart shelves.

note

If you're only searching for one bookshelf, you do not need the parentheses:

shelves:"British Mysteries"

categories

To find all books in specific categories:

categories:("Humor & Entertainment","Mystery, Thriller & Suspense")

note

If you're only searching for one category, you do not need the parentheses:

categories:"Humor & Entertainment"

For a full list of categories, use the Smart Query dialog.

language

To find all books in a particular language:

language:"en"

Here are some of the languages available with the abbreviations to use in a manual smart query.

• English: en
• Chinese: zh
• Hindi: hi
• Spanish: es
• Arabic: ar
• French: fr
• Bengali: bn
• Portuguese: pt
• Russian: ru
• Urdu: ur

For a full list of languages, use the Smart Query dialog.

progress

To find all books you have made a certain percentage of progress in:

progress:<"10"

added

To find all books added within a certain amount of time:

added:<"1 weeks ago"

The following options are available for the time frame:

• days
• weeks
• months
• years

last_read

To find all books last read within a certain amount of time:

last_read:<"10 days ago"

The following options are available for the time frame:

• days
• weeks
• months
• years

file_size

To find all books of a certain size:

file_size:>"1GB"

For the unit of measurement, you can specify the following abbreviations:

• K or KB for kilobytes

• M or MB for megabytes

• G or GB for gigabytes.

If you do not specify a unit of measurement, bytes will be used by default.

highlights_count

To find all books with less than or greater than a certain number of highlights:

highlights_count:>"10"

format

To find all books that are in a specific format:

format:"epub"

To find multiple formats:

format:"epub" or format:"pdf"

note

Do not use and in the above smart query. That would mean that one book is in two formats at once.

The available formats are:

• pdf
• epub
• comic

type

To find all books that are in a specific format:

types:"book"

The available types are:

• book
• article

Published

To find all books published within a certain amount of time or date:

published:<"1 weeks ago"

The following options are available for the time frame:

• days
• weeks
• months
• years

Privacy

To find all books based on the privacy assigned to those books:

privacy:"friends"

The following options are available for privacy:

• only_me
• family
• friends
• friends_of_friends
• public
• friend_lists

Friends List

To find all books on specific friends list :

friend_lists:("Close","Open Minded")

You can add any custom friends list to this smart query.

note

If you're only searching for books shared with one friend list, you do not need the parentheses:

friend_lists:"Close"

Smart Query Examples

Here are some examples of more complex manual smart queries you might want to do:

• Find books with the fiction tag that don't belong to any shelf:

  tags:fiction and not shelves:*

• Find completed books that either have the fiction tag or belong to the "Literature & Fiction" category:

  lists:completed and (tags:fiction or categories:"Literature & Fiction")

• Find books that got added earlier than 1 week ago and aren't marked as Plan to Read or Completed:

  added:<"1 week ago" and not lists:(plan_to_read, completed)

• Find books that have No Summary or Description:

  not summary:*