Skip to main content
Published
Apr 21, 2026
6mo ago
Total Downloads
1.1K
1,105

Install

dotnet add package Umbraco.Compose.Integrations.UmbracoCms.Core --version 17.0.0-preview.7
ProductVersions
.NET
net10.0

README

About

Umbraco.Compose.Integrations.UmbracoCms.Core provides a set of shared functionalities for integrating Umbraco CMS with Umbraco Compose.

If you want the full integration, install the Umbraco.Compose.Integrations.UmbracoCms package instead.

How to Use

To use Umbraco.Compose.Integrations.UmbracoCms.Core you'll need an Umbraco Compose project with an API Application created.

Installation

dotnet add package Umbraco.Compose.Integrations.UmbracoCms.Core

Configuration

To configure the integrations, add the following to you preferred configuration source (e.g. appsettings.json or Azure KeyVault):

"Umbraco:Compose": {
  "ClientId": "YOUR_API_APPLICATION_CLIENT_ID",
  "ClientSecret": "YOUR_API_APPLICATION_CLIENT_SECRET",
  "ProjectAlias": "YOUR_PROJECT_ALIAS",
  "EnvironmentAlias": "YOUR_ENVIRONMENT_ALIAS",
  "Region": "YOUR_PROJECT_REGION"
}

In your Program.cs, call .AddUmbracoComposeAuthentication() on the Umbraco builder:

builder.CreateUmbracoBuilder()
    .AddBackOffice()
    .AddWebsite()
    .AddComposers()

    .AddUmbracoComposeAuthentication()

    .Build();

Changes from Previous Version

No structural changes between v17.0.0-preview.3 and v17.0.0-preview.7.

Adoption Assessment

A verified publisher signal is available. Assess fit from the package's supported frameworks, license and dependency graph rather than popularity alone.

This version is marked prerelease. Validate its API and upgrade path before production use.Compatibility metadata lists 1 target framework; confirm the exact target used by your application.

Related Guides & Workflows

Learn how to evaluate, integrate, or audit this package in your .NET project.