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.
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, .tgaVideo: .mp4, .mxf, .mov, .avi, .mkvAudio: .mp3, .wav, .aac, .m4aSequence: 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, GBExample: 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 ThanExample: 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 ThanExample: 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.
