Search assets in AEM search-assets-in-aem

Adobe Experience Manager Assets provides robust asset search methods that help you achieve higher content velocity. Your teams can reduce time to market with seamless, intelligent asset search experience using out-of-the-box functionality and custom methods. Search assets capability is central to the usage of a digital asset management system – be it for further use by creatives, for robust management of assets by the business users and marketers, or for administration by DAM administrators. Simple, advanced, and custom searches that you can perform via Assets user interface or other apps and surfaces help fulfill these use cases.

Asset search in AEM supports the following use cases and this article describes the usage, concepts, configurations, limitations, and troubleshooting for these use cases.

Search assets using the Omnisearch field at the top of the Experience Manager web interface. Go to Assets > Files in Experience Manager, click in top bar, enter search keyword, and select Return. Alternatively, use the keyword shortcut / (forward slash) to open the Omnisearch field. Location:Assets is pre-selected to limit the searches to DAM assets. Path:/content/dam also displays when you are performing search at the root level within the Files folder. If you navigate to any other folder, Path:/content/dam/<folder name> displays in the Omnisearch field to limit the search scope to the current folder. Experience Manager provides suggestions as you start typing a search keyword.

Use the Filters panel to search for assets, folders, tags, and metadata. You can filter search results based on the various options (predicates), such as, file type, file size, last modified date, status of asset, insights data, and Adobe Stock licensing. You can customize the Filters panel and add or remove search predicates using search facets. The File Type filter in the Filters panel has mixed-state checkboxes. Therefore, unless you select all the nested predicates (or formats) the first-level checkboxes are partially checked.

Experience Manager search capability supports searching for collections and searching for assets within a collection. See search collections.

Understand asset search interface searchui

Familiarize yourself with the asset search interface and the available actions.

Figure: Understand Experience Manager Assets search results interface.

A. Save search as a smart collection.
B. Filters or predicates to narrow the search results.
C. Display files, folders, or both.
D. Search location is DAM.
E. Access Saved Searches.
F. Click Filters to open or close the left rail.
G. Shows Assets as default search.
H. Search location is DAM.
I. Omnisearch field with user-provided search keyword.
J. Select the loaded search results.
K. Sort by Created, Modified, Name, None.
L. Sort by Ascending or Descending order.
M. Number of displayed search results out of the total search results. N. Close search.
O. Switch between card view and list view.

Dynamic search facets dynamicfacets

You can discover the desired assets faster from the search results page using the dynamically updated number of expected search results in the search facets. The expected number of assets are updated even before applying the search filter. Seeing the expected count against the filter helps you navigate through the search results quickly and efficiently.

Figure: See the approximate number of assets without filtering search results in search facets.

Experience Manager Assets displays facet counts for two properties by default:

As of August 2023, Experience Manager Assets includes a new version 9 of damAssetLucene index. The previous versions, damAssetLucene-8 and below, use the statistical mode to check access control on a sample of the items for each search facet count.

damAssetLucene-9 changes the behavior of Oak Query facet counting to no longer evaluate access control on the facet counts returned by the underlying search index, which results in the faster search response times. As a result, users might be presented with facet count values, which include assets that they do not have access to. Those users cannot access, download, or read any other detail of those assets, including their paths, or gain any further information about them.

If you need to switch to the previous behavior (statistical mode), see Content Search and Indexing to create a custom version of the damAssetLucene-9 index. Adobe does not recommend switching to the secure mode due to the impact on search response times with large result sets.

For more information on Oak’s facet capabilities, including a detailed description of these modes, see this article.

Search suggestions as you type searchsuggestions

When you start typing a keyword, Experience Manager suggests the possible search keywords or phrases. The suggestions are based on the assets in Experience Manager. Experience Manager indexes all the metadata fields to help with search. To provide search suggestions, the system uses the values of the following few metadata fields. To provide search suggestions, consider populating the following fields with appropriate keywords:

Understand search results and behavior searchbehavior

Basic search terms and results searchbasics

You can run keyword searches from the OmniSearch field. The keyword search is not case-sensitive and is a full-text search (across the popular metadata fields). If more than one keyword is used, AND is the default operator between the keywords.

The results are sorted by relevance, starting with closest matches. For multiple keywords, more relevant results are the assets that contain both terms in their metadata. Within metadata, keywords appearing as smart tags are higher ranked than keywords appearing in other metadata fields. Experience Manager allows giving a particular search term higher weight. Also, it is possible to boost the rank of a few targeted assets for specific search terms.

To quickly find the relevant assets, the rich interface provides filtering, sorting, and selection mechanisms. You can filter results based on multiple criteria and see number of searched assets for various filters. Alternatively, you can rerun search by changing the query in the Omnisearch field. When you change your search terms or filters, the other filters remain applied to preserve your search’s context.

When the results are many assets, Experience Manager displays the first 100 in the card view and 200 in the list view. As users scroll, more assets are loaded. This is to improve the performance. Watch a video demonstration of the number of assets displayed.

At times, you may see some unexpected assets in the search results. For more info, see unexpected results.

Experience Manager can search many file formats and the search filters can be customized to suit your business requirements. Contact your administrator to understand what search options are made available for your DAM repository and what restrictions your account has.

Search ranking and boosting searchrank

The search results that match all search terms in metadata fields are displayed first, followed by the search results that match any of the search terms in the smart tags. In the above example, the approximate order of display of search results is:

You can improve the relevance of keywords for particular assets to help boost searches based on the keywords. In other words, the images for which you promote specific keywords appear at the top of the search results when you search based on these keywords.

You can use this to your advantage by boosting the rank of some assets in the search results for the targeted keyword. See the example video below. For detailed info, see search in Experience Manager.

Video: Understand how search results are ranked and how the rank can be influenced.

Configure asset batch size to display search results configure-asset-batch-size

Administrators can now configure the batch size of assets that display when you perform a search. The asset search results display in multiples of the configured batch size number when you further scroll down to load the results. You can select from the available batch sizes of 200, 500, and 1000 assets. Setting a lower batch size number results in faster search response times.

For example, if you set the result count limit to a batch size of 200 assets, Experience Manager Assets displays a batch size of 200 assets in the search results when you start performing the search. When you scroll down to navigate through the search results, the next batch of 200 assets is displayed. The process continues until all assets that match the search query are displayed.

To configure the asset batch size:

Advanced search scope

Experience Manager provides various methods like filters that apply to the searched assets, to help you locate the desired assets faster. A few commonly used methods are described below. Some illustrated examples are shared below.

Search for files or folders: In the search results, see either files, folders, or both. From Filters panel, you can select the appropriate option. See search interface.

Search for assets within a folder: You can limit the search to a specific folder. In the Filters panel, add path of a folder. You can select only one folder at a time.

Figure: Limit search results to a folder by adding a folder path in Filters panel.

Find similar images visualsearch

To find images that are visually similar to a user-selected image, click Find Similar option from the card view of an image or from the toolbar. Experience Manager displays the smart tagged images from the DAM repository that are similar to a user-selected image.

Figure: Find similar images using the option in the card view.

Adobe Stock images adobe-stock

From within the Experience Manager user interface, users can search Adobe Stock assets and license the required assets. Add Location: Adobe Stock in the Omnisearch bar. You can also use Filters panel to find all the licensed or unlicensed assets or search a specific asset using Adobe Stock file number.

Dynamic Media assets dmassets

You can filter for Dynamic Media images by selecting Dynamic Media > Sets from the Filters panel. It filters and displays assets such as image sets, carousels, mixed media sets, and spin sets.

GQL search using specific values in metadata fields gql-search

You can search assets based on exact values of metadata fields, such as, title, description, and creator. The GQL full-text search feature fetches only those assets whose metadata value exactly matches your search query. The names of the properties (Creator, Title, and so on) and the values are case-sensitive.

The properties path, limit, size, and orderby cannot be combined using OR operator with any other property.

The keyword for a user-generated property is its field label in the property editor in lowercase, with spaces removed.

Here are some examples of search formats for complex queries:

Search assets from other Experience Manager offerings or interfaces search-assets-other-surfaces

Adobe Experience Manager connects DAM repository to various other Experience Manager solutions to provide faster access to digital assets and streamline the creative workflows. Any asset discovery starts with browse or search. The search behavior largely remains the same across the various surfaces and solutions. Some search methods change as the target audience, the use cases, and the user interface vary across the Experience Manager solutions. The specific methods are documented for the individual solutions at the links below. The universally applicable tips and behaviors are documented in this article.

Search assets from Adobe Asset Link panel aal

Using Adobe Asset Link, the creative professionals can now access content stored in Experience Manager Assets, without leaving the supported Adobe Creative Cloud apps. Creatives can seamlessly browse, search, check out, and check in assets using the in-app panel in the Adobe Creative Cloud apps: Adobe Photoshop, Adobe Illustrator, and Adobe InDesign. Asset Link also allows users to search visually similar results. The visual search display results are powered by Adobe Sensei’s machine learning algorithms and help users find aesthetically similar images. See search and browse assets using Adobe Asset Link.

Search assets in Experience Manager desktop app desktop-app

Creative professionals use the desktop app to make the Experience Manager Assets easily searchable and available on their local desktop (Win or Mac). Creatives can easily reveal the desired assets in Mac Finder or Windows Explorer, opened in desktop applications, and changed locally - the changes are saved back to Experience Manager with a new version created in the repository. The application supports basic searches using one or more keywords, * and ? wildcards, and AND operator. See browse, search, and preview assets in desktop app.

Search assets in Brand Portal brand-portal

Line-of-business users and marketers use Brand Portal to efficiently and securely share the approved digital assets with their extended internal teams, partners, and resellers. See search assets on Brand Portal.

Search Adobe Stock images adobe-stock1

From within the Experience Manager user interface, users can search Adobe Stock assets and license the required assets. Add Location: Adobe Stock in the Omnisearch field. You can also use Filters panel to find all the licensed or unlicensed assets or search a specific asset using Adobe Stock file number. See manage Adobe Stock images in Experience Manager.

Search Dynamic Media assets search-dynamic-media-assets

You can filter for Dynamic Media images by selecting Dynamic Media > Sets from the Filters panel. It filters and displays assets such as image sets, carousels, mixed media sets, and spin sets. While authoring web pages, the authors can search for sets from within the Content Finder. A filter for sets is available in a pop-up menu.

Search assets in Content Finder when authoring web pages content-finder

Authors can use Content Finder to search the DAM repository for the relevant assets and use the assets in the web pages they create. Authors can also use the Connected Assets functionality to search for assets that are available on a remote Experience Manager deployment. Authors can then use these assets in web pages on a local Experience Manager deployment. See use remote assets.

Search collections collections

Experience Manager search capability supports searching for collections and searching for assets within a collection. See search collections.

Asset selector asset-picker

Asset selector (called asset picker in prior versions of Adobe Experience Manager) lets you search, filter, and browse the DAM assets in a special way. Asset selector is available at https://[aem_server]:[port]/aem/assetpicker.html. You can fetch the metadata of assets that you select using the asset selector. You can launch it with supported request parameters, such as asset type (image, video, text) and selection mode (single or multiple selections). These parameters set the context of the asset selector for a particular search instance and remain intact throughout the selection.

The asset selector uses the HTML5 Window.postMessage message to send data for the selected asset to the recipient. It works only in the browse mode and only with the Omnisearch result page.

Pass the following request parameters in a URL to launch the asset selector in a particular context:

To access the asset selector interface, go to https://[aem_server]:[port]/aem/assetpicker. Navigate to the desired folder, and select one or more assets. Alternatively, search for the desired asset from the Omnisearch box, apply filter as required, and then select it.

Figure: Browse and select asset in the asset selector.

Limitations limitations

The search capability in Experience Manager Assets has the following limitations:

Visual search or similarity search has the following limitations:

The search functionality can have performance limitations in the following scenarios:

Search tips tips

Some examples illustrating search samples

Use double quotations around keywords to find assets that contain the exact phrase in the exact order as specified by the user.

Figure: Search behavior with and without quotation marks.

Search with asterisk wildcard: To broaden the search, use an asterisk before or after the search word to match any number of characters. For example, searching for run without an asterisk does not return assets containing any variation of the word (including in the metadata). An asterisk substitutes for any number of characters. For example,

Figure: Illustrating use of asterisk wildcard in Asset search using an example.

Search with question mark wildcard: To broaden the search, use one or more ‘?’ characters to match exact number of characters. For example, in the following illustration,

Figure: Illustrating use of question mark wildcard in Asset search using an example.

Exclude a keyword: Use dash to search for assets that do not contain a keyword. For example, running -shoe query returns assets that contain running, but not shoe. Similarly, camp -night query returns assets that contain camp but not night. The query camp-night returns assets that contain both camp and night.

Figure: Use of dash to search for assets not containing an excluded keyword.

Custom predicates to filter search results custompredicates

Predicates are used to create facets. Administrators can customize the search facets in the Filters panel using pre-configured predicates. These predicates can be customized using overlays. See create custom predicates.

You can search for digital assets based on one or more of the following properties. Filters that apply on some of these properties are available by default and some other filters can be custom-created to apply on the other properties.

Work with asset search results aftersearch

You can do the following with the assets you have searched in Experience Manager:

Sort search results sort

Sort search results to discover the required assets faster. You can sort the search results in list view and only when you select Files from the Filters panel. Assets uses server-side sorting to quickly sort all the assets (howsoever numerous) within a folder or results of a search query. Server-side sorting provides faster and more accurate results than client-side sorting.

In list view, you can sort the search results just as you can sort assets in any folder. Sorting works on these columns – Name, Title, Status, Dimensions, Size, Rating, Usage, (Date) Created, (Date) Modified, (Date) Published, Workflow, and Checked out.

For limitations of sort functionality, see limitations.

Check detailed information of an asset checkinfo

You can check detailed information of a searched assets from the search result page.

To see all metadata of an asset, select the asset and click properties from the toolbar.

To check the comments on an asset or version history of an asset, click the asset to open large-sized preview. Open timeline in the left rail and select Comments or Versions. You can also sort the timeline activity like comments or versions in a chronological order.

Figure: Sort timeline entries for a search asset.

Download searched assets download

You can download the searched assets and their renditions just as you download regular assets from folders. Select one or more assets from the search results and click Download from the toolbar.

Bulk update metadata properties metadata-updates

It is possible to make bulk updates to the common metadata fields of multiple assets. From the search results, select one or more assets. Click Properties from the toolbar and update the metadata as required. Click Save and Close when done. The previously existing metadata in the updated fields is overwritten.

For the assets that are available in a single folder or a collection, it is easier to update the metadata in bulk without using the search functionality. For the assets that are available across folders or match a common criteria, it is faster to bulk update the metadata via searching.

Smart collections smart-collections

A collection is an ordered set of assets that can include assets from different locations because collections contain only references to these assets. Collections are of the following two types:

You can create smart collections based on the search criteria. From the Filters panel, select Files and click Save Smart Collection. See manage collections.

Create a version create-version

Create a version for the assets that display in the search results. Select the asset and click Create > Version. Add an optional label or a comment and click Create. You can also select multiple assets and create versions for them simultaneously.

Create a workflow create-workflow

Similar to the create version capability, you can also create a workflow for the assets that display in the search results. Select the assets and click Create > Workflow. Select the workflow model, specify a title for the workflow, and click Start.

Relate and Unrelate assets relate-unrelate-assets

Relate and unrelate assets that display in the search results. Select the assets and click Relate or Unrelate.

Navigate to asset folder location navigate-asset-folder-location

Navigate to the folder location for assets displayed in the search results. Select the asset and click Show File Location.

Unexpected search results and issues unexpected-results

See also