Advanced Search Reference 📰

Create expansive search criteria, and save the searches for repetitive use. Saved searches expand beyond our filters and descriptive metadata to locate your media.


How to Use an Advanced Search Query

Search Syntax

Text Searching:

title:"Here is an example with spaces"


The left-hand side of the colon (:) is the field within Imagen to be searched

The right-hand side of the colon (:) is the term to be searched for

Date Ranges:

dateTime:[2021-01-01 TO 2021-02-01]

Between two dates

dateTime:[2021-01-01 TO *]

After a given date

dateTime:[* TO 2021-01-01]

Before a given date

Imagen Syntax Examples:

Record Number

This could return a single record but could contain a range of or list of IDs

"recordID":[Record ID goes here]


This is a standard text search, looking for matches where a certain term has been matched

"Description": "[Description goes here]",

Record ACL

This could be useful when looking for records to which a certain user/group of users have access

User ID(s) below

"writeAccess": [User ID(s) go here],

"readAccess":[User ID(s) go here],

"mediaDownloadAccess":"[User ID(s) go here]"

💡Pro Tip: follow this guide on user management to find your user ID(s)

Record Creation Date and Time

The DateTime of when your record was created. This could be a date range.

"Creation_Date_and_Time": "[2021-01-01T00:01:00Z TO 2021-02-01T00:02:00Z]"

Media Extension

The media extension of any media attached to your records. You may get many results. 

"mediaElementExtension":"[jpg mp4 mov etc.]"

Media Archived Time

The datetime of when your media was successfully stored. This will not include failed media.

"mediaArchivedTime":"[2021-01-01 TO 2021-02-01]"

Media Object Number

The Integer ID of your media object

"mediaObject":[Media Object ID goes here]

Original File Name

This is normally the location from which the media was ingested.  


💡Pro tip: This could be used to return all records where some media has been ingested from a specific location. To do this simply strip out the '/'s, for example:


Media Type

This will return all records that contain a specific media type


Media Object State

This will return any records with at least one piece of archived or failed media. This can be used to quickly return all records that have failed media



This will return all records where annotations are present

annotations:[* TO *]

This will return all records where annotations are NOT present

-annotations:[* TO *]

The difference here is the '-' at the beginning of the query. This reverses the query to a negative match

💡Pro Tip: Search queries can be combined by using the AND, OR, NOT, operators

Follow this link for more information on the solar query parser: Solr query parser