SaaS CMS has officially launched! Learn more now.

Matthew Slim
Jun 2, 2023
(2 votes)

Caching & Rendering of metadata from the DAM

For the EPiServer.Cms.WelcomeIntegration.UI 1.2.0 release, we have facilitated the ability to cache and render metadata from assets within the DAM.

We have enabled the retrieval of metadata for assets from Welcome's DAM via a C# API. This allows the metadata to be utilised to determine how the asset is rendered in the delivery site.

We have also enabled caching of the metadata, so in the event where the Welcome DAM library may be temporarily unavailable, as long as the metadata has been cached, it can still be used to establish how the asset is to be rendered in the delivery site. By default, caching has been set to a time period of 10 minutes, but the option to confiugure this is available.

The existing Welcome DAM asset picker integration has not changed, and when new attributes have been added in the Welcome DAM and are included in the metadata, it will be available in the API without any necessary code changes.


Pre-requisite: Install Optimizely.Cmp.Client

We've added a second, optional parameter to the AddDAMUi method where you have to provide the credentials as shown in the picture below.

You can also provide the Client ID and Client Secret via appsettings.json, as the second parameter is an Options configuration - CmpClientOptions

To use this feature, there are three possible options:

  1. Use the provided C# service to get the metadata from Welcome by injecting the IDAMAssetMetadataService where you wish to use it.
    • The IDAMAssetMetadataService contains one method, GetAssetMetadata(Guid id) which can be used to retrieve metadata from Welcome using the GUID of a specific asset. This GUID can be found within the information dialog of any asset in Welcome.
  2. Use our HtmlHelper extension method, RenderTagWithMetadata which will render an appropriate HTML tag, based on what the asset being retrieved is.
    • To use it, you have to import @using EPiServer.Cms.WelcomeIntegration.UI.Helpers; inside a .cshtml page of choice, as well as use the page model which contains a ContentReference property
    • Then, call the @await Html.RenderTagWithMetadata(x => x.YourWelcomeContentReference) with an expression which provides a ContentReference. This ContentReference should be linked to a Welcome Asset
    • Your page should now render either an image, a video or a link to the supported file with the respective metadata attached to the HTML tag
  3. Use our TagHelper called DAMAssetTagHelper which does the same thing as above, but is used a bit differently
    • To use it, first add the tag helper in your _ViewImports.cshtml file:@addTagHelper *, EPiServer.Cms.WelcomeIntegration.UI
    • Add <dam-asset content-reference="@Model.YourWelcomeContentReference"/> to your .cshtml page of choice
    • Your page should now render either an image, a video or a link to the supported file with the respective metadata attached to the HTML tag


  • We currently support images, videos and some files, such as PDFs, Word Documents, Excel Spreadsheets, Zip and 7Zip files. In the case of files, an anchor tag will be rendered to link to that specific file.
  • Currently, this is only supported in CMS 12.


Quick example with HtmlHelper and TagHelper on Alloy site:

End result:

Jun 02, 2023


Please login to comment.
Latest blogs
Frontend Hosting for SaaS CMS Solutions

Introduction Now that CMS SaaS Core has gone into general availability, it is a good time to start discussing where to host the head. SaaS Core is...

Minesh Shah (Netcel) | Jul 20, 2024

Optimizely London Dev Meetup 11th July 2024

On 11th July 2024 in London Niteco and Netcel along with Optimizely ran the London Developer meetup. There was an great agenda of talks that we put...

Scott Reed | Jul 19, 2024

Optimizely release SaaS CMS

Discover the future of content management with Optimizely SaaS CMS. Enjoy seamless updates, reduced costs, and enhanced flexibility for developers...

Andy Blyth | Jul 17, 2024 | Syndicated blog

A day in the life of an Optimizely Developer - London Meetup 2024

Hello and welcome to another instalment of A Day In The Life Of An Optimizely Developer. Last night (11th July 2024) I was excited to have attended...

Graham Carr | Jul 16, 2024