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.
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
- Properties
- Smart Query Examples
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"
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.
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")
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:
-
KorKBfor kilobytes -
MorMBfor megabytes -
GorGBfor 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"
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:
- 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.
If you're only searching for books shared with one friend list, you do not need the parentheses:
friend_lists:"Close"
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:*