Skip to content

Search Filters in MediaHub

MediaHub includes an advanced search panel that allows users to filter and locate media files with precision. Each parameter refines search results based on file attributes, size, type, tags, and other criteria.

At the top left, next to the MediaHub logo, you’ll find the search bar. You can also jump straight to it with Ctrl+F (Cmd+F on macOS). As you type, matching assets are offered underneath it: use Down and Up to step through them and Enter to open the highlighted one. Enter with nothing highlighted runs the search itself.

add source to ingest

Beside it, click the Filters button     to open the filter panel and configure the search parameters as needed:

Filter Description Options / Examples
Type Defines the type of media files to include in the search. All Types, Image, Video, Audio, Sequence
Extensions Narrows the search to specific file extensions. The list offered depends on the selected Type. Image: .png, .jpg, .jpeg, .tga
Video: .mp4, .mxf, .mov, .avi, .mkv
Audio: .mp3, .wav, .aac, .m4a
Sequence: png, jpg, vbn
Search Searches by filename or part of a filename. Example: typing logo returns all files containing “logo”.
Size Filters by file size. The unit selector next to the value decides what the number means; units are binary, so 1 KB is 1024 bytes. Operators: Greater Than (greater than or equal to), Less Than (less than or equal to)
Units: KB, MB, GB
Example: Greater Than 10 MB
Date Created Filters by the creation date of the file. All Times, Today, Yesterday, Last 7 Days, Last 30 Days, Last 90 Days, Custom
Tags Filters media by assigned tags. Example: Promo, Sports, Branding
Search Folder Selects which folder(s) to include in the search. All (default) or Current Folder
Aspect Filters by aspect ratio (width-to-height). 16:9, 4:3, 3:2, 3:1, 2:1, Square, Horizontal, Vertical. The aspect ratio of the currently selected asset is added to the list when it is not one of these.
Width Filters by file width (in pixels). Operators: Greater And Equal Than, Greater Than, Not Equal, Equal, Less Than, Less And Equal Than
Example: Width Greater Than 1920
Height Filters by file height (in pixels). Operators: Greater And Equal Than, Greater Than, Not Equal, Equal, Less Than, Less And Equal Than
Example: Height Greater Than 1080
Has Alpha Filters by the presence of an alpha channel (transparency). Yes, No
Clear Resets all filters to default values. -
Search Executes the search using the selected filters. -

Search syntax

The same filters can be typed straight into the search bar, which is often faster than opening the panel. Terms are separated by commas or spaces, and anything that is not recognised as a term is treated as free text to match against the file name.

Term Meaning Example
type: Restrict to a media type type:image
extensions: One or more extensions, comma separated extensions:.png,.jpg
size: File size with an operator and a unit size:>=10MB, size:<=500KB
tags: One or more tags, separated by spaces tags:promo sports
root: Restrict the search to a folder path root:/Promos/
width: / height: Pixel dimensions with an operator width:>1920, height:<=1080
has-alpha: Transparency has-alpha:true
aspect: Aspect ratio aspect:16:9

The supported operators are >=, <=, !=, ==, > and <. size: is the exception: it takes only >= or <=, or no operator at all, in which case the size has to match exactly.

Writing a size

In the search bar, size: needs a whole number followed immediately by KB, MB or GB, written in capitals - size:>=10MB. That is the only form the search bar understands: size:>10mb, size:>=1.5GB and size:>=10 MB are not read as a size, and the search does not filter by size. Use the Size filter in the panel if you are unsure.

The server is more forgiving than the search bar, which matters when you search through the API: there a size may be a plain number, which is read as a count of bytes, or a number with a KB, MB or GB suffix in any case and with an optional decimal point, with or without a space before it - 2048, 500kb, 1.5 GB. Sizes are converted using 1024, so 1MB is 1048576 bytes.

Note

A size the server cannot read is dropped rather than rejected: the search still runs, and returns results of every size. If a size search comes back with obviously too many hits, check the way the size was written.

For example, type:video, size:>=50MB, root:/Promos/ opening finds videos of at least 50 MB under /Promos whose name contains “opening”.

Note

Search is served by the MediaHub search engine, which indexes each asset's name, tags, path and custom meta fields. If searching returns no results at all - in particular after upgrading MediaHub - rebuild the index with Reindex Search on the Admin Dashboard.

Usage Examples

  • Find all videos larger than 50 MB created in the last 7 days.
  • Search for all images with alpha channel (Has Alpha: Yes) used in branding tags.
  • Locate 16:9 images wider than 1920 px from a specific folder.