Gallery Search

Gallery Search

Photosphere includes a search box that filters the photos and videos shown in the gallery. This page describes the full search syntax.

Opening the Search Box

Click the search icon in the navigation bar to open the search input. The search applies automatically as you type (after a short pause). You can press Enter to apply it immediately. Press Escape or click the close button to dismiss the search.

Free-Text Search

Type any word to search across the standard fields: the original file name and path, location, description, and labels.

beach

Multiple words are combined with AND logic, all terms must match:

beach sydney

Field-Specific Search

Use .field=value to restrict a term to a specific field:

.location=sydney
.description=sunset

Field names are case-insensitive and matched as substrings, so .loc=sydney also works.

Label Search

Labels are tags you attach to photos and videos. The .labels= syntax provides dedicated operators for filtering by labels.

Single label

Find items where any label contains the given text:

.labels=birthday

Multi-word label

Wrap the value in double quotes to match a label that contains spaces:

.labels="one thing"

OR, either label

Use | to match items that have a label matching any of the alternatives:

.labels=birthday|vacation
.labels="one thing"|"another label"

AND, all labels present

Use & to match items that have labels matching all of the specified values:

.labels=birthday&family
.labels="one thing"&"another label"

Empty labels

Use - to find items that have no labels at all:

.labels=-

Combining Terms

You can combine label searches with other terms. Multiple space-separated tokens are always AND-ed together:

.labels=birthday beach

This finds items tagged with "birthday" that also contain "beach" in any field.

.labels=birthday .location=sydney

This finds items tagged with "birthday" taken in Sydney.