KeyShot.Umbraco 2.0.0

DAM for Umbraco (DFU) Asset Picker

A lightweight and flexible DAM (Digital Asset Management) asset picker for Umbraco. This package adds a custom property editor that allows editors to browse and select assets directly from KeyShot DAM.

✨ Features

• Custom property editor for selecting DAM assets
• Configurable DAM endpoint and authentication
• Supports single or multiple selections
• Preview of selected assets directly in the backoffice

🚀 Installation

Install via NuGet:

Install-Package KeyShot.Umbraco

or using the .NET CLI:

dotnet add package KeyShot.Umbraco

⚙️ Configuration

After installation, configure your DAM endpoint in appsettings.json:

"Digizuite": {
    "MediaManagerUrl": "<base Media manager url>",
    "BaseUrl": "<base API url>",
    "SystemUsername": "<username> ",
    "SystemPassword": "<password>",    
    "MetaFieldItems": {
      "title": "<metafield item guid>",
      "description": "<metafield item guid>"
    },
    "AllowedLanguageIds": [<language ids>],
    "FallbackLanguageId": <language id>,
    "RotationImageRelationTypeGuid": "<relation type guid used for 360 assets>",
    "CacheTTLInMinutes": 15,
    "KeyShotManagedIntegrationConfiguration" : {
      "Name": "Cloudflare Clear Cache (Umbraco)",
      "ManagedIntegrationConfiguration": {
        "ForwardManagedIntegrationEndpoints":  ["<umbraco base url>/keyshot/managedintegration/invoke"]
      },
      "Enabled": false,
      "AuthenticationKey": "<Cloudflare auth key>"
    }
  }

Additionally, the following changes must be made to the program.cs file in the Umbraco project

The following line must be added before building the app

builder.Services.AddDamForUmbracoConnector(builder.Configuration);

The following line must be added after the app.UseUmbraco()

app.RegisterKeyShotEndpoints();

Templating (optional)

To render assets with the <keyshot> and <keyshot360> tag helpers, install KeyShot.Sdk.Cms.Templating in the Umbraco project:

dotnet add package KeyShot.Sdk.Cms.Templating

Register it after AddDamForUmbracoConnector:

builder.Services.AddKeyShotTemplating();

and add the tag helpers to Views/_ViewImports.cshtml:

@addTagHelper *, KeyShot.Sdk.Cms.Templating

📦 Usage

1. Go to Settings → Data Types
2. Create a new data type using DAM Asset Picker
3. Configure options such as:
   • Allowed file types
   • Single/multiple selection
4. Add the data type to your document types

When editing content, authors will see an asset picker modal allowing them to browse and select assets from the DAM.

🧩 Extensibility

You can implement custom DAM providers by extending the service layer. The package exposes interfaces for:

• Fetching assets
• Searching
• Thumbnails & preview metadata

📚 Requirements

📄 License

MIT License

Made with ❤️ for Umbraco editors.