You're viewing help content for version:

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


See also Managing Content Fragments assets.

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.

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:

    • Tap/click the Create icon from the toolbar and choose Files from the menu. 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 in size) and resume it later from the same page. Click 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) in size as large assets. In this case, the Pause button in the progress bar appears when assets of size greater than 1000 MB are uploaded.

    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 and AEM Assets' impression/click statistics are tracked 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 already exists in AEM Assets, the Duplicates Detected dialog warns you 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 that of the asset you upload. In this case, the names of assets is 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.


    Click Keep to retain the duplicate asset in AEM Assets. Click Delete to delete the duplicate asset you just uploaded.


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

    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 character in the file name and halts 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.


    In addition, the Assets UI displays the most recent asset that you upload or the folder you create first in all the views (Card, List, and Column views).

    Often, while uploading large assets or multiple assets in bulk, visual indicators in the UI help you assess the progress and performance of the upload operation.

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


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

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-de 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 very 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. 


To upload assets via FTP, you must install NPR-14410 and NPR-18912 on your AEM author instance(s). Contact support to get access to NPR-18912 and complete the setup of your FTP account. See the feature pack release notes.

If you use FTP for uploading assets, be aware that upload settings specified in AEM are ignored. Instead file processing rules, as defined in Dynamic Media Classic (S7), 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 and/or folders to the FTP server. 

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

  3. On the Upload page, near the upper-left corner, click 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, click Save 

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

    To see the progress of the upload, on the Global Navigation Bar, click Jobs. The Jobs page shows you the progress of the upload. You can continue working in AEM and return to the Jobs page in Dynamic Media Classic (S7) at any time to review an in-progress job.
    To cancel an upload job in progress, click 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
  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.Note: You can choose default options for uploading files starting on the Application General Settings page. To open this page, choose Setup > Application Setup. Click 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 totally transparent. Numbers closer to 1 allow for more transparency.
  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 required color conversion to process requests for the image are done using the default color profiles as configured in the Publish settings. These 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. You should only 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.

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.

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


Option Sub-option Description
Create Mask From Clipping Path
  Create a mask for the image based on its clipping path information. This option applies to images created with image-editing applications in which a clipping path was created.
Unsharp Masking  

Lets you fine-tune a sharpening filter effect on the final downsampled image, controlling the intensity of the effect, the radius of the effect (as measured in pixels), and a threshold of contrast that is ignored.

This effect uses the same options as Photoshop’s Unsharp Mask filter. Contrary to what the name suggests, Unsharp Mask is a sharpening filter. Under Unsharp Masking, set the options you want. Setting options are described in the following:


Controls the amount of contrast that is applied to edge pixels.

Think of it as the intensity of the effect. The main difference between the amount values of Unsharp Mask in Dynamic Media and the amount values in Adobe Photoshop, is that Photoshop has an amount range of 1% to 500%. Whereas, in Dynamic Media, the value range is 0.0 to 5.0. A value of 5.0 is the rough equivalent of 500% in Photoshop; a value of 0.9 is the equivalent of 90%, and so on.


Controls the radius of the effect. The value range is 0-250.

The effect is run on all pixels in an image and radiates out from all pixels in all directions. The radius is measured in pixels. For example, to get a similar sharpening effect for a 2000 x 2000 pixel image and 500 x 500 pixel image, you would set a radius of two pixels on the 2000 x 2000 pixel image and a radius value of one pixel on the 500 x 500 pixel image. A larger value is used for an image that has more pixels.


Threshold is a range of contrast that is ignored when the Unsharp Mask filter is applied. This is important so that no "noise" is introduced to an image when this filter is used. The value range is 0-255, which is the number of brightness steps in a grayscale image. 0=black, 128=50% gray and 255=white.

For example, a threshold value of 12 ignores slight variations is skin tone brightness to avoid adding noise, but still add edge contrast to contrasty areas such as where eyelashes meet skin.

For example, if you have a photo of someone’s face, the Unsharp Mask affects the contrasty parts of the image, such as where eyelashes and skin meet to create an obvious area of contrast, and the smooth skin itself. Even the smoothest skin exhibits subtle changes in brightness values. If you do not use a threshold value, the filter accentuates these subtle changes in skin pixels. In turn, a noisy and undesirable effect is created while contrast on the eyelashes is increased, enhancing sharpness.

To avoid this issue, a threshold value is introduced that tells the filter to ignore pixels that do not change contrast dramatically, like smooth skin.

In the zipper graphic shown earlier, notice the texture next to the zippers. Image noise is exhibited because the threshold values were too low to suppress the noise.


Select to unsharp-mask image brightness (intensity).

Deselect to unsharp-mask each color component separately.

Knockout Background   Automatically removes the background of an image when you upload it. This technique is useful to draw attention to a particular object and make it stand out from a busy background. Select to enable or “turn on” the Knockout Background feature and the following sub-options:


The corner of the image that is used to define the background color to knockout.

You can choose from Upper Left, Bottom Left, Upper Right, or Bottom Right.

  Fill Method


Controls pixel transparency from the Corner location that you set.

You can choose from the following fill methods:

  • Flood Fill - turns all pixels transparent that match the Corner that you have specified and are connected to it.
  • Match Pixel - turns all matching pixels transparent, regardless of their location on the image.


Controls the allowable amount of variation in pixel color matching based on the Corner location that you set.

Use a value of 0.0 to match pixel colors exactly or, use a value of 1.0 to allow for the greatest variation.

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

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

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.
Colorspace   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 file name rules apply to ZIP files. AEM allows you to extract a ZIP archive to a DAM location.

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

Previewing Assets

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

  2. Click/tap the desired asset to open its asset page.

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

    To zoom in and out of the asset, click the + sign to zoom in (or tap/click the magnifying glass on the asset) and the sign to zoom out. 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.


    Click 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 click/tap View Properties to view asset properties.


    Alternatively, tap or click the information icon that appears on top of the asset to view the properties.

  3. In the Properties page, edit the metadata properties, for example title, description, and so on. 


    The layout of the Properties page and the metadata properies available depends 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.


    To be able to create tags, you require write permission for /etc/tags in the CRX repository.

  7. To provide a rating to the asset, click the Advanced tab and then 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. Click/tap the Insights tab, to view usage statistcs for the asset, including the number of times it was viewed or downloaded, the channels/devices through which it was used, and the creative solutions where it was recently used. For more details, see Asset Insights.

  9. Click Save.

  10. Navigate to the Assets console. The edited metadata properties 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 alterted.

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. Navigate to the location of the assets you want to copy.

  2. Select one or more assets and then click/tap the Copy icon from the toolbar. Alternatively, click/tap the Copy icon using Quick Actions.



    Using Quick Actions, you can only copy one asset at a time.

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

  4. Click the Paste asset icon from the toolbar:


    Selected assets are copied to this location.

    The paste icon is available on 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 you want to move, and 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 click Next to proceed.
    • Click Cancel to abort 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 already exists (if you use the same name, the system will automatically generate a variation of the name, for example if your asset has the name Square, the system will generate the name Square1 for its copy).

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

    • Navigate to the new location for the assets, and then click Next to proceed.
    • Click Back to return to the Rename screen.


    If you use the same name for the asset and copy it at the same location as the original asset, the system automatically generates a variation of the name. For example, if your asset has the name Square, the system will generate the name Square1 for its copy.

  5. If the assets being moved have any referencing pages, assets, or collections an additional Adjust References tab appears after 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 click Move to proceed. A message box displays the progress of the move operation. A success message appears after the assets are moved.
    • From the Adjust column, select/unselect references to the assets. 
    • Click Back to return to the Select Destination screen.
    • Click Cancel to abandon the move operation.

    References on pages if not updated, will continue pointing to the previous asset path. If you adjust the references, they are updated to the new path of the asset.

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. Click/tap the asset to open its asset page. 

  3. Click/tap 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 click the Delete Rendition icon from the Toolbar.


    Uploading a new rendition

    Navigate to the asset details page for the asset and 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 rendition. Features, such as the Upload Rendition icon is not displayed. To view these features in the toolbar, navigate to the asset details page for the asset.

    You can configure the dimensions for the rendition you want displayed in the asset details page of an image or a 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. For example, MP4 H.264 is not supported for Firefox on MAC.

Viewing Subassets

In AEM, subassets can be generated for assets with supported multi-page formats, for example 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, customize the DAM Update Asset workflow to add the Create Sub Asset step.

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. Click/tap 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

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

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

  3. In the confirmation dialog, click:

    • Cancel to abort 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

You can download assets including static and dynamic renditions. Alternatively, you can send emails with links to assets directly from AEM Assets. Downloaded assets are bundled in a ZIP file. The compressed ZIP file has a maximum file size of 1 GB for the export job. You are allowed a maximum of 500 total assets per export job.


Recipients of emails must be members of the dam-users group to access the ZIP download link in email message. In addition, to be able to download the assets, these members must have permissions to launch workflows that trigger downloading of assets.

The following are the Export/Download options. Dynamic renditions are unique to Dynamic Media and let you generate renditions on-the-fly in addition to the asset you selected - that option is only available if you have dynamic media enabled.

Assets Select this to download the asset in its original form without any renditions. 

A rendition is the binary representation of an asset. Assets have a primary representation - that of the uploaded file. They can have any number of additional representations.

When you select this option, you have the option to select the renditions you want downloaded. The renditions available depend on the asset you select. 

Dynamic Renditions

A dynamic rendition generates other renditions on-the-fly. When you select this option, you also select the renditions you want to create dynamically by selecting from the Image Preset list.

In addition, you can select the size and unit of measurement, format, color space, resolution, and any image modifiers (for example to invert the image)

Email An email is sent to the user you select from the drop-down menu with the selected asset.


The following asset types cannot be downloaded:

  • Image Sets
  • Spin Sets
  • Mixed Media Sets


  1. Navigate to the location of the asset(s) you want to download and select the asset(s).

  2. Click the Download icon from the toolbar to download the required asset.

  3. A dialog asks for confirmation, you may use:

    • Cancel to abort the download
    • Renditions to download the renditions of the asset
      • This option will be available only if the asset has renditions to download
    • Subassets to also download the subassets of the asset
      • This option is displayed only if the asset contains subassets.

    When you select a folder to download, the complete asset hierarchy under the folder is downloaded. To include each asset you download (including assets in child folders nested under the parent folder) in an individual folder, select Create separate folder for each asset.



See also Downloading DRM assets.

Publishing Assets


For additonal 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 use Quick Actions to select the Publish icon, or select the asset and click/tap the Publish icon from the toolbar.

  3. Select Publish to replicate the assets to the publish environment immediately.

  4. To publish the asset at a later date, select Publish Later and select a date for publishing the asset.

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



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

  6. Click Publish to confirm the activation date for the assets.


AEM 6.2 preserves asset IDs across author and publish instances.

If you publish an asset before upgrading to AEM 6.2 and then republish it after the upgrade, AEM synchronizes the author-instance asset ID with the publish instance asset ID. The synchronization ensures that the asset ID is the same at both places.

If you replace an asset (instead of creating another version) at the author instance, the author instance regenerates the asset ID. To synchronize the regenerated asset ID with the publish instance, republish the asset.


If you publish an assets 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 assets you want to remove from the publish environment (unpublish).

  2. Select the asset to unpublish, and click the Unpublish icon from the toolbar.

  3. Select Unpublish from the list to unpublish the asset immediately.

  4. In the confirmation dialog, click:

    • Cancel to abort the action
    • Unpublish to confirm that the assets will be unpublished (no longer available on the publish environment).
  5. To unpublish the asset at a later date, select Unpublish Later and select a date for unpublishing the asset.

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

  7. If the asset references other assets, choose the references you want to unpublish. Cick Unpublish.

  8. In the confirmation dialog, click:

    • Cancel to abort the action
    • Unpublish to confirm that the assets will be 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.

Searching Assets

Basic search is detailed in the Search and filter section. Use the Search panel to search for assets, tags, and metadata. You can search parts of a string using the wildcard asterisk. In addition, you can customize the Search panel using Search facets



For recently uploaded assets, their metadata (including titles, tags, and so on) is not immediately available in the list of suggestions that appear when you type in the Omni Search box. 

This is because AEM Assets waits until the expiry of a timeout period (1 hour by default) before running a background job to index the metadata for all newly uploaded/updated assets and adding them to the list of suggestions.

Quick Actions

Quick action icons are available for a single asset at a time. Appearance of these is device-dependent:

  • Mobile devices - using touch-and-hold
  • Desktop - using mouse hover

On a touch device, for example on an iPad, you can tap-and-hold an asset so that the quick actions display.

On a desktop device (not touch), the quick action bar is displayed if you hover your mouse pointer over the asset.

See Quick Actions for more details.

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 Quick Actions 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 will have more 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 on the toolbar.
    • Click the Edit icon that appears on an asset in the Card view.
    • In the asset page, click the Edit icon on the toolbar. 


  2. To crop the image, 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 options 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. Click the appropriate Rotate icon to rotate the image clockwise or anti-clockwise.

  8. Click the appropriate Flip icon to flip the image horizontally or vertically.

  9. Click the Finish icon to save the changes.



Image editing is supported for files that have the following formats:

  • BMP
  • GIF
  • PNG
  • JPEG 

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.

  1. Open the asset page for an asset, or select it in the Assets console.

  2. Click/tap the GlobalNav icon, and choose Timeline from the list.

  3. In the list that appears, use the Show All list to filter the results based on comments, versions, workflows, and activities:



    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; this functionality requires the application of AEM 6.3 Service Pack 3 (


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 example, MP4 H.264 is not supported for Firefox on Mac. However, it is supported for Chrome and Safari browsers.


For Content Fragments, annotations are created in the editor; this functionality requires the application of AEM 6.3 Service Pack 3 (

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

  2. Click/tap 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 e-mail address of the user and add the comment. For example, to notify Aaron MacDonald about an annotation, enter @aa. Hints for all matching users is displayed in a list. Select Aaron's e-mail address from the list to tag her with the comment. Similarly, you can tag additional 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. 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. 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.


    Click a comment in the Timeline panel to view the corresponding annotation on the image.


    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/or 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. Click/tap 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 look and feel 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 new 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 Annotation Pdf by setting the font-family parameter to Arial Unicode MS, Noto Sans, Noto Sans CJK JP, sans-serif. This configuration is present 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 allows you to 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, versioning allows you to restore to the correct version of the asset.

Examples of when you might create versions include the following scenarios:

  • You upload a file to AEM Assets. For example, if you modify an asset externally in another program and upload it, AEM Assets creates a new version of that asset so your original image is not overwritten.
  • You edit the metadata.

You can also enable automatic versioning by using a workflow. When you create version, it saves all the metadata as well as renditions of that asset. Renditions are rendered alternatives of the same images. For example, a PNG rendition of an uploaded JPEG file. Renditions appear at the bottom of the Digital Asset Manager in the Rendition panel.

With versioning, you can perform the the following functions:

  • Create a version of an asset.
  • View what revision of the asset you are using.
  • 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. Click the GlobalNav icon and the choose Timeline from the menu to display the timeline.

  3. Click the Actions (arrow) icon at the bottom view the available actions you can perform on the asset.

  4. 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, click Cancel to exit the operation.

  6. To view the newly-created version, open the Show All list in the timeline from the asset details page or the Assets console, 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 console.



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

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

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

  10. To enable this version to appear in the Assets console, select Revert to this Version.

  11. To compare between two versions, go to asset page of the asset and 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 to compare.


You can disable the version creation while overriding assets using the WebDAV client. To disable version creation, open the package in Configuration Manager and uncheck create version.


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. Click the GlobalNav icon, and the choose Timeline from the menu to display the timeline.

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

  4. 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. Click Start and then 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.

A user can have access to multiple collections. Collections are of the following types, based on the way they collate assets:

  • A collection with a static reference list of assets, folders, and other collections.
  • A collection that uses a search criteria and dynamically populates assets based on the criteria. This is called a Smart Collection.

See Managing Collections for details on collection management.


You require appropriate access rights for your account to create or edit assets.

Searching assets with invalid metadata

When searching for Assets in AEM, you can use the filters that are made available in the left rail, to zero-in on specific assets of your interest. If you expand the Metadata Validation predicate and select Invalid, you can filter the assets with invalid or missing metadata. 

The filtering works only when appropriately configured as described in Metadata Schema article. Also, the assets that are added after a scheduled check cannot be filtered until after AEM checks again.

Filter assets with invalid metadata in AEM Assets search results from the filter rail
Filter assets with invalid metadata in AEM Assets search results from the filter rail