Advanced search

The advanced search feature enables you to search for media assets in your account by specifying a large variety of filtering criteria to help you find assets that meet the design and content needs of your application. To open the advanced search form, click the arrow to the right of the Search bar. As you select search criteria, each one is added to the search bar at the top.

Search guidelines

• By default, searches find assets in all folders. To search for results only within a specific folder (and its subfolders), specify the Folder in the Advanced Search Tags and Metadata tab.
• You can filter the results you see by selecting the media type: Images, Video & Audio, or Others (Raw), from the Asset type filter, located at the left edge of the Search bar, or select All to include all media types.
• To view all assets from all folders in a single display, make sure All is selected in the Asset type filter, keep the Search box empty and click Search.
  
• If your Cloudinary user is defined as a Media Library user role, you will only see results within folders where you have Can view (or higher) permissions.
• When you select multiple different criteria, they treated as 'AND' statements, and the results will include only assets that meet all of the different criteria specified. Within an individual criterion that supports multiple values (tags, dominant colors, etc), entering multiple values is treated as an 'OR' statement within that criterion, so the results will include assets with any of the specified values.
  For example:
  If you specify both Upload and Fetched URL in the Type criteria, results with either of these types are included in the results. But if you specify Upload for Type and cats for Tags, then only assets that meet BOTH of those criteria are included in the results.
• If you need to perform a more complex search or with different AND or OR rules than described above, you can paste a search expression into the Search bar using the Search API expression syntax.
  For example:
  the following expression will find all images with a width between 800 and 1028 pixels, a 16:9 aspect ratio, and that has BOTH 'sale' and 'shoe' as tag values:
  resource_type:image AND width:{800 TO 1028} AND aspect_ratio:"16:9" AND tags = "sale" AND tags = "shoe"

Advanced Search tabs

The Advanced Search form contains three tabs with a variety of search criteria. You can select criteria from all tabs for your search.

Tags & Metadata

This tab enables a search based on basic criteria such as storage type, tags, context (metadata), time, and the folder where the asset is stored.

• The Time criterion can be based on the date when it was: created (first uploaded to Cloudinary), uploaded (most recently uploaded), or taken (as per the asset's Exif data).

• The Folder you specify for the search indicates the selected folder and all subfolders.

Format & Size

Use this tab to add search criteria such as file format, file size, resolution, and orientation.

• Landscape orientation finds assets with aspect ratios wider than 1:1, but less than 2:1.
  
• Panorama orientation finds assets with aspect ratios that are at least 2:1

Image Analysis (Premium feature)

Search for images based on advanced image analysis including the style of the image, the predominant colors of the image, the number of faces (as determined by Cloudinary's built-in face detection algorithm), or the location of a photo. These criteria are valuable for helping you search for assets that will fit design or content requirements. If this tab is disabled, contact us for information on adding image analysis search capabilities to your account.