Configure the DAM Asset Picker for CMS 13

At present, you must contact Support to integrate Optimizely Digital Asset Management (DAM) and Optimizely Graph with Optimizely Content Management System 13 (see Enable Graph service to sync DAM and CMS). After the connection is established, you can manage which asset types are available through the Optimizely DAM Features page. Enable each asset type individually by selecting Activate this feature and click Save.

Configure DAM

Install the package by adding the following NuGet package to your project:
```
EPiServer.Cms.DamIntegration.UI
```
Register the DAM UI service in Startup.cs.
```
services.AddDamUI();
```
Add the DAM HTML helpers in Views/_ViewImports.cshtml. This provides access to helpers such as RenderTagWithMetadata(...).
```
@using EPiServer.Cms.DamIntegration.UI.Helpers
```

Configure appsettings.json by adding the following configuration. Find your SSO ID under Settings > Organization > General in CMP.

"Optimizely": {
  "Cms": {
    "DamUI": {
      "Endpoint": "https://cmp.optimizely.com",
      "SsoId": "<your-sso-id>",
      "NavigationUrl": "https://cmp.optimizely.com/cloud/library"
    }
  },
  "Cmp": {
    "Client": {
      "TokenUrl": "https://accounts.cmp.optimizely.com/o/oauth2/v1/token",
      "ApiUrl": "https://api.cmp.optimizely.com/v3/",
      "ClientId": "<your-client-id>",
      "ClientSecret": "<your-client-secret>"
    }
  }
}

Update content models. For any content type property that references a DAM asset, apply the UIHint.Image hint to ContentReference properties:
```
[UIHint(UIHint.Image)]
public virtual ContentReference Image { get; set; }
```

Select a DAM instance

Selecting a DAM instance enables two key features:

Asset tracking – Tracks which assets from Optimizely Content Marketing Platform (CMP) are used in CMS. This information is visible in the Asset usage view in CMP.
Embeddable DAM – Adds a DAM option to the CMS Edit menu, letting you insert assets directly from Optimizely DAM.

To select a DAM instance:

Go to Settings > Optimizely DAM Features.
Select a DAM instance from the Instance dropdown in the Select DAM Instance section.
Click Save.

Deliver DAM to the frontend

Optimizely Graph is the delivery channel for content in CMS 13 and DAM assets. The integration is built on External Sources — DAM assets are indexed into the Optimizely Graph instance connected to your CMS. Optimizely Graph queries for CMS content include the DAM asset with its data in a shared result. You do not need additional lookups to retrieve DAM data because the data is included in the response.

Query example of CMS and DAM content

In Optimizely Graph, the following code shows how to query an Example content type page that has three ContentReference properties, MainImage, Video, and Pdf, and return a joint result of CMS and DAM data. In the example, Video and Pdf are ordinary ContentReference properties without item type specified. The ContentReference property MainImage has item type specified as cmp_PublicImageAsset and therefore does not need to be projected or cast in the query.

query PageWithAssetsQuery {
  Example(
    where: { _metadata: { key: { eq: "303ddcad1b7c4895a730abbb0730a677" } } }
  ) {
    items {
      _id
      Title
      MainImage {
        url {
          graph
        }
        item {
           Id
           Url
           Title
        }
      }
      Video {
        item {
          ... on cmp_PublicVideoAsset {
            Id
            Url
            Title
          }
        }
      }
      Pdf {
        item {
          ... on cmp_PublicRawFileAsset {
            Id
            Url
            Title
          }
        }
      }
    }
  }
}

{
  "data": {
    "Example": {
      "items": [
        {
          "_id": "303ddcad-1b7c-4895-a730-abbb0730a677_en_Published",
          "Title": "This CMS is the page title",
          "MainImage": {
            "url": {
              "graph": "graph://cmp/cmp_PublicImageAsset/9e12db58114f11f09358feebe22be741"
            },
            "item": {
              "Id": "c010ae43a6d648319b8e8dd97efe7948",
              "Url": "https://images1.cmp.optimizely.com/Zz1jMDEwYWU0My1hNmQ2LTQ4MzEtOWI4ZS04ZGQ5N2VmZTc5NDg=",
              "Title": "Example DAM image asset"
            }
          },
          "Video": {
            "item": {
              "Id": "e59ca3d8308740d5960e8f0ef2663a14",
              "Url": "https://fehcwm.files.cmp.optimizely.com/download/e59ca3d8308740d5960e8f0ef2663a14",
              "Title": "Example DAM video asset"
            }
          },
          "Other": {
            "item": {
              "Id": "5ace995264a94742a577f17ef76ea64d",
              "Url": "https://fehcwm.files.cmp.optimizely.com/download/5ace995264a94742a577f17ef76ea64d",
              "Title": "Example DAM Pdf asset"
            }
          }
        }
      ]
    }
  },
  "extensions": {
    "correlationId": "94d8440bb95b1a2c",
    "cost": 75,
    "costSummary": [
      "Example(75) = limit(20) + fields(3) + basicFilter(1)*2 + links(1)*50"
    ]
  }
}

Export and import across instances

🚧
Important
Exporting content that uses DAM assets from one CMS instance and importing it into another is not currently supported.

Migrate from CMS 12 DAM integration

If you are upgrading from a CMS 12 DAM integration, a separate migration package will be released at GA to convert CMS 12-style integrations to the CMS 13 format. The initial release will support ContentReference and IList<ContentReference> properties only.