Cloudinary Logo Docs Documentation
  • Get Started
    • Developer solution
      • How to integrate Cloudinary
      • Service overview
    • DAM solution
    • Video tutorial library
      • Digital Asset Management (DAM)
      • Programmatic asset management
      • Transformations and optimizations
      • Administration
      • Platform integrations
  • Guides
    • Media upload
      • Overview
      • Uploading assets
      • Transformations on upload
      • Analysis on upload
      • Upload presets
      • Upload API reference
    • Image transformations
      • Common image transformations
      • Face-detection based transformations
      • Chained and named transformations
      • Conditional transformations
      • User-defined variables and arithmetic transformations
      • Animated images
      • Transformations on 3D models
      • Custom functions
    • Video transformations
      • Common video transformations
      • Conditional transformations
      • User-defined variables and arithmetic transformations
      • Converting videos to animated images
      • Audio transformations
      • Live streaming (Beta)
      • Video slideshow generation (Beta)
    • Media delivery
      • Media optimization
      • Responsive images
      • Deliver remote media files
      • Social media profile pictures
      • Paged and layered media
      • Media access control
      • Sprite generation
      • Advanced URL delivery options
    • Asset administration
      • Overview
      • Managing assets
      • Backups and version management
      • Notifications
      • Signatures
    • Widgets and players
      • Upload Widget
      • Media Library Widget
      • Media Editor (ALPHA)
      • Product Gallery
      • Video Player
    • Digital Asset Management
      • Overview
      • Uploading and storing assets
      • Folders and Collections
      • Advanced search
      • Managing individual media assets
      • Media Library administration
  • References
    • Transformation URL API
    • Upload API
    • Admin API
    • Search API
    • Metadata API
    • Provisioning API
    • Cloudinary CLI
    • Upload Widget API
    • Video Player API
    • Product Gallery API
  • Integrations
    • SDKs
      • Ruby On Rails SDK
      • PHP SDK v2 (Beta)
      • PHP SDK
      • Django SDK
      • Node.js SDK
      • Java SDK
      • .NET SDK
      • JavaScript SDK
      • jQuery SDK
      • Angular SDK
      • React SDK
      • Vue.js SDK
      • iOS SDK
      • Android SDK
      • Kotlin SDK (Beta)
      • Community-developed libraries
    • Add-ons
      • Adobe Photoshop Lightroom
      • Advanced Facial Attributes Detection
      • Amazon Rekognition AI Moderation
      • Amazon Rekognition Video Moderation
      • Amazon Rekognition Auto Tagging
      • Amazon Rekognition Celebrity Detection
      • Aspose Document Conversion
      • Cloudinary AI Background Removal
      • Cloudinary Object-Aware Cropping
      • Google AI Video Moderation
      • Google AI Video Transcription
      • Google Auto Tagging
      • Google Automatic Video Tagging
      • Google Translation
      • Imagga Auto Tagging
      • Imagga Crop and Scale
      • JPEGmini Image Optimization
      • MetaDefender Anti-Malware Protection
      • Microsoft Azure Video Indexer
      • Neural Artwork Style Transfer
      • OCR Text Detection and Extraction
      • Pixelz - Remove the Background
      • URL2PNG Website Screenshots
      • VIESUS™ Automatic Image Enhancement
      • WebPurify Image Moderation
    • Platforms
      • Adobe Creative Cloud Connector
      • Magento Extension
      • Salesforce Commerce Cloud Cartridges
      • WordPress Plugin
      • Zapier Integration
      • Third-party-developed integrations
TrainingBlogDemosSupportRoadmapCookbookWebinarsFacebook CommunityThe Visual Web
  • Training
  • Blog
  • Demos
  • Support
  • Roadmap
  • Cookbook
  • Webinars
  • Facebook Community
  • The Visual Web
Login
sign up for free
  • Get Started
    • Developer solution
      • How to integrate Cloudinary
      • Service overview
    • DAM solution
    • Video tutorial library
      • Digital Asset Management (DAM)
        • Dashboard intro
        • Sharing folders
        • Media Library intro
        • Media Library upload
        • Video management intro
        • Advanced search
      • Programmatic asset management
        • Upload programmatically
        • Generate upload signature
        • Get started with the CLI
        • Scripting with the CLI
        • Get creative with the CLI
        • Upload with the CLI
        • Product Gallery
      • Transformations and optimizations
        • Transformation basics
        • Optimization tips
        • Complex transformations
        • Named transformations
        • Lightroom edits
        • Advanced image components
      • Administration
        • Enable automatic backups
        • Restore asset versions
        • Restore deleted assets
        • Create an upload preset
      • Platform integrations
        • SFCC site cartridge intro
        • SFCC site cartridge installation
        • SFCC site cartridge modes
        • SFCC site cartridge videos
        • SFCC Page Designer cartridge
        • Cloudinary-Shopify Zap
  • Guides
    • Media upload
      • Overview
      • Uploading assets
      • Transformations on upload
      • Analysis on upload
      • Upload presets
      • Upload API reference
    • Image transformations
      • Common image transformations
      • Face-detection based transformations
      • Chained and named transformations
      • Conditional transformations
      • User-defined variables and arithmetic transformations
      • Animated images
      • Transformations on 3D models
      • Custom functions
    • Video transformations
      • Common video transformations
      • Conditional transformations
      • User-defined variables and arithmetic transformations
      • Converting videos to animated images
      • Audio transformations
      • Live streaming (Beta)
        • Live streaming WebRTC (Beta)
        • Live streaming RTMP (Beta)
      • Video slideshow generation (Beta)
    • Media delivery
      • Media optimization
        • Image optimization
        • Video optimization
      • Responsive images
      • Deliver remote media files
      • Social media profile pictures
      • Paged and layered media
      • Media access control
      • Sprite generation
      • Advanced URL delivery options
    • Asset administration
      • Overview
      • Managing assets
      • Backups and version management
      • Notifications
      • Signatures
    • Widgets and players
      • Upload Widget
      • Media Library Widget
      • Media Editor (ALPHA)
      • Product Gallery
      • Video Player
        • Video player features
        • Installation and setup
        • How to embed the video player
        • Video player customization
        • Playlists and recommendations
        • HLS and MPEG-DASH
        • Events and analytics
        • Video ads and monetization
        • Shoppable Video (Alpha)
        • Video Player API reference
    • Digital Asset Management
      • Overview
      • Uploading and storing assets
      • Folders and Collections
      • Advanced search
      • Managing individual media assets
      • Media Library administration
        • SAML provisioning
  • References
    • Transformation URL API
    • Upload API
    • Admin API
    • Search API
    • Metadata API
    • Provisioning API
    • Cloudinary CLI
    • Upload Widget API
    • Video Player API
    • Product Gallery API
  • Integrations
    • SDKs
      • Ruby On Rails SDK
        • Rails integration overview
        • Rails image and video upload
        • Rails image transformations
        • Rails video transformations
        • Rails asset administration
        • CarrierWave integration
        • Attachinary integration
        • Active Storage integration
      • PHP SDK v2 (Beta)
        • PHP v2 integration overview
        • PHP v2 image and video upload
        • PHP v2 image transformations
        • PHP v2 video transformations
        • PHP v2 asset administration
        • PHP v2 migration guide
        • PHP SDK reference
      • PHP SDK
        • PHP integration overview
        • PHP image and video upload
        • PHP image transformations
        • PHP video transformations
        • PHP asset administration
      • Django SDK
        • Django integration overview
        • Django image and video upload
        • Django image transformations
        • Django video transformations
        • Django asset administration
      • Node.js SDK
        • Node.js integration overview
        • Node.js image and video upload
        • Node.js image transformations
        • Node.js video transformations
        • Node.js asset administration
      • Java SDK
        • Java integration overview
        • Java image and video upload
        • Java image transformations
        • Java video transformations
        • Java asset administration
      • .NET SDK
        • .NET integration overview
        • .NET image and video upload
        • .NET Image Transformations
        • .NET video transformations
        • .NET asset administration
      • JavaScript SDK
        • JavaScript integration overview
        • JavaScript image and video upload
        • JavaScript image transformations
        • JavaScript video transformations
      • jQuery SDK
        • jQuery integration overview
        • jQuery image and video upload
        • jQuery image transformations
        • jQuery video transformations
      • Angular SDK
        • Angular integration overview
        • Angular image and video upload
        • Angular image transformations
        • Angular video transformations
      • React SDK
        • React integration overview
        • React image and video upload
        • React image transformations
        • React video transformations
      • Vue.js SDK
        • Vue.js integration overview
        • Vue.js image and video upload
        • Vue.js image transformations
        • Vue.js video transformations
      • iOS SDK
        • iOS integration overview
        • iOS image and video upload
        • iOS image transformations
        • iOS video transformations
      • Android SDK
        • Android integration overview
        • Android image and video upload
        • Android image transformations
        • Android video transformations
      • Kotlin SDK (Beta)
        • Kotlin media transformations (Beta)
      • Community-developed libraries
        • Gatsby
        • Gridsome
        • Laravel
        • NuxtJS
    • Add-ons
      • Adobe Photoshop Lightroom
      • Advanced Facial Attributes Detection
      • Amazon Rekognition AI Moderation
      • Amazon Rekognition Video Moderation
      • Amazon Rekognition Auto Tagging
      • Amazon Rekognition Celebrity Detection
      • Aspose Document Conversion
      • Cloudinary AI Background Removal
      • Cloudinary Object-Aware Cropping
      • Google AI Video Moderation
      • Google AI Video Transcription
      • Google Auto Tagging
      • Google Automatic Video Tagging
      • Google Translation
      • Imagga Auto Tagging
      • Imagga Crop and Scale
      • JPEGmini Image Optimization
      • MetaDefender Anti-Malware Protection
      • Microsoft Azure Video Indexer
      • Neural Artwork Style Transfer
      • OCR Text Detection and Extraction
      • Pixelz - Remove the Background
      • URL2PNG Website Screenshots
      • VIESUS™ Automatic Image Enhancement
      • WebPurify Image Moderation
    • Platforms
      • Adobe Creative Cloud Connector
      • Magento Extension
        • Magento product catalog API
      • Salesforce Commerce Cloud Cartridges
        • Page Designer Cartridge
          • Custom integration
        • Site Cartridge
      • WordPress Plugin
      • Zapier Integration
        • Example: Cloudinary-Shopify Zap
      • Third-party-developed integrations
        • Contentful App
Login
sign up for free
  • Documentation
  • Guides
  • Digital Asset Management
  • Advanced search

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 tab: Tags & Metadata

On this page:

  • Search tips and guidelines
  • Advanced Search tabs

Search tips and guidelines

  • You can perform a 'global' search by entering open text in the search bar. In this case, assets with the searched value in fields such as asset name and tags, are included in the results. A Cloudinary master admin can expand the fields that are included in global (open text) searches, by selecting relevant options in the Search section of the Media Library Preferences. For example, structured or embedded metadata fields (such as exif and iptc fields) can be set to be included in these searches.
  • 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 General 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 your account, 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.
  • You can also search for the prefix (first part) of the entire value or the prefix of any token (distinct element) within a value (where the token is separated by a space, hyphen, or underscore). However, you cannot search for the middle or end of a word or token.
    For example, entering cat in the main search bar or in a text search field:
    • Returns assets where the name or one of its attributes has values such as: cat, cats, dogs and cats, 1-cat, dog_cat.
    • Will not return assets with values such as scat or scatter, because in these cases, the searched term is not a prefix of either the entire value or of a token (distinct element).
  • In fields where you can select between equal to and contains, selecting contains follows the clarifications above, meaning it will find assets where the value you specified is a prefix of any of the tokens in the whole value. But also in this case, it will not find assets where the value you specified comes in the middle or end of the value. Equal to will search only assets where the value you specified is the entire value.
  • 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.

    Examples:

    • Find assets with a name that starts with 2019 (but not assets that contain 2019 in another token within the name): filename=2019*
      (The equal sign forces exact search rather than searching within any token, while the asterisk indicates any number of characters after the defined string)
    • Find all image assets with a width between 800 and 1028 pixels, a 16:9 aspect ratio, and that has BOTH 'sale' and 'shoe' as tag values (where sale must be an exact tag value, while shoe can match any token within a tag value (dress-shoe as a tag will match):
      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.

Notes

  • All of the search capabilities available in these tabs (and more), are also available for developers via the Search API.
  • By default, the Media Library Search capabilities (and corresponding Search API methods) are enabled only for accounts with up to 10 million assets. If your account already has, or is approaching 10 million assets, contact support.
  • The Image Analysis search capabilities are a premium feature. If these capabilities are not activated for your account, the tab is not available.

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.

Search tab: General

  • 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.

Search tab: 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.

Note
Depending on the Media Library preferences set for your account, the Metadata search tab may show both structured metadata and contextual metadata, or it may only show one or the other of these. Similarly, your Media Library preferences may be set to allow only a select set of embedded metadata fields for search via the Media Library. However, even if contextual metadata and/or some embedded metadata fields are set not to show in the Media Library, these values are still stored with the asset and can be accessed programmatically using the Cloudinary Upload and Admin APIs.

Format & Size

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

Search tab: Format & Size

  • 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.

Search tab: Image Analysis

What else can you do with DAM?

  • Manage and share folders and collections
  • Upload and store media assets
  • Perform operations on individual assets
  • Media Library administrator tasks

✔️ Feedback sent!

✖️  
How helpful was this doc page?

Thanks for submitting your rating. We got it!
We'd love to hear more. Tell us what you liked and how we can make this page even better:

*


Cloudinary is committed to protecting your information security. For details, see our privacy policy.

For additional assistance, open a support request.

Error

Unfortunately there's been an error sending your feedback.

Rate this page:

  • Folders and Collections
  • Managing individual media assets
Cloudinary Logo - White
Products
  • Programmable Media
  • DAM
  • Dynamic Video
  • Demos
  • Pricing
  • Roadmap
  • FAQ
Solutions
  • Why Cloudinary
  • E-commerce and Retail
  • Media and Entertainment
  • Travel and Hospitality
  • Nonprofit
  • Our Customers
  • Resource Library
Developers
  • Getting Started
  • Documentation
  • SDK
  • Add-ons
  • Cookbook
Company
  • About Us
  • Customers
  • Partners
  • Events
  • Careers
  • Newsroom
  • Blog
  • Brand Assets
  • Trust
Contact Us
  • Technical Support
  • Contact Sales
  • Education and Training
  • Institute of Quality & Control
  • GDPR
  • SOC
  • Forbes Best Startup Employers 2020
  • MarTech Breakthrough Awards
  • Best Places to Work SVBJ 2018
  • 2020 The World's Best Cloud Companies
  • Terms of Use
  • Privacy Policy
  • DMCA Notice

© 2021 Cloudinary. All rights reserved.