Manage your digital assets manage-digital-assets
In ÃÛ¶¹ÊÓƵ Experience Manager Assets, you can do more than store and govern your assets. Experience Manager offers enterprise-grade asset management capabilities. You can edit and share assets, run advanced searches, and create multiple renditions of dozens of supported file formats. You can also manage versions and digital rights, automate processing of assets, manage and govern metadata, collaborate using annotations, and much more.
This article describes the basic asset management tasks such as create or upload; metadata updates; copy, move, and delete; publish, unpublish, and search assets. To understand the user interface, see get started with assets user interface. To manage Content Fragments, see manage Content Fragments assets.
Create folders 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. Experience Manager Assets does not require you to organize assets in folders to work better.
- Sharing an Assets folder of the type
sling:OrderedFolderis not supported when sharing to Experience Cloud. If you want to share a folder, do not select Ordered when creating a folder. - Experience Manager does not allow using
subassetsword as the name of a folder. It is a keyword reserved for a node that contains subassets for compound assets.
- Navigate to the place in your digital assets folder where you want to create a folder. In the menu, click Create. Select New Folder.
- 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.
- Click Create. Your folder is displayed in the digital assets folder.
The following (space-separated list of) characters are not supported:
- An asset file name cannot contain any of these characters:
* / : [ \\ ] | # % { } ? & - An asset folder name cannot contain any of these characters:
* / : [ \\ ] | # % { } ? \" . ^ ; + & \t
Do not include special characters in the extensions of asset filenames.
Upload 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 Experience Manager 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 Experience Manager Assets supports.
-
In the Assets user interface, navigate to the location where you want to add digital assets.
-
To upload the assets, do one of the following:
- On the toolbar, click Create. Then on the menu, click 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 user interface. The dialog to rename file is not displayed.
To select multiple files, select the
CtrlorCommandkey and select the assets in the file picker dialog. When using an iPad, you can select only 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. Click Pause beside progress bar that appears when an upload 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, Pause appears on the progress bar when assets of size greater than 1000 MB are uploaded.
The Pause option 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 option appears.
To modify the size limit, configure the chunkUploadMinFileSize property of the fileupload node in the CRX repository available at /apps/dam/gui/content/assets/jcr:content/actions/secondary/create/items/fileupload.
When you click Pause, it toggles to the Play option. To resume uploading, click Play.
To cancel an ongoing upload, click close (X) next to the progress bar. When you cancel the upload operation, 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, Experience Manager saves the portions of the asset being uploaded as chunks of data in the CRX repository. When the upload completes, Experience Manager 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 https://[aem_server]:[port]/system/console/configMgr/org.apache.sling.servlets.post.impl.helper.ChunkCleanUpTask.
timeout configuration to less than the time it takes for an asset to upload, you encounter a session timeout situation while the asset upload is in progress. Therefore, change the chunkUploadMinFileSize and chunksize so that each chunk request refreshes the session.-
To ensure that chunk upload is enabled for files with sizes likely to cause credential expiry while upload is in progress.
-
To ensure that each chunk finishes before the credential expires.
If you upload an asset with the same name as an asset that is 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, annotate or crop) you made to the existing asset are deleted. If you choose to keep both assets, the new asset is renamed with number 1 appended to its name.
If the asset you upload exists in 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 do not matter.
To retain the duplicate asset in Assets, click Keep. To delete the duplicate asset you uploaded, click Delete.
Experience Manager Assets prevents you from uploading assets with the forbidden characters in their filenames. If you try to upload an asset with file name containing a disallowed character or more, Assets displays a warning message 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 following (space-separated list of) characters are not supported:
- asset file name must not contain
* / : [ \\ ] | # % { } ? & - asset folder name must not contain
* / : [ \\ ] | # % { } ? \" . ^ ; + & \t
Do not include special characters in the extensions of asset filenames.
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, Assets stops uploading the current file and refreshes the content. However, files that are already uploaded are not deleted.
The upload progress dialog in Assets displays the count of successfully uploaded files and the files that failed to upload.
Serial uploads serialuploads
Uploading numerous assets in bulk consumes significant I/O resources, which may adversely impact the performance of your Assets deployment. 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 Assets can handle for concurrent asset uploads. As a result, the upload operation fails or terminates prematurely. In other words, Experience Manager Assets may miss some files while ingesting a bunch of files or altogether fail to ingest any file.
To overcome this situation, 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.
Upload assets using FTP 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.
To upload assets using FTP
-
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.
-
Open the Dynamic Media Classic desktop application, then sign in to your account.
Your credentials and sign-in were provided by ÃÛ¶¹ÊÓƵ at the time of provisioning. If you do not have this information, contact ÃÛ¶¹ÊÓƵ Customer Support.
-
On the Global Navigation Bar, click Upload.
-
On the Upload page, near the upper-left corner, click the Via FTP tab.
-
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.
-
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.
note note NOTE 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 Experience Manager. -
In the lower-right corner of the Upload Job Options dialog box, click Save.
-
In the lower-right corner of the Upload page, click Submit Upload.
To view the progress of the upload, on the Global Navigation Bar, click Jobs. The Jobs page displays the progress of the upload. You can continue working in Experience Manager 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, click Cancel next to the Duration time.
Upload Job Options upload-job-options
The job and other upload and publishing jobs are recorded on the Jobs page, where you can check the status of jobs.
You can choose default options for uploading files starting on the Application General Settings page. To open this page, choose Setup > Application Setup. Select the Default Upload Options option to open the Upload Job Options dialog box.
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.
These crop options are non-destructive.
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.
See Setting options for image edits at upload.
See Setting PostScript and Illustrator upload options.
Templates are not supported in Experience Manager.
See Setting Photoshop upload options.
eCatalogs are not supported in Experience Manager.
See Setting PDF upload options.
Note: The maximum number of pages for a PDF to be considered for extraction is 5000 for new uploads. This limit will change to 100 page (for all PDFs) on December 31, 2022. See also Dynamic Media limitations.
See Setting PostScript and Illustrator upload options.
See Setting eVideo upload options.
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.
Set options for image edits 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 whitespace 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
Set PostScript and Illustrator upload options 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.
Set Photoshop upload options setting-photoshop-upload-options
Photoshop Document (PSD) 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.
Set PDF upload options 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.
The maximum number of pages for a PDF to be considered for extraction is 5000 for new uploads. This limit will change to 100 pages (for all PDFs) on December 31, 2022. See also Dynamic Media limitations.
Choose from the following options:
Set eVideo upload options setting-evideo-upload-options
To transcode a video file by choosing from various video presets.
Best practice is to use Adaptive Video encoding.
Set Batch Set Presets at upload 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 streamed-uploads
If you upload many assets to ÃÛ¶¹ÊÓƵ Experience Manager, the I/O requests to server increase drastically, which reduces the upload efficiency and can even cause some upload task to time out. Experience Manager Assets supports streamed uploading of assets. Streamed uploading reduces the 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 Assets.
Extract ZIP archive containing assets extractzip
You can upload ZIP archives just like any other supported asset. The same file name rules apply to ZIP files. Experience Manager lets you 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 that you want to handle conflicts, if any. If the assets in the ZIP file exist in the destination folder, you can select one of these options: skip extraction, replace existing files, keep both assets by renaming, or create a version.
After the extraction is complete, Experience Manager notifies you in the notification area. While Experience Manager extracts the ZIP, you can go back to your work without interrupting the 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.
Preview assets previewing-assets
To preview an asset, follow these steps.
-
From the Assets user interface, navigate to the location of the asset you want to preview.
-
Click the desired asset so you can open it.
-
In the preview mode, zoom options are available for supported Image types (with interactive editing).
To zoom into an asset, click
+(or click the magnifying glass on the asset). To zoom out, 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. To reset the view to the original size, click Reset
Preview assets using keyboard keys only
To preview an asset using keyboard, follow these steps:
-
From the Assets user interface, navigate to the desired asset using
Taband arrow keys. -
Press
Enterkey on the desired asset so you can open it. You can zoom into assets in preview mode. -
To zoom into the asset:
- Use
Tabkey to move focus to zoom-in option. - Use
Enterkey to zoom into the image.
To zoom out, use the
Tabkey to place focus on the zoom-out option and pressEnter. - Use
-
Use
Shift+Tabkeys to move the focus back on the image. -
Use arrow keys to move around the zoomed image.
Edit properties and metadata editing-properties
-
Navigate to the location of the asset whose metadata that you want to edit.
-
Select the asset, then from the toolbar, select Properties so you can view the asset’s properties. Alternatively, choose the Properties quick action on the asset card.
-
In the Properties page, edit the metadata properties under various tabs. For example, under the Basic tab, edit the title and description.
note note NOTE 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. -
To schedule a particular date/time for the activation of the asset, use the date picker beside the On Time field.
Figure: Use the date picker to schedule asset activation.
-
Check On/Off Time Reached option if you want to update the replication agent triggers in Metadata properties.
-
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, an asset and its renditions are not available either via the Assets web interface or through the HTTP API.
-
In the Tags field, select one or more tags. To add a custom tag, type the name of the tag in the box and select
Enter. The new tag is saved in Experience Manager. YouTube requires tags to publish. See publish videos to YouTube.note note NOTE To create tags, you need write permission at /content/cq:tags/defaultin the CRX repository. -
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.
-
To view usage statistics for the asset, click 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 Assets Insights.
-
Click Save & Close.
-
Navigate to the Assets user interface. 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.
Copy assets 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:
-
Asset ID, creation date and time, and versions and version history. Some of these properties are indicated by the properties
jcr:uuid,jcr:created, andcq: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.
-
In Assets interface, select one or more assets and click Copy from the toolbar. Alternatively, select the Copy
note note NOTE If you use the Copy quick action, you can only copy one asset at a time. -
Navigate to the location where you want to copy the assets.
note note NOTE If you copy an asset at the same location, Experience Manager automatically generates a variation of the name. For example, if you copy an asset titled Square, Experience Manager automatically generates the title for its copy asSquare1. -
Click the Paste
note note NOTE The Paste option is available in the toolbar until the paste operation is completed.
Move and rename assets moving-or-renaming-assets
When you move assets (or folders) to another location, then the assets (or folders) are not duplicated unlike while copying the asset. The assets (or the folders) get placed at the target location and are removed from the source location. You can also rename the asset when moving it to the new location.
If you are moving a published asset to a different location, then you can optionally republish the asset. By default move operation on a published asset automatically unpublishes it. A moved asset is republished if author selects the Republish option when moving the asset.
To move assets or folders:
-
Navigate to the location of the asset that you want to move.
-
Select the asset, and click Move option from the toolbar.
-
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 stop the process.
note note NOTE - 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 file name.
-
-
On the Select Destination dialog, 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 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 click Move to proceed.
-
From the Adjust column, select/unselect references to the assets.
-
Click Back to return to the Select Destination screen.
-
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.
-
Move assets using drag operation move-using-drag
You can move assets (or folders) to a sibling folder by dragging them to the target location, instead of using Move option in the user interface. However, this operation is possible only in the list view.
Moving assets by dragging them does not open Move Asset wizard, therefore you do not get the option to rename the assets while moving. Moreover, the already published assets are republished on moving them by dragging, without seeking user’s approval to republish.
Manage renditions managing-renditions
-
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.
-
Click the asset so its page is opened.
-
In the Experience Manager interface, select Renditions from the list.
-
In the Renditions panel, view the list of renditions generated for the asset.
note note NOTE By default, 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 Assets to display original renditions in the preview mode. -
Select a rendition to either view or delete the rendition.
Delete a rendition
Select a rendition from the Renditions panel, and then click the Delete Rendition
Upload a new rendition
Navigate to the asset details page for the asset, and click the Add Rendition
note note NOTE 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 option 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, Assets displays the rendition with the exact or closest dimensions.
To configure rendition dimensions of an image at the asset detail level, overlay the
renditionpickernode (libs/dam/gui/content/assets/assetpage/jcr:content/body/content/content/items/assetdetail/items/col1/items/assetview/renditionpicker) and configure the value of the width property. Configure the property size (Long) in KB in place of width so you can customize rendition on asset detail page based on image size. For size-based customization, the propertypreferOriginalassigns 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
videopickernode in the CRX repository at the location/libs/dam/gui/content/assets/assetpage/jcr:content/body/content/content/items/assetdetail/items/col1/items/assetview/videopicker, overlay the node, and then edit the appropriate property.note note NOTE Video annotations are supported only on browsers with HTML5 compatible video formats. In addition, depending on the browser, different video formats are supported. However, MXF video format is not yet supported with video annotations.
For more information about generating and viewing subassets, see Manage subassets.
Delete assets deleting-assets
To delete assets, a user requires delete permissions on dam/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. To disallow users from deleting referenced assets and leaving broken links, disable the force delete option using an overlay.
To delete an asset or a folder containing asset:
-
Navigate to the location of the asset or the folder that you want to delete.
-
Select the asset or folder, and click Delete
Once you confirm the deletion:
-
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.
note note NOTE - To resolve or remove the incoming references from other pages, update the relevant references before deleting an asset. Also, disable the force delete option using an overlay, to disallow users from deleting referenced assets and leaving broken links.
- It is possible to delete a folder that contains checked-out asset files. Before deleting a folder, ensure that no digital assets are checked-out by users.
-
clean method in JMX in your author instance (https://[server]:[port]/system/console/jmx/com.day.cq.dam.core.impl.team%3Atype%3DClean+redundant+groups+for+Assets).Download assets downloading-assets
See Download assets from Experience Manager.
Publish or unpublish assets publish-assets
After uploading, processing, or editing your assets on Experience Manager author, you publish the asset to the publish server. Publishing makes the asset available publicly. Unpublishing action removed the asset from the publish server but not from the authoring server.
For information specific to Dynamic Media, see publishing Dynamic Media assets.
-
Navigate to the location of the asset or the asset folder that you want to publish or that you want to remove from the publish environment (unpublish).
-
Select the asset or the folder that you want to unpublish, and click Manage Publication
-
Select the Publish or Unpublish option as required.
Figure: Publish and unpublish options and the scheduling option. -
Select Now to act on the asset right away or select Later to schedule the action. Select a date and time if you choose the Later option. Click Next.
-
When publishing, if an asset references other assets, its references are listed in the wizard. Only those references are displayed, that are either unpublished or modified since last publish. Choose the references that you want to publish.
-
When unpublishing, if an asset references other assets, choose the references that you want to unpublish. Click Unpublish. In the confirmation dialog, click Cancel to stop the action or click Unpublish to confirm that the assets are to be unpublished at the specified date.
Understand the following limitations and tips related to publishing or unpublishing assets or folders:
- The option to Manage Publication is available only to the user accounts that have replication permissions.
- While unpublishing a complex asset, unpublish the asset only. Avoid unpublishing the references because they may be referenced by other published assets.
- Empty folders are not published.
- 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 republish the asset once the processing completes.
Closed User Group closed-user-group
A closed user group (CUG) is used to limit access to specific asset folders published from Experience Manager. 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.
-
Select a folder from the Assets interface, and click the Properties option from the toolbar so you can display the properties page.
-
From the Permissions tab, add members or groups under Closed User Group.
-
To display a login screen when users access the folder, select the Enable option. Then, select the path to a login page in Experience Manager, and save the changes.
note note NOTE If you do not specify the path to a login page, Experience Manager displays the default login page in the publish instance. -
Publish the folder, and then try accessing it from the publish instance. A login screen is displayed.
-
If you are a CUG member, enter your security credentials. The folder is displayed after Experience Manager authenticates you.
Search assets assetsearch
Searching assets is central to the usage of a digital asset management system. This functionality is important for 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 Experience Manager.
Quick actions 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 select-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.
Navigate and select assets navigating-and-selecting-assets
You can view, navigate through, and select assets with any of the available views (Card, Column, and List) using the Select option.
In list view and column view, the Select option displays when you hover the pointer over the asset thumbnail.
In card view, the Select option displays as a quick action.
When browsing a folder or a collection in the Assets user interface in a browser, you can select all the displayed or loaded assets by using the Select All option from the upper-right corner. Initially, only 100 assets are loaded in card view and 200 are loaded in list view. More assets are loaded in view as you scroll the search results page. The Select All option selects only the loaded assets.
For more information, see view and selecting your resources.
Edit images editing-images
The editing tools in the 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.
-
Do one of the following to open an asset in edit mode:
- Select the asset and then click Edit in the toolbar.
- Click Edit option that displays on an asset in the card view.
- Click Edit from the toolbar
-
To crop the image, click Crop
-
Select the desired option from the list. The crop area appears on the image based on the option that you choose. The Free Hand option lets you crop the image without any aspect ratio restrictions.
-
Select the area to be cropped, and resize or reposition it on the image.
-
Use the Undo
-
Click the appropriate Rotate option to rotate the image clockwise or anti-clockwise.
-
Click the appropriate Flip options if you want to flip the image horizontally
-
To complete the image editing, click Finish
You can also add image maps using the image editor. For details, see Adding Image Maps.
Timeline timeline
The timeline lets you view various events for a selected item, such as active workflows for an asset, comments/annotations, activity logs, and versions.
Figure: Sort timeline entries for an asset.
Annotate assets annotating
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 Assets supports depend on the browser. However, MXF video format is not yet supported with video annotations.
-
Navigate to the location of the asset to which you want to add annotations.
-
Click the Annotate option from one of the following:
- Quick actions
- From the toolbar after selecting the asset or navigating to the asset page.
-
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.
-
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 so you can tag the person with the comment. Similarly, you can tag more users anywhere within the annotation or before or after it.
note note NOTE For a non-administrator user, the suggestions appear only if the user has read permissions at /homepath in CRXDE. -
After adding the annotation, click Add to save it. A notification for the annotation is sent to Aaron.
note note NOTE You can add multiple annotations, before you save them. -
Click Close to exit from the Annotation mode.
-
To view the notification, log in to Assets with Aaron MacDonald’s credentials and click the Notifications option to view the notification.
note note NOTE 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. MXF video format is not yet supported with video annotations. -
To choose a different color so you can differentiate between users, click the Profile option and click My Preferences.
Specify the desired color in the Annotation Color box and then click Accept.
View saved annotations viewing-saved-annotations
You can view only one annotation at a time.
To view saved annotations for an asset:
-
Go to the location of the asset and open the asset page.
-
In the Experience Manager interface, choose Timeline.
-
From the Show All list in the timeline, select Comments to filter the results based on annotations.
Click a comment in the Timeline panel if you want to view the corresponding annotation on the image.
Click Delete, to delete a particular comment.
Print annotations 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, click Print and follow the instructions in the wizard. The Print option appears in the toolbar only when the asset has at least one annotation or review status assigned to it.
-
From the Assets interface, open the preview page for an asset.
-
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.
-
To print specific annotations, select the annotations from the timeline.
To print the review status only, select it from the timeline.
-
Click Print from the toolbar.
-
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.
-
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.
-
Download
note note NOTE If the asset has subassets, you can print all the subassets along with their specific page-wise annotations. To edit the appearance of the rendered PDF file, for example, the font color, size, and style, 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 that 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 Experience Manager 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.
-
Open the CQ-DAM-Handler-Gibson Font Manager Service configuration page from the URL
https://[aem_server]:[port]/system/console/configMgr/com.day.cq.dam.handler.gibson.fontmanager.impl.FontManagerServiceImpl. -
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. Experience Manager fetches the fonts from this directory.
-
Create a directory named
fontsinside thecrx-quickstartfolder. CQ-DAM-Handler-Gibson Font Manager Service automatically fetches the fonts at the locationcrx-quickstart/fonts. You can override this default path from within the ÃÛ¶¹ÊÓƵ 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.
-
-
Access the Annotation PDF configuration from the URL
https://[aem_server]:[4502]/system/console/configMgr/com.day.cq.dam.core.impl.annotation.pdf.AnnotationPdfConfig. -
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 stringArial Unicode MS, Noto Sans, Noto Sans CJK JP, sans-serifin 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.
- Include the string
-
Restart the Experience Manager deployment.
Here is an example of how you can configure Experience Manager to print annotations in CJK (Chinese, Japanese, and Korean):
-
Download Google Noto CJK fonts from the following links, and store them in the font directory configured in Font Manager Service.
- All In One Super CJK font:
- Noto Sans (for European languages):
- Noto fonts for a language of your choice:
-
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. -
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.
Create, manage, preview, and revert asset versions asset-versioning
Versioning creates a snapshot of digital assets at a specific point in time. Versioning helps restore assets to a previous state later. For example, if you want to undo a change that you made to an asset, restore the unedited version of the asset. In Experience Manager, you can create a version, view the current revision, view side-by-side differences between two versions of images, and restore an asset to its previous version.
You can create versions in Experience Manager in the following scenarios:
- Upload an asset with the same filename that exists at the same location. It can be a new asset or a modified version of the same asset.
- Edit an image in Experience Manager and save the changes.
- Edit the metadata of an asset.
- Use Experience Manager desktop app to check out an existing asset, edit it, and upload your changes.
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.
-
Navigate to the location of the asset for which you want to create a version and click it to open its preview. From the upper-left corner of the page, open the menu, and select Timeline.
Figure: Open menu from upper-left area of page and select Timeline option.
-
To create a version of the asset:
-
Click the Actions at the bottom.
-
Click Save as Version so you can create a version for the asset. Optionally, add a label and comment.
-
Click Create to create a version.
Figure: Create a version of an asset from the Timeline left sidebar.
-
-
To view a version of an asset:
-
Click Show All in Timeline.
-
Click Versions. All versions created for an asset are listed the left sidebar.
-
Select a specific version of the asset and click Preview Version.
-
-
To revert to an older version of the asset, do the following. After reverting, this version is displayed in the Assets interface and is available for usage.
-
Click a version of the asset. Optionally, add a label and a comment.
-
Click Revert to this Version.
Figure: Select a version and revert to it. It becomes the current version which is then available to the DAM users.
-
-
To compare between two versions of an image, follow these steps:
- Click the version to be compared with the current version.
- Drag the slider to the left to superimpose this version over the current version and compare.
Figure: Use slider to effortlessly compare the selected versions of an asset with the current version.
Start a workflow on an asset starting-a-workflow-on-an-asset
To apply a workflow to process an asset, see start workflow on an asset.
Collections collections
A collection is an ordered set of assets. Use collections to share related assets between users or to cluster together similar assets for easy discovery.
- 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.
To know details of Collection management, see Manage digital assets collections.
Hide expired assets when viewing assets in desktop app or ÃÛ¶¹ÊÓƵ Asset Link hide-expired-assets-via-acp-api
Experience Manager desktop app allows access to the DAM repository from Windows or Mac desktop. ÃÛ¶¹ÊÓƵ Asset Link allows access to assets from within the supported Creative Cloud desktop applications.
When browsing assets from within Experience Manager user interface, the expired assets are not displayed. To prevent viewing, searching, and fetching of expired assets when browsing assets from desktop app and Asset Link, administrators can do the following configuration. The configuration works for all users, irrespective of administrator privilege.
Execute the following CURL command. Ensure read access on /conf/global/settings/dam/acpapi/ for the users who access assets. Users who are part of dam-user group have the permission by default.
curl -v -u admin:admin --location --request POST 'http://localhost:4502/conf/global/settings/dam/acpapi/configuration/_jcr_content' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'jcr:title=acpapiconfig' \
--data-urlencode 'hideExpiredAssets=true' \
--data-urlencode 'hideExpiredAssets@TypeHint=Boolean' \
--data-urlencode 'jcr:primaryType=nt:unstructured' \
--data-urlencode '../../jcr:primaryType=sling:Folder'
To know more, see how to browse DAM assets using desktop app and .