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 are 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, metadata, predominant 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 several tabs with a variety of search criteria. You can select criteria from all tabs for your search.

General

This tab enables a search based on basic criteria such as delivery type, time, asset tags, 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).

• When you specify a Folder, the results will be for any matching asset in the selected folder or any of its subfolders.

Metadata

The Metadata tab enables you to search by custom metadata, including both structured and contextual metadata.

• You can include as many metadata fields as you like in your search. Each time you specify a metadata field to search for, an additional empty field gets added to that section so that you can specify another field.

  • When searching for contextual metadata, enter the full expected value for each field.
  • When searching for structured metadata, your searches can include value conditions such as 'equals, less than' or 'greater than' for numbers, 'contains' for text values, or 'is', 'before' or 'after' for dates.

• All contextual metadata for an asset is stored as a single data entry for that asset, while the individual fields of structured metadata are stored as separate data entries for that asset. Therefore:

  • If you enter multiple contextual metadata fields in a search, they are considered multiple values of a single OR search condition. In the Contextual metadata search image above, your search results would include any assets that have campaign = ABC OR discount_code = blue OR aaa = aaa.
  • If you enter multiple structured metadata fields in a search, they are considered separate AND search conditions. However, if you enter more than one value WITHIN a multi-select field when searching, those are treated as OR conditions. In the Structured metadata search image above, your search results would include only assets where Product ID is less than 12345 AND Publish Date is before Aug 1, 2019 AND Categories contains either Shoes OR Gifts.
    
    For more details on Advanced Search AND | OR rules and other general search rules, see Search guidelines above.

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 not available in your Advanced Search, contact us for information on upgrading your account to include Tier 2 search capabilities.