Metadata Filtering

Kavita has a rich metadata interface that allows you to build complex filters to find exactly what you're looking for. The system allows you to build a series of statements that AND or OR together with custom sorting and a limit feature for those that have large libraries.


Filter Fields

FieldField TypeDescription
Series NameStringThe Name of the Series
SummaryStringThe Summary of the Series
PathStringThe file path to the highest level of the Series
File PathStringThe full file path for any file within the Series (note: this is slower than other fields)
Read TimeNumberNumber of hours to read the Series
Release YearNumberThe Release year of the Series (minimum from all chapters)
Read ProgressNumberDecimal percentage of Series that is read by user
User RatingNumberUser Rating percentage of Series by user
Publication StatusSingle/Multi SelectPublication Status of Series (ie Complete, Hiatus, etc)
LanguagesSingle/Multi SelectLanguage of Series
Age RatingSingle/Multi SelectAge Rating of Series
People*Single/Multi SelectPerson of some Role that is on the Series
GenresSingle/Multi SelectGenre in Series
TagsSingle/Multi SelectTag in Series
Collection TagSingle/Multi SelectSeries that belongs in a Collection
FormatSingle/Multi SelectSeries Format (epub, archive, etc)
Want To ReadBooleanIf Series is in the user's Want To Read list
Reading DateDateLatest date the Series was read by the user
  • People refers to fields such as Translator, Editor, Inker, etc

Filter Combination

Filter CombinationApplies onDescription
EqualString/Number/Multi SelectEquals exactly
Not EqualString/Number/Multi SelectDoesn't Equal
Begins WithStringStarts with string
Ends WithStringEnds with string
MatchesStringApplies a search-like match on the field
Is BeforeDateDate is before X
Is AfterDateDate is after X
Less ThanNumberLess than X
Less Than EqualNumberLess than or Equal to X
Greater ThanNumberGreater than X
Greater Than EqualNumberGreater than or Equal to X
ContainsMulti SelectThe Filter Field contains at least one entry of what is passed
Must ContainsMulti SelectThe Filter Field contains all of what is passed
Must Not ContainsMulti SelectThe Filter Field contains none of what is passed

Smart Filters

A Smart Filter is essentially a saved filter. The underlying filter can be loaded and changed and anything that is bound with the Smart Filter will automatically be reflected in the new filters. Once you have a Smart Filter created, check out Customization (opens in a new tab) to learn about how you can utilize the filters.

To create a Smart Filter, just add a name in the Name field and hit Save. Smart Filter names must be unique per user. Smart Filters are user-bound.