SplatDev.Umbraco.Plugins.DefaultValue 2.3.0

dotnet add package SplatDev.Umbraco.Plugins.DefaultValue --version 2.3.0
                    
NuGet\Install-Package SplatDev.Umbraco.Plugins.DefaultValue -Version 2.3.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="SplatDev.Umbraco.Plugins.DefaultValue" Version="2.3.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="SplatDev.Umbraco.Plugins.DefaultValue" Version="2.3.0" />
                    
Directory.Packages.props
<PackageReference Include="SplatDev.Umbraco.Plugins.DefaultValue" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add SplatDev.Umbraco.Plugins.DefaultValue --version 2.3.0
                    
#r "nuget: SplatDev.Umbraco.Plugins.DefaultValue, 2.3.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package SplatDev.Umbraco.Plugins.DefaultValue@2.3.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=SplatDev.Umbraco.Plugins.DefaultValue&version=2.3.0
                    
Install as a Cake Addin
#tool nuget:?package=SplatDev.Umbraco.Plugins.DefaultValue&version=2.3.0
                    
Install as a Cake Tool

UmbracoCms.Plugins.DefaultValue

Set default values for Umbraco content properties by document type and property alias. When a new content node is created, automatically populate specified properties with configured defaults.

DefaultValue dashboard

DefaultValue on the front end

Supports

  • Umbraco 13 (net8.0)
  • Umbraco 17 (net10.0)

Features

  • Configure default value rules per document type and property alias
  • Priority ordering for rule application
  • Enable/disable individual rules
  • EF Core persistence using the defaultvalue schema
  • Filter and manage rules from the Umbraco Settings dashboard
  • Lit 3 dashboard for Umbraco 17, AngularJS dashboard for Umbraco 13
  • DefaultValueViewComponent for rendering rules in Razor views

Installation

Add the NuGet package to your Umbraco project. The DefaultValueComposer registers the DefaultValueDbContext and IDefaultValueService automatically.

The tables are created for you the first time the site starts: the plugin runs its own Umbraco migration against the database Umbraco is already using, on whichever provider it is configured with — SQL Server or SQLite. There is nothing to scaffold and nothing to run by hand.

Usage in Code

Inject IDefaultValueService and call ApplyDefaultsAsync when creating new content:

var properties = new Dictionary<string, object?>();
await _defaultValueService.ApplyDefaultsAsync("blogPost", properties);
// properties now contains defaults for any unconfigured keys

REST API

Method Endpoint Description
GET /umbraco/api/defaultvalue/GetRules List all rules
GET /umbraco/api/defaultvalue/GetRulesForType?documentTypeAlias=x Rules for a doc type
POST /umbraco/api/defaultvalue/SaveRule Create or update a rule
DELETE /umbraco/api/defaultvalue/DeleteRule?id=1 Delete a rule
POST /umbraco/api/defaultvalue/ApplyDefaults?documentTypeAlias=x Apply defaults to a property bag

Changelog

2.3.0 — 2026-08-23

The Razor view behind @await Component.InvokeAsync(...) is now compiled into the package. It was previously carried as a loose file that nothing packed, so the component threw "view not found" on every install and the front-end usage shown in this README could not have worked.

The view also still referenced the package's pre-rename namespace, so it would not have compiled even had it shipped. That is fixed, and the view is now built with the project — a broken view fails the build instead of failing a visitor's request.

2.2.3 — 2026-08-21

  • A failed request now says so in the dashboard. Previously the dashboard kept its previous (usually empty) state, so a refused or failed call looked identical to having no data.
  • README no longer tells you to scaffold EF Core migrations by hand — the plugin creates its own tables on first start, on SQL Server or SQLite.

2.2.2 — 2026-08-21

  • Dashboard now sends the backoffice token with its API calls. On Umbraco 17 those calls were arriving unauthenticated and coming back 401, which the dashboard rendered as an empty state rather than an error.
  • A failed request now raises a notification instead of leaving the dashboard looking like there is simply no data.
  • The plugin's tables are created on startup. They were never created before, so anything touching them failed on a fresh install.
  • Runs on SQLite as well as SQL Server. It previously assumed SQL Server and failed with "Keyword not supported: 'cache'" on the database Umbraco's installer offers by default.
Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.3.0 24 8/23/2026
2.2.3 47 8/21/2026
2.2.2 41 8/21/2026
2.2.1 56 8/20/2026
2.2.0 72 8/19/2026
2.1.4 76 8/12/2026
2.1.3 79 8/12/2026
2.1.2 86 8/11/2026
2.1.1 81 8/11/2026
2.1.0 89 8/11/2026
2.0.1 133 6/1/2026
2.0.0 119 6/1/2026
1.3.0 444 3/27/2023