| Filter | Type | Examples | Notes |
|---|---|---|---|
| dist | decimal | dist:50 | Distance to Position (km) |
| lat | decimal | lat:41.894043 | GPS Position (Latitude) |
| lng | decimal | lng:-87.62448 | GPS Position (Longitude) |
| 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 | GPS Altitude (m) |
| camera | string | camera:canon | Camera Make/Model Name |
| category | string | category:airport | Location Category |
| city | string | city:"Berlin" | Location City (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) (separate with |) |
| country | string | country:"de|us" | Location Country Code (separate with |) |
| day | string | day:3|13 | Day of Month (1-31, separate with |) |
| 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 images by favorite status |
| filename | string | filename:"2021/07/12345.jpg" | File Name with path and extension (separate with |) |
| folder | string | folder:"*/2020" | Path Name (separate with |), supports * wildcards |
| geo | string | geo:yes | Finds pictures with or without coordinates |
| hash | string | hash:2fd4e1c67a2d | SHA1 File Hash (separate with |) |
| id | string | id:123e4567-e89b-... | Finds pictures by 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 (separate with |) |
| latlng | string | latlng:"name" | GPS 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 (separate with |) |
| near | string | near:pqbcf5j446s0futy | Finds nearby pictures (UID) |
| olc | string | olc:8FWCHX7W+ | OLC Position (Open Location Code) |
| original | string | original:"IMG_9831-112*" | Original file name of imported files (separate with |) |
| path | string | path:2020/Holiday | Path Name (separate with |), 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 | S2 Position (Cell ID) |
| scan | string | scan:true scan:false | Finds scanned photos and documents |
| state | string | state:"Baden-Württemberg" | Location State (separate with |) |
| subject | string | subject:"Jane Doe & John Doe" | Alias for person |
| subjects | string | subjects:"Jane & John" | Alias for people |
| title | string | title:"Lake*" | Title (separate with |) |
| 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 (separate with |) |
| animated | switch | animated:yes | Finds animated GIFs |
| archived | switch | archived:yes | Finds archived pictures |
| error | switch | error:yes | Finds pictures with errors |
| hidden | switch | hidden:yes | Finds hidden pictures (broken or unsupported) |
| landscape | switch | landscape:yes | Finds pictures in landscape format |
| live | switch | live:yes | Finds Live Photos and short videos |
| mono | switch | mono:yes | Finds pictures with few or no colors |
| panorama | switch | panorama:yes | Finds pictures with an aspect ratio > 1.9:1 |
| photo | switch | photo:yes | Finds only photos, no videos |
| portrait | switch | portrait:yes | Finds pictures in portrait format |
| primary | switch | primary:yes | Finds primary JPEG files only |
| private | switch | private:yes | Finds private pictures |
| public | switch | public:yes | Excludes private pictures |
| raw | switch | raw:yes | Finds pictures with RAW image file |
| review | switch | review:yes | Finds pictures in review |
| square | switch | square:yes | Finds images with an aspect ratio of 1:1 |
| stack | switch | stack:yes | Finds pictures with more than one media file |
| stackable | switch | stackable:yes | Finds pictures that can be stacked with additional media files |
| unsorted | switch | unsorted:yes | Finds pictures not in an album |
| unstacked | switch | unstacked:yes | Finds pictures with a file that has been removed from a stack |
| vector | switch | vector:yes | Finds vector graphics only |
| video | switch | video:yes | Finds video files only |
| added | timestamp | added:"2006-01-02T15:04:05Z" | Finds pictures added at or after this time |
| after | timestamp | after:"2022-01-30" | Finds pictures taken on or after this date |
| before | timestamp | before:"2022-01-30" | Finds pictures taken on or before this date |
| edited | timestamp | edited:"2006-01-02T15:04:05Z" | Finds pictures edited at or after this time |
| taken | timestamp | taken:"2022-01-30" | Finds pictures taken on the specified date |
| updated | timestamp | updated:"2006-01-02T15:04:05Z" | Finds pictures updated at or after this time |
PhotoPrism® Documentation
For detailed information on specific product features, services, and related resources, see our Knowledge Base, or read the User Guide for help using the web user interface: