You're viewing help content for version:

Learn about various asset management and editing tasks that you can perform using the Touch-optimized user interface of AEM Assets.

This article describes how to manage and edit assets using the Adobe Experience Manager (AEM) Assets Touch-optimized user interface (UI). For elementary knowledge about the UI, see Basic handling of Touch UI.


See also Managing Content Fragments assets.

Creating folders

When organizing a collection of assets, for example, all Nature images, you can create folders to keep them together. You can use folders to categorize and organize your assets. However, it is not mandatory to organize assets in folders to work better with AEM Assets.


Sharing an Assets folder of the type sling:OrderedFolder, is not supported when sharing to Marketing Cloud. If you want to share a folder, do not select Ordered when creating a folder.

  1. Navigate to the place in your digital assets folder where you want to create a folder. In the menu, click Create. Select New Folder.

  2. In the Title field, provide a folder name. By default, DAM uses the title that you provided as the folder name. Once the folder is created, you can override the default and specify another folder name.

  3. Click Create. Your folder is displayed in the digital assets folder.

The space-separated list of characters mentioned as follows are not supported.

  • Asset filename must not contain * / : [ \\ ] | # % { } ? &
  • Asset folder name must not contain * / : [ \\ ] | # % { } ? \" . ^ ; + & \t

Uploading Assets

You can upload various types of assets (including images, PDF files, RAW files, and so on) from your local folder or a network drive to AEM Assets.


In Dynamic Media - Scene7 mode, you can only upload assets whose file sizes are 2 GB or less.

You can choose to upload assets to folders with or without a processing profile assigned to them.

For folders that have a processing profile assigned, the profile name appears on the thumbnail in the card view. In the list view, the profile name appears in the Processing Profile column. See Processing Profiles.

Before uploading an asset, ensure that it is in a format that AEM Assets supports.

  1. In the Assets UI, navigate to the location where you want to add digital assets.

  2. To upload the assets, do one of the following:

    • In the toolbar, tap the Create icon. Then, on the menu, then tap Files. You can rename the file in the presented dialog if needed.
    • In a browser that supports HTML5, drag the assets directly on the Assets UI. The dialog to rename file is not displayed.

    To select multiple files, press the Ctrl/Command key and select the assets in the file picker dialog. If using an iPad, you can only select one file at a time.

    You can pause the uploading of large assets (greater than 500 MB) and resume it later from the same page. Tap the Pause icon beside progress bar that appears when the uploading starts.


    The size above which an asset is considered a large asset is configurable. For example, you can configure the system to consider assets above 1000 MB (instead of 500 MB) as large assets. In this case, the Pause button in the progress bar appears when assets of size greater than 1000 MB are uploaded.

    The Pause button does not show if a file greater than 1000 MB is uploaded with a file less than 1000 MB. However, if you cancel the less than 1000 MB file upload, the Pause button appears.

    To modify the size limit,  configure the chunkUploadMinFileSize property of the fileupload node in the Crx repository.

    When you click the Pause icon, it toggles to a Play icon. To resume uploading, click the Play icon.  


    To cancel an ongoing upload, click the 'X' button beside the progress bar. When you cancel the upload operation, AEM Assets deletes the partially uploaded portion of the asset.

    The ability to resume uploading is especially helpful in low-bandwidth scenarios and network glitches, where it takes a long time to upload a large asset. You can pause the upload operation and continue later when the situation improves. When you resume, uploading starts from the point where you paused it.

    During the upload operation, AEM saves the portions of the asset being uploaded as chunks of data in the CRX repository. When the upload completes, AEM consolidates these chunks into a single block of data in the repository.

    To configure the cleanup task for the unfinished chunk upload jobs, go to http://[server]:[port]/system/console/configMgr/

    If you upload an asset with the same name as that of an asset already available at the location where you are uploading the asset, a warning dialog is displayed.

    You can choose to replace an existing asset, create another version, or keep both by renaming the new asset that is uploaded. If you replace an existing asset, the metadata for the asset and any prior modifications (for example annotations, croppings, and so on) you made to the existing asset are deleted. If you choose to keep both assets, the new asset is renamed with the number 1 appended to its name.



    When you select Replace in the Name Conflict dialog, the asset ID is regenerated for the new asset. This ID is different from the ID of the previous asset.

    If Asset Insights is enabled to track impressions/clicks with Adobe Analytics, this regenerated asset ID invalidates the data-captured for the asset on Analytics.

    A similar situation may occur if content packages of Assets created with AEM 6.1 (or earlier versions) are installed on an AEM 6.2 instance.

    If the asset you upload exists in AEM Assets, the Duplicates Detected dialog warns that you are attempting to upload a duplicate asset. The dialog appears only if the SHA 1 checksum value of the binary of the existing asset matches the checksum value of the asset you upload. In this case, the names of assets are immaterial. In other words, the dialog can even appear for assets that have different names if the SHA 1 values for their binaries are the same.


    The Duplicates Detected dialog appears only when the Duplicate Detection feature is enabled. To enable the Duplicate Detection feature, see Enabling Duplicate Detection


    Tap/click Keep to retain the duplicate asset in AEM Assets. Tap/click Delete to delete the duplicate asset you uploaded.

    AEM Assets prevents you from uploading assets with forbidden characters in their filenames. If you try to upload an asset that includes unallowed characters, AEM Assets displays a warning message regarding the presence of forbidden characters in the filename and stops the upload until you remove these characters or upload with an allowed name.

    To suit specific file naming conventions for your organization, the Upload Assets dialog lets you specify long names for the files that you upload.

    However, the space-separated list of characters mentioned as follows are not supported.

    • Asset filename must not contain  * / : [ \\ ] | # % { } ? &
    • Asset folder names must not contain  * / : [ \\ ] | # % { } ? \" . ^ ; + & \t

    In addition, the Assets user interface displays the most recent asset that you upload or the folder that you created first.

    If you cancel the upload operation before the files are uploaded, AEM Assets stops uploading the current file and refreshes the content. However, files that are already uploaded are not deleted.

    The upload progress dialog in AEM Assets displays the count of successfully uploaded files and the files that failed to upload.

Serial uploads

Uploading numerous assets in bulk consumes significant I/O resources, which may adversely impact the performance of your AEM Assets instance. In particular, if you have a slow internet connection, the time to upload drastically increases due to a spike in disk I/O. Moreover, your web browser may introduce additional restrictions to the number of POST requests AEM Assets can handle for concurrent asset uploads. As a result, the upload operation fails or terminate prematurely. In other words, AEM assets may miss some files while ingesting a bunch of files or altogether fail to ingest any file.

To overcome this situation, AEM Assets ingests one asset at a time (serial upload) during a bulk upload operation, instead of the concurrently ingesting all the assets.

Serial uploading of assets is enabled by default. To disable the feature and allow concurrent uploading, overlay the fileupload node in Crx repository and set the value of the parallelUploads property to true.

Uploading assets using FTP

Dynamic Media enables batch uploading of assets via FTP server.  If you intend to upload large assets ( > 1 GB) or upload entire folders and subfolders, you should use FTP.  You can even set up FTP upload to occur on a recurring scheduled basis. 


In Dynamic Media - Scene7 mode, you can only upload assets whose file sizes are 2 GB or less.


To upload assets by way of FTP in Dynamic Media - Scene7 mode, you must install Feature Pack 18912 on your AEM author instances. Contact Adobe Support to get access to FP-18912 and complete the setup of your FTP account. See Installing feature pack 18912 for bulk asset migration.

If you use FTP for uploading assets, the upload settings specified in AEM are ignored. Instead, file processing rules, as defined in Dynamic Media Classic, are used.

To upload assets using FTP

  1. Using your choice of FTP client, log in to the FTP server using the FTP user name and password that you received from the provisioning email. In the FTP client, upload files or folders to the FTP server. 

  2. Log in to Dynamic Media Classic using credentials received from the provisioning email. On the Global Navigation Bar, tap Upload.

  3. On the Upload page, near the upper-left corner, tap the Via FTP tab.

  4. On the left side of the page, choose an FTP folder to upload files from; on the right side of the page, choose a destination folder.

  5. Near the lower-right corner of the page, click Job Options and then set the options you want based on the assets in the folder you selected.

    See Upload Job Options.


    When you upload assets via FTP, the upload job options you set in Dynamic Media Classic (S7) take precedent over asset processing parameters set in AEM.

  6. In the lower-right corner of the Upload Job Options dialog box, tap Save.

  7. In the lower-right corner of the Upload page, tap Submit Upload.

    To view the progress of the upload, on the Global Navigation Bar, tap Jobs. The Jobs page displays the progress of the upload. You can continue working in AEM and return to the Jobs page in Dynamic Media Classic at any time to review an in-progress job.
    To cancel an upload job in progress, tap Cancel next to the Duration time.

Upload Job Options

Upload option Sub-option Description
Job Name  

The default name that is pre-filled in the text field includes the user-entered portion of the name and the date-and-time stamp. You can use the default name or enter a name of your own creation for this upload job.

The job and other upload and publishing jobs are recorded on the Jobs page, where you can check the status of jobs.  

Publish After Uploading   Automatically publishes the assets that you upload.
Overwrite in any folder, same base asset name regardless of extension   Select this option if you want the files you upload to replace existing files with the same names. The name of this option could be different, depending on the settings in Application Setup > General Settings > Upload to Application > Overwrite Images.
Uncompress Zip or Tar Files on Upload    
Job Options

Tap/click Job Options to open the Upload Job Options dialog box and choose options that affect the entire upload job. These options are the same for all file types.

You can choose default options for uploading files starting on the Application General Settings page. To open this page, choose Setup > Application Setup. Tap the Default Upload Options button to open the Upload Job Options dialog box.  

  When Select One-Time or Recurring. To set a recurring job, choose a Repeat option—Daily, Weekly, Monthly, or Custom—to specify when you want the FTP upload job to recur. Then specify the scheduling options as necessary.
  Include subfolders Upload all subfolders within the folder you intend to upload. The names of the folder and its subfolders you upload are entered automatically in AEM Assets.
  Crop Options

To manually crop from the sides of an image, select the Crop menu and choose Manual. Then enter the number of pixels to crop from any side or each side of the image. How much of the image is cropped depends on the ppi (pixels per inch) setting in the image file. For example, if the image displays 150 ppi and you enter 75 in the Top, Right, Bottom, and Left text boxes, a half-inch is cropped from each side.

To automatically crop white-space pixels from an image, open the Crop menu, choose Manual, and enter pixel measurements in the Top, Right, Bottom, and Left fields to crop from the sides. You can also choose Trim on the Crop menu and choose these options:

  • Trim Away Based On
    • Color - Choose the Color option. Then select the Corner menu and choose the corner of the image with the color that best represents the white-space color you want to crop.
    • Transparency - Choose the Transparency option.
      • Tolerance - Drag the slider to specify a tolerance from 0 through 1.
        For trimming based on color, specify 0 to crop pixels only if they exactly match the color you selected in the corner of the image. Numbers closer to 1 allow for more color difference.
        For trimming based on transparency, specify 0 to crop pixels only if they are transparent. Numbers closer to 1 allow for more transparency.

Note that these crop options are non-destructive.

  Color Profile Options

Choose a color conversion when you create optimized files that are used for delivery:

  • Default Color Preservation: Maintains the source image colors whenever the images contain color space information; there is no color conversion. Nearly all images today have the appropriate color profile already embedded. However, if a CMYK source image does not contain an embedded color profile, the colors are converted to sRGB (standard Red Green Blue) color space. sRGB is the recommended color space for displaying images on web pages.
  • Keep Original Color Space: Retains the original colors without any color conversion at the point. For images without an embedded color profile, any color conversion is done using the default color profiles configured in the Publish settings. The color profiles may not align with the color in the files created with this option. Therefore, you are encouraged to use the option Default Color Preservation.
  • Custom From > To
    Opens menus so you can choose a Convert From and Convert To color space. This advanced option overrides any color information that is embedded in the source file. Select this option when all the images that you are submitting contain incorrect or missing color profile data.
  Image Editing Options

You can preserve the clipping masks in images, and choose a color profile.

See Setting image-editing options at upload.

  Postscript Options

You can rasterize PostScript® files, crop files, maintain transparent backgrounds, choose a resolution, and choose a color space.

See Setting PostScript and Illustrator upload options.

  Photoshop Options

You can create templates from Adobe® Photoshop® files, maintain layers, specify how layers are named, extract text, and specify how images are anchored into templates.

Note that templates are not supported in AEM.

See Setting Photoshop upload options.

  PDF Options

You can rasterize the files, extract search words and links, auto-generate an eCatalog, set the resolution, and choose a color space.

Note that eCatalogs are not supported in AEM

See Setting PDF upload options.

  Illustrator Options

You can rasterize Adobe Illustrator® files, maintain transparent backgrounds, choose a resolution, and choose a color space.

See Setting PostScript and Illustrator upload options.

  EVideo Options

You can transcode a video file by choosing a Video Preset.

See Setting eVideo upload options.

  Batch Set Presets

To create an Image Set, or Spin Set from the uploaded files, click the Active column for the preset you want to use. You can select more than one preset. You create the presets in the Application Setup/Batch Set Presets page of Dynamic Media Classic.

See Configuring Batch Set Presets to Auto-Generate Image Sets and Spin Sets to learn more about creating batch set presets.

See Setting Batch Set Presets at upload.


Setting image-editing options at upload

When uploading image files, including AI, EPS, and PSD files, you can take the following editing actions in the Upload Job Options dialog box:

  • Crop white space from the edge of images (see description in table above).
  • Crop manually from the sides of images (see description in table above).
  • Choose a color profile (see option description in table above).
  • Create a mask from a clipping path.
  • Sharpen images with unsharp masking options
  • Knockout Background


Setting PostScript and Illustrator upload options

When you upload PostScript (EPS) or Illustrator (AI) image files, you can format them in various ways. You can rasterize the files, maintain the transparent background, choose a resolution, and choose a color space. Options for formatting PostScript and Illustrator files are available in the Upload Job Options dialog box under PostScript Options and Illustrator Options.

Option Sub-option Description
Processing   Choose Rasterize to convert vector graphics in the file to the bitmap format.
Maintain transparent background in rendered image   Maintain the background transparency of the file.
Resolution   Determines the resolution setting. This setting determines how many pixels are displayed per inch in the file.
Color space   Select the Color Space menu and choose from the following color space options:
  Detect Automatically Retains the color space of the file.
  Force As RGB Converts to the RGB color space.
  Forece As CMYK Converts to the CMYK color space.
  Force As Grayscale Converts to the grayscale color space.

Setting Photoshop upload options

PSD (Photoshop Document) files are most often used to create image templates. When you upload a PSD file, you can create an image template automatically from the file (select the Create Template option on the Upload screen).

Dynamic Media creates multiple images from a PSD file with layers if you use the file to create a template; it creates one image for each layer.

Use the Crop Options and Color Profile Options, described above, with Photoshop upload options.   


Templates are not supported in AEM.

Option Sub-option Description
Maintain Layers   Rips the layers in the PSD, if any, into individual assets. The asset layers remain associated with the PSD. You can view them by opening the PSD file in Detail view and selecting the layer panel.
Create Template   Creates a template from the layers in the PSD file.
Extract Text   Extracts the text so that users can search for text in a Viewer.
Extend layers to background size   Extends the size of ripped image layers to the size of the background layer.
Layer Naming   Layers in the PSD file are uploaded as separate images. 
  Layer Name Names the images after their layer names in the PSD file. For example, a layer named Price Tag in the original PSD file becomes an image named Price Tag. However, if the layer names in the PSD file are default Photoshop layer names (Background, Layer 1, Layer 2, and so on), the images are named after their layer numbers in the PSD file, not their default layer names.
  Photoshop and Layer Number Names the images after their layer numbers in the PSD file, ignoring original layer names. Images are named with the Photoshop filename and an appended layer number. For example, the second layer of a file called Spring Ad.psd is named Spring Ad_2 even if it had a non-default name in Photoshop.
  Photoshop and Layer Name Names the images after the PSD file followed by the layer name or layer number. The layer number is used if the layer names in the PSD file are default Photoshop layer names. For example, a layer named Price Tag in a PSD file, which is named SpringAd, is named Spring Ad_Price Tag. A layer with the default name Layer 2 is called Spring Ad_2.

Specify how images are anchored in templates that are generated from the layered composition produced from the PSD file. By default, the anchor is the center. A center anchor allows replacement images to best fill the same space, no matter the aspect ratio of the replacement image. Images with a different aspect that replace this image, when referencing the template and using parameter substitution, effectively occupy the same space. Change to a different setting if your application requires the replacement images to fill the allocated space in the template.

Setting PDF upload options

When you upload a PDF file, you can format it in various ways. You crop its pages, extract search words, enter a pixels-per-inch resolution, and choose a color space. PDF files often contain a trim margin, crop marks, registration marks, and other printer’s marks. You can crop these marks from the sides of pages as you upload a PDF file.


eCatalogs are not supported in AEM.

Choose from the following options:

Option Sub-option Description
Processing Rasterize
(Default) Rips the pages in the PDF file and converts vector graphics to bitmap images. Choose this option to create an eCatalog.
Extract Search words Extracts words from the PDF file so that the file can be searched by keyword in an eCatalog Viewer.
  Links Extracts links from the PDF files and coverts them to Image Maps that are used in an eCatalog Viewer.
Auto-Generate eCatalog from multiple page PDF   Automatically creates an eCatalog from the PDF file. The eCatalog is named after the PDF file you uploaded. (This option is only available if you rasterize the PDF file as you upload it.)
Resolution   Determines the resolution setting. This setting determines how many pixels are displayed per inch in the PDF file. The default is 150.
Color space   Select the Color Space menu and choose a color space for the PDF file. Most PDF files have both RGB and CMYK color images. The RGB color space is preferable for online viewing.
  Detect automatically Retains the color space of the PDF file.
  Force as RGB Converts to the RGB color space.
  Force as CMYK Converts to the CMYK color space.
  Force as Grayscale Converts to the grayscale color space.

Setting eVideo upload options

You can transcode a video file by choosing from a variety of video presets.

Option Sub-option Description
Adaptive Video  

A single encoding preset that works with any aspect ratio to create videos for delivery to mobile, tablet, and desktop. Uploaded source videos that are encoded with this preset are set with a fixed height. However, the width automatically scales to preserve the video’s aspect ratio.

Best practice is to use Adaptive Video encoding.

Single Encoding Presets Sort Encoding Presets Select Name or Size to sort the encoding presets listed under Desktop, Mobile, and Tablet by name or by resolution size.

Create an MP4 file for delivering a streaming or progressive video experience to desktop computers.

Select one or more aspect ratios with the resolution size and target data rate you desire.


Create an MP4 file for delivery on iPhone or Android mobile devices.

Select one or more aspect ratios with the resolution size and target data rate you desire.


Create an MP4 file for delivery on iPad or Android tablet devices.

Select one or more aspect ratios with the resolution size and target data rate you desire.

Setting Batch Set Presets at upload

If you want to automatically create an Image Set or Spin Set  from uploaded images, click the Active column for the preset you want to use. You can select more than one preset. 

See Configuring Batch Set Presets to Auto-Generate Image Sets and Spin Sets to learn more about creating batch set presets.

Streamed uploads

If you upload numerous assets, I/O calls to the AEM server increases drastically, which reduces upload efficiency and can even cause it to time out. AEM Assets supports streamed uploading of assets. Streamed uploading reduces disk I/O during the upload operation by avoiding asset storage in a temporary folder on the server before copying it to the repository. Instead, the data is transferred directly to the repository. This way, the time to upload large assets and the possibility of timeouts is reduced. Streamed upload is enabled by default in AEM Assets.


Streaming upload is disabled for AEM running on JEE server with servlet-api version less than 3.1.

Extract ZIP archive containing assets

You can upload ZIP archives just like any other supported asset. The same filename rules apply to ZIP files. AEM allows you to extract a ZIP archive to a DAM location. If the archive files do not contain ZIP as extension, enable file type detection using content.

Select one ZIP archive at a time, click Extract Archive, and select a destination folder. Select an option to handle conflicts, if any. If the assets in the ZIP file already exist in the destination folder, you can select one of these options: skip extraction, replace existing files, keep both assets by renaming, or create new version.

After the extraction is complete, AEM notifies you in the notification area. While AEM extracts the ZIP, you can go back to your work without interrupting the extraction.

Notification of zip extraction

Some limitations of the feature are:

  • If a folder by the same name exists at the destination, the assets from the ZIP file are extracted in the existing folder.
  • If you cancel the extraction, the already extracted assets are not deleted.
  • You cannot select two ZIP files at the same time and extract them. You can only extract one ZIP archive at a time.
  • When uploading a ZIP archive, if the upload dialog displays a 500 server error, retry after installing the latest service pack.

Previewing Assets

  1. From the Assets UI, navigate to the location of the asset you want to preview.

  2. Tap the desired asset to open it.

  3. In the preview mode, zoom options are available for supported Image types (with interactive editing).

    To zoom into an asset, tap/click + (or tap/click the magnifying glass on the asset). To zoom out, tap/click -. When you zoom in, you can look closely at any area of the image by panning. The Reset Zoom arrow brings you back to the original view.


    Tap the Reset button to reset the view to the original size.


Editing Properties

  1. Navigate to the location of the asset whose metadata you want to edit.

  2. Select the asset, and tap/click Properties from the toolbar to view asset properties.


    Alternatively, choose the Properties quick action on the asset card.

  3. In the Properties page, edit the metadata properties under various tabs. For example, under the Basic tab, edit the title, description, and so on. 


    The layout of the Properties page and the metadata properties available depend on the underlying metadata schema. To learn how to modify the layout of the Properties page, see Metadata Schemas.

  4. To schedule a particular date/time for the activation of the asset, use the date picker beside the On Time field.

  5. To deactivate the asset after a particular duration, choose the deactivation date/time from the date picker beside the Off Time field.



    The deactivation date should be later than the activation date for an asset.


    After the Off time is reached, the asset and its renditions are no longer available in the Assets UI.

  6. In the Tags field, select one or more tags. To add a custom tag, type the name of the tag in the box and press Enter. The new tag is saved in AEM.

    YouTube requires Tags to publish and have a link to YouTube (if a suitable link can be found).


    To be able to create tags, you require write permission for /content/cq:tags/default in the CRX repository.

  7. To provide a rating to the asset, tap/click the Advanced tab and then tap/click the star at the appropriate position to assign the desired rating.  


    The rating score that you assign to the asset is displayed under Your Ratings. The average rating score that the asset received from users who rated the asset is displayed under Rating. In addition, the breakup of the rating scores that contribute to the average rating score is displayed under Rating Breakdown. You can search assets based on average rating scores.

  8. To view usage statistics for the asset, click/tap the Insights tab.

    Usage statistics include the following:

    • Number of times the asset was viewed or downloaded.
    • Channels/devices through which the asset was used.
    • Creative solutions where the asset was recently used.

    For more details, see Asset Insights.

  9. Tap/click Save & Close.

  10. Navigate to the Assets UI. The edited metadata properties, including title, description, ratings, and so on are displayed on the asset card in Card view and under relevant columns in the List view.

Copying Assets

When you copy an asset or a folder, the entire asset or the folder is copied, along with its content structure. A copied asset or a folder is duplicated at the target location. The asset at the source location is not altered.

A few attributes that are unique to a particular copy of an asset are not carried forward. Some examples are:

  • Relative path, asset ID, creation date and time, and versions and version history. Some of these properties are indicated by the properties dam:relativePath, jcr:uuid, jcr:created, and cq:name.
  • Creation time and referenced paths are unique for each asset and each of its rendition.

The other properties and metadata information is retained. A partial copy is not created when copying an asset.

  1. From the Assets UI, select one or more assets, and then tap/click the Copy icon from the toolbar. Alternatively, choose the Copy quick action from the asset card.



    If you use the Copy quick action, you can only copy one asset at a time.

  2. Navigate to the location where you want to copy the assets.


    If you copy an asset at the same location, AEM automatically generates a variation of the name. For example, if you copy an asset titled Square, AEM automatically generates the title for its copy as Square1.

  3. Click the Paste asset icon from the toolbar:


    The assets are copied to this location.


    The Paste icon is available in the toolbar until the paste operation is completed.

Moving or Renaming Assets

  1. Navigate to the location of the asset you want to move.

  2. Select the asset, and tap/click the Move icon from the toolbar.

  3. In the Move Assets wizard, do one of the following:

    • Specify the name for the asset after it is moved. Then tap/click Next to proceed.
    • Tap/click Cancel to stop the process.


    • You can specify the same name for the asset if there is no asset with that name at the new location. However, you should use a different name if you move the asset to a location where an asset with the same name exists. If you use the same name, the system automatically generates a variation of the name. For example if your asset has the name Square, the system generates the name Square1 for its copy.
    • When renaming, whitespace is not allowed in the filename.


    The space-separated list of characters mentioned as follows are not supported.

    • asset filename must not contain  * / : [ \\ ] | # % { } ? &
    • asset folder name must not contain  * / : [ \\ ] | # % { } ? \" . ^ ; + & \t

  4. In the Select Destination screen, do one of the following:

    • Navigate to the new location for the assets, and then tap/click Next to proceed.
    • Tap/click Back to return to the Rename screen.
  5. If the assets being moved have any referencing pages, assets, or collections, the Adjust References tab appears beside the Select Destination tab.

    Do one of the following in the Adjust References screen:

    • Specify the references to be adjusted based on the new details, and then tap/click Move to proceed.
    • From the Adjust column, select/unselect references to the assets. 
    • Tap/click Back to return to the Select Destination screen.
    • Tap/click Cancel to stop the move operation.

    If you do not update references, they continue to point to the previous path of the asset. If you adjust the references, they are updated to the new asset path.

Managing Renditions

  1. You can add or remove renditions for an asset, except the original. Navigate to the location of the asset for which you want to add or remove renditions.

  2. Tap/click the asset to open its asset page. 

  3. Tap/click the GlobalNav icon, and select Renditions from the list.

  4. In the Renditions panel, view the list of renditions generated for the asset.



    By default, AEM Assets does not display the original rendition of the asset in the preview mode. If you are an administrator, you can use overlays to configure AEM Assets to display original renditions in the preview mode.

  5. Select a rendition to either view or delete the rendition.

    Deleting a rendition

    Select a rendition from the Renditions panel, and then tap/click the Delete Rendition icon from the toolbar.


    Uploading a new rendition

    Navigate to the asset details page for the asset, and tap/click the Add Rendition icon in the toolbar to upload a new rendition for the asset. 



    If you select a rendition from the Renditions panel, the toolbar changes context and displays only those actions that are relevant to the rendition. Options, such as the Upload Rendition icon is not displayed. To view these options in the toolbar, navigate to the details page for the asset.

    You can configure the dimensions for the rendition you want displayed in the details page of an image or video asset. Based on the dimensions you specify, AEM Assets displays the rendition with the exact or closest dimensions.

    To configure rendition dimensions of an image at the asset detail level, overlay the renditionpicker node libs/dam/gui/content/assets/assetpage/jcr:content/body/content/content/items/assetdetail
    ) and configure the value of the width property. Configure the property size (Long) in KB in place of width to customize rendition on asset detail page based on image size. For size-based customization, the property preferOriginal assigns preference to the original if the size of the matched rendition is greater than the original.

    Similarly, you can customize the Annotation page image by overlaying libs/dam/gui/content/assets/annotate/jcr:content/body/content/content/items/content/renditionpicker.


    To configure rendition dimensions for a video asset, navigate to the videopicker node in the CRX repository at the location/libs/dam/gui/content/assets/assetpage/jcr:content/body/content/content/items/assetdetail
    , overlay the node, and then edit the appropriate property.  


    Video annotations are supported only on browsers with HTML5 compatible video formats. In addition, depending on the browser, different video formats are supported.

Viewing Subassets

In AEM, subassets can be generated for assets with supported multi-page formats such as PDF, AI, Powerpoint/Apple Keynote, and InDesign. These subassets are like normal assets, but are linked to their parent asset and facilitate multi-page view in the Touch UI.

Subasset generation is disabled by default. To enable subasset generation, add the Create Sub Asset step to the DAM Update Asset workflow.

For Word documents, the DAM Parse Word Documents workflow generates a cq:Page component from the contents of the Word document. The images extracted from the document are referenced from the cq:Page component. These images are extracted even if subasset generation is disabled.

  1. To view subassets, navigate to the location of the asset and open its asset page.

  2. Tap/click the GlobalNav icon, and choose Subassets from the list 



    The Subassets option is displayed only if subassets are-available/have-been-generated for the asset.

    When you select Subassets from the list, the subassets page displays the subassets linked to the parent asset.


Deleting Assets

To resolve or remove the incoming references from other pages, update the relevant references before deleting an asset.

Also, disable the force delete button using an overlay, to disallow users from deleting referenced assets and leaving broken links.

  1. Navigate to the location of the asset(s) you want to delete.

  2. Select the asset, and tap/click the Delete icon from the toolbar.

  3. In the confirmation dialog, click:

    • Cancel to stop the action
    • Delete to confirm the action:
      • If the asset has no references, the asset is deleted.
      • If the asset has references, an error-message informs you that One or more assets are referenced. You can select Force Delete or Cancel.


    You require delete permissions on dam/asset to be able to delete an asset. If you only have modify permissions, you can only edit the asset metadata and add annotations to the asset. However, you cannot delete the asset or its metadata.


    To resolve or remove the incoming references from other pages, update the relevant references before deleting an asset.

    Also, disable the force delete button using an overlay, to disallow users from deleting referenced assets and leaving broken links.

Downloading Assets

Publishing Assets


For more information specific to Dynamic Media, see Publishing Dynamic Media Assets.

  1. Navigate to the location of the asset(s)/folder you want to publish

  2. Either select the Publish quick action from the asset card, or select the asset and tap/click the Quick Publish icon from the toolbar.

  3. If the asset references other assets, its references are listed in the wizard. Only references that are either unpublished or modified since they were last published/unpublished are displayed. Choose the references you want to publish.



    If the folder you want to publish includes an empty folder, the empty folder is not published.

  4. Tap/click Publish to confirm the activation for the assets.


If you publish an asset that is being processed, only the original content is published. The renditions are missing. Either wait for processing to complete and then publish or re-publish the asset once the processing completes.

Unpublishing Assets

  1. Navigate to the location of the asset/asset folder you want to remove from the publish environment (unpublish).

  2. Select the asset/folder to unpublish, and tap/click the Manage Publication icon from the toolbar.

  3. Select the Unpublish action from the list.

  4. To unpublish the asset later, select Unpublish Later, and then select a date for unpublishing the asset.

  5. Schedule a date for the asset to be unavailable from the publish environment.

  6. If the asset references other assets, choose the references you want to unpublish. Tap/click Unpublish.

  7. In the confirmation dialog, tap/click:

    • Cancel to stop the action
    • Unpublish to confirm that the assets are unpublished (no longer available on the publish environment) at the specified date.


    While unpublishing a complex asset, unpublish the asset only. Avoid unpublishing the references because they may be referenced by other published assets.

Closed User Group

A closed user group (CUG) is used to limit access to specific asset folders published from AEM. If you create a CUG for a folder, access to the folder (including folder assets and subfolders) is restricted to assigned members or groups only. To access the folder, they must log in using their security credentials.

CUGs are an extra way to restrict access to your assets. You can also configure a login page for the folder.

  1. Select a folder from the Assets UI, and tap/click the Properties icon from the toolbar to display the properties page.

  2. From the Permissions tab, add members or groups under Closed User Group.

  3. To display a login screen when users access the folder, select the Enable option. Then, select the path to a login page in AEM, and save the changes.



    If you do not specify the path to a login page, AEM displays the default login page in the publish instance.

  4. Publish the folder, and then try accessing it from the publish instance. A login screen is displayed.

  5. If you are a CUG member, enter your security credentials. The folder is displayed after AEM authenticates you.

Search assets

Searching assets 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.

For simple, advanced, and custom searches to discover and use the most appropriate assets, see search assets in AEM.

Quick actions

Quick action icons are available for a single asset at a time. Depending upon your device, perform the following actions to display the quick action icons:

  • Touch devices: Touch and hold. For example, on an iPad, you can tap-and-hold an asset so that the quick actions display.
  • Non-touch devices: Hover pointer. For example, On a desktop device, the quick action bar is displayed if you hover the pointer over the asset thumbnail.

You can view, navigate through, and select assets with any of the available views (Card, Column, and List) using the Select icon. The Select icon appears as a quick action in the Card view.


In List view, the Select icon appears when you hover the mouse icon over the thumbnail before the names of the assets/folder in the list.


Similar to List view, the Select icon appears when you hover the mouse icon over the thumbnail before the names of the assets/folder in Column view.


For more information, see Viewing and Selecting your Resources.

Editing Images

The editing tools in the AEM Assets interface let you perform small editing jobs on image assets. You can crop, rotate, flip, and perform other editing jobs on images. You can also add image maps to assets.


For some components, the Full Screen mode has additional options available.

  1. Do one of the following to open an asset in edit mode:

    • Select the asset and then click/tap the Edit icon in the toolbar.
    • Tap/click the Edit icon that appears on an asset in the Card view.
    • In the asset page, tap/click the Edit icon in the toolbar. 


  2. To crop the image, tap/click the Crop icon.

  3. Select the desired option from the list. The crop area appears on the image based on the option you choose. The Free Hand option lets you crop the image without any aspect ratio restrictions.

  4. Select the area to be cropped, and resize or reposition it on the image.

  5. Use the Finish icon (top-right corner) to crop the image. Clicking the Finish icon also triggers the regeneration of renditions.

  6. Use the Undo and Redo icons on the top-right to revert to the uncropped image or retain the cropped image, respectively.

  7. Tap/click the appropriate Rotate icon to rotate the image clockwise or anti-clockwise.

  8. Tap/click the appropriate Flip icon to flip the image horizontally or vertically.

  9. Tap/click the Finish icon to save the changes.



Image-editing is supported for BMP, GIF, PNG, and JPEG files formats.

You can also add image maps using the image editor. For details, see Adding Image Maps.


To be able to edit a .txt file, set Day CQ Link Externalizer from Configuration Manager.


The timeline lets you view various events for a selected item, such as active workflows for an asset, comments/annotations, activity logs, and versions.

Sort timeline entries for an asset
Sort timeline entries for an asset


In the Collections console, the Show All list provides options to view comments and workflows only. Moreover, the timeline is displayed only for top-level collections that are listed in the console. It is not displayed if you navigate inside any of the collections.


Timeline contains several options specific to content fragments.


Annotations are comments or explanatory notes added to images or videos. Annotations provide marketers the ability to collaborate and leave feedback about assets.

Video annotations are only supported on browsers with HTML5-compatible video formats. Video formats that AEM Assets supports depend on the browser.


For Content Fragments, annotations are created in the fragment editor.

  1. Navigate to the location of the asset to which you want to add annotations.

  2. Tap/click the Annotate icon from one of the following:

    • Quick actions
    • From the toolbar after selecting the asset or navigating to the asset page
  3. Add a comment in the Comment box at the bottom of the timeline. Alternatively, mark up an area on the image and add an annotation in the Add Annotation dialog.

  4. To notify a user about an annotation, specify the email address of the user and add the comment. For example, to notify Aaron MacDonald about an annotation, enter @aa. Hints for all matching users are displayed in a list. Select Aaron's email address from the list to tag her with the comment. Similarly, you can tag more users anywhere within the annotation or before or after it.


    For a non-administrator user, suggestions appear only if the user has Read permissions at /home in Crx-de.

  5. After adding the annotation, click Add to save it. A notification for the annotation is sent to Aaron. 



    You can add multiple annotations, before you save them.

  6. Tap/click Close to exit from the Annotation mode.

  7. To view the notification, log in to AEM Assets with Aaron MacDonald's credentials and click the Notifications icon to view the notification.


    Annotations can also be added to video assets. While annotating videos, the player pauses to let you annotate on a frame. For details, see managing video assets.

  8. To choose a different color so you can differentiate between users, click/tap the Profile icon and click/tap My Preferences.


    Specify the desired color in the Annotation Color box and then click/tap Accept.



You can also add annotations to a collection. However, if a collection contains child collections, you can add annotations/comments to the parent collection only. The Annotate option is not available for child collections.

Viewing Saved Annotations

  1. To view saved annotations for an asset, navigate to the location of the asset and open the asset page for the asset.

  2. Tap/click the GlobalNav icon, and choose Timeline from the list.

  3. From the Show All list in the timeline, select Comments to filter the results based on annotations.


    Tap/click a comment in the Timeline panel to view the corresponding annotation on the image.


    Tap/click Delete, to delete a particular comment.

Printing Annotations

If an asset has annotations or it has been subjected to a review workflow, you can print the asset along with annotations and review status as a PDF file for offline review.

You can also choose to print only the annotations or review status.

To print the annotations and review status, tap/click the Print icon and follow the instructions in the wizard. The Print icon appears in the toolbar only when the asset has at least one annotation or review status assigned to it.

  1. From the Assets UI, open the preview page for an asset.

  2. Do one of the following:

    • To print all the annotations and the review status, skip step 3 and directly go to step 4.
    • To print specific annotations and review status, open the timeline and then go to step 3.
  3. To print specific annotations, select the annotations from the timeline.


    To print the review status only, select it from the timeline.

  4. Tap/click the Print icon from the toolbar.

  5. From the Print dialog, choose the position you want the annotations/review status to be displayed on the PDF. For example, if you want the annotations/status to be printed at the top-right of the page that contains the printed image, use the Top-Left setting. It is selected by default.


    You can choose other settings depending on the position where you want the annotations/status to appear in the printed PDF. If you want the annotations/status to appear in a page that is separate from the printed asset, choose Next Page


    Lengthy annotations may not render properly in the PDF file. For optimal rendering, Adobe recommends that you limit annotations to 50 words.

  6. Tap/click Print. Depending upon the option you choose in step 2, the generated PDF displays the annotations/status at the specified position. For example, if you choose to print both annotations and the review status using the Top-Left setting, the generated output resembles the PDF file depicted here.

  7. Download or print the PDF using the options at the top-right.



    If the asset has subassets, you can print all the subassets along with their specific page-wise annotations.

    To modify the appearance of the rendered PDF file, for example the font color, size, and style, background color of the comments and statuses, open the Annotation PDF configuration from Configuration Manager, and modify the desired options. For example, to change the display color of the approved status, modify the color code in the corresponding field. For information around changing the font color of annotations, see Annotating.


    Return to the rendered PDF file and refresh it. The refreshed PDF reflects the changes you made.

If an asset includes annotations in foreign languages (especially non-latin languages), you must first configure CQ-DAM-Handler-Gibson Font Manager Service on the AEM server to be able to print these annotations. When configuring CQ-DAM-Handler-Gibson Font Manager Service, provide the path where fonts for the desired languages are located.

  1. Open the CQ-DAM-Handler-Gibson Font Manager Service configuration page from the URL http://<server>:<port>/system/console/configMgr/

  2. To configure CQ-DAM-Handler-Gibson Font Manager Service, do one of the following:

    • In the System Fonts directory option, specify the complete path to the fonts directory on your system. For example, if you're a Mac user, you can specify the path as /Library/Fonts in the System Fonts directory option. AEM fetches the fonts from this directory.
    • Create a directory named fonts inside the crx-quickstart folder. CQ-DAM-Handler-Gibson Font Manager Service automatically fetches the fonts at the location crx-quickstart/fonts. You can override this default path from within the Adobe Server Fonts directory option.
    • Create a folder for fonts in your system, and store the desired fonts in the folder. Then, specify the complete path to that folder in the Customer Fonts directory option.
  3. Configure the Annotation PDF with the correct set of font-family as follows:

    • Include the string <font_family_name_of_custom_font, sans-serif> within the font-family option. For example, if you want to print annotations in CJK (Chinese, Japanese and Korean), include the string Arial Unicode MS, Noto Sans, Noto Sans CJK JP, sans-serif in the font-family option. If you want to print annotations in Hindi, download the appropriate font and configure the font-family as Arial Unicode MS, Noto Sans, Noto Sans CJK JP, Noto Sans Devanagari, sans-serif.
  4. Restart the AEM instance.

Here is an example of how you can configure AEM to print annotations in CJK (Chinese, Japanese and Korean):

  1. Download Google Noto CJK fonts from the following links, and store them in the font directory configured in Font Manager Service.

  2. Configure the annotation PDF file by setting the font-family parameter to Arial Unicode MS, Noto Sans, Noto Sans CJK JP, sans-serif. This configuration is available by default and works for all European and CJK languages.

  3. If the language of your choice is different from the languages mentioned in step 2, append an appropriate (comma separated) entry to the default font-family. 

Asset Versioning

Versioning creates a snapshot of digital assets at a specific point in time. Versioning helps restore assets to a previous state at a later time. For example, if you want to undo a change that you made to an asset, restore the unedited version of the asset.

The following are scenarios where you create versions:

  • You modify an image in a different application and upload to AEM Assets. A version of the image is created so your original image is not overwritten.
  • You edit the metadata of an asset.
  • You use AEM Desktop App to checkout an existing asset and save your changes. A new version is created each time the asset is saved.

You can also enable automatic versioning through a workflow. When you create a version for an asset, the metadata and renditions are saved along with the version. Renditions are rendered alternatives of the same images, for example, a PNG rendition of an uploaded JPEG file.

The versioning functionality lets you do the following:

  • Create a version of an asset.
  • View the current revision for an asset.
  • Restore the asset to a previous version.
  1. Navigate to the location of the asset for which you want to create a version, and tap/click it to open its asset page.

  2. Tap/click the GlobalNav icon, and the choose Timeline from the menu.

  3. Tap/click the Actions (arrow) icon at the bottom to view the available actions you can perform on the asset.

  4. Tap/click Save as Version to create a version for the asset.

  5. Add a label and comment, and then click Create to create a version. Alternatively, tap/click Cancel to exit the operation.

  6. To view the new version, open the Show All list in the timeline from the asset details page or the Assets UI, and choose Versions.


    All versions created for an asset are listed under the timeline tab. You can filter the list to show Versions, by clicking the drop arrow and selecting Versions from the list.


    All versions created for an asset are listed under the timeline tab. You can filter the list to show Versions, by clicking the drop arrow and selecting Versions from the list.


    All versions created for an asset are listed under the timeline tab. You can filter the list to show Versions, by clicking the drop arrow and selecting Versions from the list.


    All versions created for an asset are listed under the timeline tab. You can filter the list to show Versions, by clicking the drop arrow and selecting Versions from the list.


    All versions created for an asset are listed under the timeline tab. You can filter the list to show Versions, by clicking the drop arrow and selecting Versions from the list.


    All versions created for an asset are listed under the timeline tab. You can filter the list to show Versions, by clicking the drop arrow and selecting Versions from the list.


    All versions created for an asset are listed under the timeline tab. You can filter the list to show Versions, by clicking the drop arrow and selecting Versions from the list.


    All versions created for an asset are listed under the timeline tab. You can filter the list to show Versions, by clicking the drop arrow and selecting Versions from the list.

  7. Select a specific version for the asset to preview it or enable it to appear in the Assets UI.



    You can also select the asset from the List view or the Column view.

  8. Add a label and comment for the version to revert to the particular version in the Assets UI.

  9. To generate a preview for the version, tap/click Preview Version.

  10. To display this version in the Assets UI, select Revert to this Version.

  11. To compare between two versions, go to asset page of the asset and tap/click the version to be compared with the current version.

  12. From the timeline, select the version you want to compare and drag the slider to the left to superimpose this version over the current version and compare.


Starting a workflow on an asset

  1. Navigate to the location of the asset for which you want to start a workflow, and tap/click the asset to open the asset page.

  2. Tap/click the GlobalNav icon, and the choose Timeline from the menu to display the timeline.

  3. Tap/click the Actions (arrow) icon at the bottom to open the list of actions available for the asset.

  4. Tap/click Start Workflow from the list.

  5. In the Start Workflow dialog, select a workflow model from the list.

  6. (Optional) Specify a title for the workflow, which can be used to reference the workflow instance.

  7. Tap/click Start and then tap/click Proceed in the dialog to confirm. Each step of workflow is displayed in the timeline as an event.



A collection is an ordered set of assets. Use collections to share assets between users.

  • A collection can include assets from different locations because they only contain references to these assets. Each collection maintains the referential integrity of assets.
  • You can share collections with multiple users with different privilege levels, including editing, viewing, and so on.

See Managing Collections for details on collection management.

This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™ and Facebook posts are not covered under the terms of Creative Commons.

Legal Notices   |   Online Privacy Policy