logo
logo

Sitecore Connect™ for Sitecore DAM™

The main goal of the Sitecore Connect™ for Sitecore DAM™ is to enable Sitecore users to browse, search and insert digital assets from Sitecore DAM™ directly within Sitecore’s Content and Experience editing.

Note

For SC 9.1.1, 9.3, 10.0, and 10.1 you should use the Content Hub connector:

  • Sitecore Connect for Content Hub - DAM: the Sitecore DAM module in the Sitecore Connect for Content Hub connector enables you to browse, search, and insert digital assets from Sitecore DAM directly from within Sitecore’s Content and Experience editing.
  • Sitecore Connect for Content Hub - CMP: the Sitecore CMP module in Sitecore Connect for Content Hub enables you to work with content created in Sitecore Content Hub directly in Sitecore. Content is automatically created and updated when changes are made in Sitecore Content Hub.
Note
  • This Sitecore Connect™ for Sitecore DAM™ has been tested on Sitecore Experience Manager and Sitecore Experience Platform (versions 9.1.0, 9.1.1, 9.2.0 or 9.3.0), as well as Sitecore Experience Commerce (versions 9.1.0, 9.1.1, 9.2.0 or 9.3.0).

  • The Sitecore Connect™ for Sitecore DAM™ is entirely localizable (only English resources are provided out-of-the-box).

  • This Sitecore Connect™ for Sitecore DAM™ is compatible with SXA module - 1.9 rev. 190506 for 9.1.1 onwards

Overview

The Sitecore Connect™ for Sitecore DAM™ displays the assets existing in the Sitecore DAM™ through an IFrame. The iFrame opens via the Insert from Sitecore DAM™ icon in the toolbar.

  1. A popup window will open to log in to Sitecore DAM™.

    The Sitecore DAM™ assets are displayed in the search pages created in the Sitecore DAM™ platform. These pages are fully configurable by Sitecore DAM™ Superusers, with the possibility to include filters, flyouts, quick edits, etc. A new page is displayed along with two child pages: Pending approval and Approved assets.

  2. The Approved assets page displays all the published assets.

  3. The Pending approval page displays assets from the Create and Review pages of the current user. The users can also upload files and create assets from this page.

Supported media types

The Sitecore Connect™ for Sitecore DAM™ supports various media types. . Image assets and video assets will be inserted using the same asset type after the specified conversion. For other media types (e.g. documents), they will not be converted, however, the connector will display a download link for the asset.

Media types in Sitecore DAM™Inserted in Sitecore
ImageImage
VideoVideo
Other media typesDownload Link

Available operations

The assets in the Approved assets and Pending approval pages display clickable thumbnail images with indicators and action buttons:

The available operations and indicators are:

  • Clicking on the thumbnail image of the asset opens the Choose file to insert page where users can select a file to insert.

  • : The public link indicator is displayed on assets that already have a public link. This indicator is not clickable.

  • : The Preview opens the preview page displaying a preview with more details about the selected asset.
  • : The submit button submits the assets uploaded from the Pending approval page to approval following the usual approval flow. The assets will be available for use in the Approved assets page after a reviewer approves them.
  • : The direct-publish button publishes the assets uploaded from the Pending approval page, making them immediately available for use in the Approved assets page. This operation is not available for all users as it requires additional permissions.
  • : The status indicator in the Pending approval pages, shows the current status of the assets, among Created, In review and Rejected. The approved assets are available in the Approved assets page.

Choose file to insert

The Choose file to insert page can be accessed by clicking on the asset's thumbnail image, or by clicking the Choose file to insert button in the asset's preview page. Users can insert the selected asset from this page by choosing an existing public link or by creating a new one.

Note

Public links are used in Sitecore DAM™ to share the assets with external systems. When an asset has been inserted in Sitecore using public links, any subsequent change to that asset occurring within Sitecore DAM™ will be reflected on the asset in Sitecore, for the purposes of reusability.

The Choose file to insert page displays a list of the available public links for the selected asset. Each public link provides the actual URL, as well as other information about the link (separated by an asterisk):

  • The asset rendition (e.g. Preview).
  • The cropping option (e.g. Cropped).
  • The rendition dimensions (e.g. 300 x 295 px).
  • The expiration date (e.g. Never expires).

The Choose file to insert page contains the following operations for each public link:

  • : This button opens a new page where users can edit the corresponding public link.

  • : This button deletes the corresponding public link.

  • Select: This option selects the corresponding public link to insert the asset in Sitecore.

Users can also create new public links by clicking on the New public link button. This button opens the New public link page, where users can create new public links for the asset.

New public link

To open the New public link page, click on New public link. If no public link exists, a new public link window opens:

In the New public link page, users need to enter the following information:

GroupPropertyDescription
Link settingsURL pathThe URL path is automatically generated for the new public link. Clicking on the refresh button regenerates a new URL path. Users can manually edit the URL path.
End dateClick on the calendar icon and select a date for the link to expire on. This field is optional. Selecting no value means the public link never expires.
Image settingsRenditionThe type of Rendition is a mandatory field. Any common rendition of the selected assets can be chosen:
  • Low res Preview
  • Thumbnail
  • Original
Crop This parameter defines the cropping option:
  • Don't crop
  • Crop to center
  • Smart crop
  • Custom crop
The cropping options are further explained in the Cropping options section.
Aspect ratio This option defines the ratio of the width to the height of the asset. This field is only available when the Crop option is set to Custom crop. The possible values include preset aspect ratios for Facebook, Instagram, LinkedIn, Twitter and Youtube.
The Aspect ratio values are further detailed in the Cropping options section.
Resize The Resize option defines the height and weight of the asset. When activated, the Height and Width fields are displayed. This field is only available when the Crop option is set to 'Don't crop' or to 'Custom crop'.
Width This option defines the width of the asset. This field is only available when the Resize option is activated or when the Crop option is set to 'Crop to center' or to 'Smart crop'.
Height This option defines the height of the asset. This field is only available when the 'Resize' option is activated or when the Crop option is set to 'Crop to center' or to 'Smart crop'.

Cropping options

The new public link interface offers various cropping options. The following image provides an overview of the available options.

The cropping options are:

  • Don't crop: This option keeps the selected rendition and doesn't crop the image.

  • Crop to center: This option positions the crop box to the center of the image. The width and height values specify the dimensions of the crop box.

  • Smart crop: This option searches the image for edges, skin tones and areas of saturated color, and attempts to position the crop box over the most significant feature. The width and height values specify the dimensions of the crop box.

  • Custom crop: This option allows users to manually select the aspect ratio from a list of preset values. It also allows users to resize the image using the width and height values, and to manually adjust the cropping box in the preview panel. Clicking on this icon reverses the cropping box dimensions.

    The Custom crop option displays the aspect ratio field, offering the following preset values:

    GroupValues
    CommonFree, 16:9, 2:1, 3:2, 4:3, 5:4, Original, Square.
    FacebookFacebook Cover Photo, Facebook Event Image, Facebook Highlighted Image, Facebook Shared Image.
    InstagramInstagram Photo, Instagram Stories.
    LinkedInLinkedIn Banner Image, LinkedIn Company Cover Image, LinkedIn Company Photos, LinkedIn Hero Photo, LinkedIn Personal Background Image, LinkedIn Shared Image, LinkedIn Shared Link.
    TwitterTwitter Header Photo, Twitter In-Stream Photo.
    YoutubeYouTube Channel Cover Art, YouTube Channel Profile Image.
Note

The dimensions of the new image must always be smaller than the dimensions of the original image.

The lock icon is shown open when the aspect ratio can be changed and closed when the aspect ratio cannot be changed.

The Aspect ratio values can be customized in Sitecore DAM™.

Available transformations

Transformations allow renditions to be dynamically resized by specifying the transformation directly in the public link URL. More specifically, transformations allow the user to resize the rendition without having to regenerate the public link.

Superusers are able to manage and configure the transformation presets. The following image lists the out-ofthe-box transformations:

To apply a transformation to a rendition, users need to append the transformation's name to the URL of the public link as a query parameter named “t”. For example, we can apply a transformation called “W320” to an asset by appending the value &t=W320 to the public link's URL.

Note

Users can access and manage the available transformations in Sitecore DAM™. This action requires Superuser permissions.

Preview asset

The Preview page displays a preview with more details about the selected asset.

The preview page offers the following operations:

  • Choose file to insert: Opens the Choose file to insert page where a file can be inserted using the public links.

  • Open detail page: Redirects users to the Detail page of the selected asset in a new tab within the Sitecore DAM™.

Known issues

Known issueVersionDescriptionWorkaround
Content type9.1 / 9.1.1 / 9.2When the content type of an asset is changed in Sitecore DAM™, the change is not reflected in Sitecore. The rendition in Sitecore will therefore not be shown.No workaround available.
Image Properties9.1 / 9.1.1 / 9.2Content Editor: Right-clicking on an Image shows two options: Image Map Editor and Properties. If either are selected, when clicking on the Image Manager icon the Media Library that is opened is not the DAM library but the sitecore/media library. There is not a choice for changing the media library.No workaround available.
Clear the image field9.1 / 9.1.1Content Editor: With a DAM image in the image field, clicking the Clear link does not clear the image field correctly. The thumbnail is cleared, but the URL remains.Click on Save to resolve the issue.
Change an image9.1 / 9.1.1Content Editor: With a DAM image inserted, by clicking Browse and selecting an image from sitecore/media library. The image field is not cleared correctly.Clear the field by using the clear link, save the item and then select a new image.
Clear the image field9.1 / 9.1.1Experience Editor: Clear image by clicking Remove the image without saving does not clear the field, even though the image is not displayed in the Experience Editor.Click on Save to resolve the issue.
Change from DAM to media library image9.1 / 9.1.1Experience Editor: When an image from DAM is selected and clicking Choose an image and inserting an image from the sitecore/media library, to replace the DAM image, the field is not cleared correctly.Click Remove image first, then click Save and then insert an image from sitecore/media library.
SXA9.1SXA is not supported for this version.No workaround available.
SXA9.1.1 / 9.2If SXA is installed when the IFrame is opened an error "MAsset Command is not implemented" is returned and the IFrame fails to open.This issue is resolved by updating the SXA config file Sitecore.XA.Feature.ContentTokens.config under the following path: App_Config\Modules\SXA\Feature. In front of the Command Script tag, prepend the SXA key attribute: script key = “SXA” src=”/sitecore/shell/Controls/Rich Text Edit/ Insert Content Token Command.js” language=“Javascript”
Behaviour Rich Text Editor9.1 / 9.1.1 / 9.2When inserting a video in the Rich Text Editor using the Design mode, the video cannot be moved or deleted but can only be played. However, two console errors are triggered.Switch to the HTML mode and adjust the video element as necessary.
Behaviour Rich Text Editor9.1 / 9.1.1 / 9.2When an item containing only a video is saved and reopened using the Design mode, the item is frozen and cannot be edited.Switch to the HTML mode and add an element as necessary. This will unfreeze the item.

Can we improve this article ? Provide feedback