Asset selector asset-selector

Last update: Wed May 03 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Topics:
Asset Management,Metadata,Search

CREATED FOR:

User

CAUTION

AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our technical support periods. Find the supported versions here.

NOTE

The Asset selector was called Asset picker in prior versions of Experience Manager.

The asset selector lets you browse, search, and filter assets in Adobe Experience Manager Assets. You can also fetch the metadata of assets that you select using the asset selector. To customize the asset selector interface, you can launch it with supported request parameters. These parameters set the context of the asset selector for a particular scenario.

Currently, you can pass the request parameters assettype (Image/Video/Text) and selection mode (Single/Multiple) as contextual information for the asset selector, which remains intact throughout the selection.

The asset selector uses the HTML5 Window.postMessage message to send data for the selected asset to the recipient.

The asset selector is based on Granite’s foundation picker vocabulary. By default, the asset selector operates in browse mode. However, you can apply filters using the Omnisearch experience to refine your search for particular assets.

You can integrate any web page (irrespective of whether it is part of the CQ container) with the asset selector (https://[AEM_server]:[port]/aem/assetpicker.html).

Contextual Parameters contextual-parameters

You can pass the following request parameters in a URL to launch the asset selector in a particular context:

Name

Values

Example

Purpose

resource suffix (B)

Folder path as the resource suffix in the URL:http://localhost:4502/aem/
assetpicker.html/<folder_path>

To launch the asset selector with a particular folder selected, for example with the folder /content/dam/we-retail/en/activities selected, the URL should be of the form: http://localhost:4502/aem/assetpicker.html
/content/dam/we-retail/en/activities?assettype=images

If you require a particular folder to be selected when the asset selector is launched, passed it as a resource suffix.

mode

single, multiple

http://localhost:4502/aem/assetpicker.html
?mode=multiple
http://localhost:4502/aem/assetpicker.html
?mode=single

In multiple mode, you can select several assets simultaneously using the asset selector.

dialog

true, false

http://localhost:4502/aem/assetpicker.html
?dialog=true

Use these parameters to open the asset selector as Granite Dialog. This option is only applicable when you launch the asset selector through Granite Path Field, and configure it as pickerSrc URL.

root

<folder_path>

http://localhost:4502/aem/
assetpicker.html?assettype=images
&root=/content/dam/we-retail/en/activities

Use this option to specify the root folder for the asset selector. In this case, the asset selector lets you select only child assets (direct/indirect) under the root folder.

viewmode

To launch the asset selector in search mode, with assettype and mimetype parameters.

assettype (S)

images, documents, multimedia, archives

http://localhost:4502/aem/assetpicker.html?viewmode=search&assettype=images
http://localhost:4502/aem/assetpicker.html?viewmode=search&assettype=documents
http://localhost:4502/aem/assetpicker.html?viewmode=search&assettype=multimedia
http://localhost:4502/aem/assetpicker.html?viewmode=search&assettype=archives

Use this option to filter asset types based on the value passed.

mimetype

mimetype(s) (/jcr:content/metadata/dc:format) of an asset (wildcard also supported)

http://localhost:4502/aem/assetpicker.html?viewmode=search&mimetype=image/png
http://localhost:4502/aem/assetpicker.html?viewmode=search&?mimetype=*png
http://localhost:4502/aem/assetpicker.html?viewmode=search&mimetype=*presentation
http://localhost:4502/aem/assetpicker?viewmode=search&mimetype=*presentation&mimetype=*png

Use it to filter assets based on MIME type(s)

Use the asset selector using-the-asset-selector

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, you can search for the desired asset from the OmniSearch box and then select it.

If you search for asssets using the OmniSearch box, you can select various filters from the Filters pane to refine your search.
Tap/click Select from the toolbar.

recommendation-more-help

4452738f-2bdf-4cd4-9b45-905a69d607ad