Filter Type Examples Notes
dist decimal dist:50 Maximum Distance to Position in km
lat decimal lat:41.894043 Position Latitude (-90.0 to 90.0 deg)
lng decimal lng:-87.62448 Position Longitude (-180.0 to 180.0 deg)
chroma number chroma:70 Chroma (0-100)
diff number diff:-1 diff:2 Differential Perceptual Hash (000000-FFFFFF)
quality number quality:0 quality:3 Minimum quality score (1-7)
album string album:berlin Album UID or Name, supports * wildcards
albums string albums:"South Africa & Birds" Album Names (combinable with & and |)
alt string alt:300-500 Altitude (m)
camera string camera:canon Camera Make/Model Name
caption string caption:"Lake*" Searches Captions (separate terms with | or use false to find pictures without a Caption)
category string category:airport Location Category
city string city:"Berlin" Location City (separated by |)
codec string codec:avc1 Media Codec (e.g. jpeg, avc1, hvc1); separate with |
color string color:"red|blue" Color Name (purple, magenta, pink, red, orange, gold, yellow, lime, green, teal, cyan, blue, brown, white, grey, black) (separated by |)
country string country:"de|us" Location Country Code (separated by |)
day string day:3|13 Day of Month (1-31, separate with |)
description string description:"Lake*" Searches Titles and Captions (separate terms with | or use false to find pictures without a Title or Caption)
f string f:2.8-4.5 Aperture (f-number)
face string face:PN6QO5INYTUSAATOFL43LL2ABAV5ACZG Face ID, yes, no, new, or kind
faces string faces:yes faces:3 Minimum number of Faces (yes = 1)
favorite string favorite:true favorite:false Finds favorites
filename string filename:"2021/07/12345.jpg" File Name with path and extension (separated by |)
folder string folder:"*/2020" Path Name (separated by |), supports * wildcards
geo string geo:yes Pictures with or without Position
hash string hash:2fd4e1c67a2d SHA1 File Hash (separated by |)
id string id:123e4567-e89b-... Exif UID, XMP Document ID or Instance ID
iso string iso:200-400 ISO Number (light sensitivity)
keywords string keywords:"sand&water" Keywords (combinable with & and |)
label string label:cat|dog Label Names (separated by |)
latlng string latlng:49.4,13.41,46.5,2.331 Position Bounding Box (Lat N, Lng E, Lat S, Lng W)
lens string lens:ef24 Lens Make/Model Name
mm string mm:28-35 Focal Length (35mm equivalent)
month string month:7|10 Month (1-12, separate with |)
mp string mp:3-6 Resolution in Megapixels (MP)
name string name:"IMG_9831-112*" File Name without path and extension (separated by |)
near string near:pqbcf5j446s0futy Finds nearby pictures (UID)
olc string olc:8FWCHX7W+ Open Location Code (OLC)
original string original:"IMG_9831-112*" Original file name of imported files (separated by |)
path string path:2020/Holiday Path Name (separated by |), supports * wildcards
people string people:"Jane & John" Subject Names (combinable with & and |)
person string person:"Jane Doe & John Doe" Subject Names, exact matches (combinable with & and |)
s2 string s2:4799e370ca54c8b9 Position (S2 Cell ID)
scan string scan:true scan:false Finds scanned photos and documents
state string state:"Baden-Württemberg" Location State (separated by |)
subject string subject:"Jane Doe & John Doe" Alias for person
subjects string subjects:"Jane & John" Alias for people
title string title:"Lake*" Searches Titles (separate terms with | or use false to find pictures without a Title)
type string type:raw Media Type (image, video, raw, live, animated); separate with |
uid string uid:pqbcf5j446s0futy Limits results to the specified internal unique IDs
year string year:1990|2003 Year (separated by |)
animated switch animated:yes Finds animated content only
archived switch archived:yes Archived pictures
audio switch audio:yes Finds audio content only
document switch document:yes Finds PDF documents only
error switch error:yes Pictures with errors
hidden switch hidden:yes Finds hidden pictures (broken or unsupported)
image switch image:yes Finds regular photos and images only
landscape switch landscape:yes Landscape format
live switch live:yes Finds Live Photos and short videos
media switch media:yes Finds Live Photos, videos, audio and animated content
mono switch mono:yes Pictures with few or no colors
panorama switch panorama:yes Pictures with an aspect ratio > 1.9:1
photo switch photo:yes Finds regular photos and images, as well as RAW and Live Photos
portrait switch portrait:yes Portrait format
primary switch primary:yes Finds primary JPEG files only
private switch private:yes Private pictures
public switch public:yes Excludes private pictures
raw switch raw:yes Finds RAW photos only
review switch review:yes Pictures in review
square switch square:yes Aspect ratio of 1:1
stack switch stack:yes Pictures with more than one media file
stackable switch stackable:yes Pictures that can be stacked with additional media files
unsorted switch unsorted:yes Pictures not in an album
unstacked switch unstacked:yes Pictures with a file that has been removed from a stack
vector switch vector:yes Finds vector graphics only
video switch video:yes Finds videos not categorized as Live Photos
added timestamp added:"2006-01-02T15:04:05Z" Pictures added at or after this time
after timestamp after:"2022-01-30" Pictures taken on or after this date
before timestamp before:"2022-01-30" Pictures taken on or before this date
edited timestamp edited:"2006-01-02T15:04:05Z" Pictures edited at or after this time
taken timestamp taken:"2022-01-30" Pictures taken on the specified date
updated timestamp updated:"2006-01-02T15:04:05Z" Pictures updated at or after this time

PhotoPrism® Documentation

For more information on specific features, services and related resources, please refer to the other documentation available in our Knowledge Base and User Guide: