SplatDev.Umbraco.Plugins.CopyValue 2.2.2

UmbracoCms.Plugins.CopyValue

Copy property values between Umbraco content nodes — bulk copy, property mapping between different document types, with reusable mapping templates.

Supports

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

Features

• Define reusable mapping templates (stored in EF Core copyvalue schema)
• Map properties between same or different document types
• Execute single-pair or bulk copy operations via the backoffice or REST API
• Optional publish-after-copy support
• Lit 3 dashboard for Umbraco 17, AngularJS dashboard for Umbraco 13
• CopyValueViewComponent for rendering mapping templates in Razor views

Installation

Add the NuGet package. The CopyValueComposer registers CopyValueDbContext and ICopyValueService.

Run EF Core migrations:

dotnet ef migrations add InitialCopyValue --context CopyValueDbContext
dotnet ef database update --context CopyValueDbContext

Usage in Code

// Direct property copy with explicit mappings
var mappings = new[]
{
    new PropertyMapping { Source = "pageTitle", Target = "headline" },
    new PropertyMapping { Source = "bodyText",  Target = "content"  },
};
await _copyValueService.CopyPropertiesAsync(sourceId, targetId, mappings, publish: true);

// Bulk copy using a saved template
var pairs = new[] { (sourceId1, targetId1), (sourceId2, targetId2) };
int count = await _copyValueService.BulkCopyAsync(mappingId, pairs, publish: false);

REST API

CopyProperties request body

{
  "sourceContentId": 1234,
  "targetContentId": 5678,
  "mappings": [
    { "source": "pageTitle", "target": "headline" }
  ],
  "publish": false
}

BulkCopy request body

{
  "mappingId": 1,
  "pairs": [
    { "sourceId": 1234, "targetId": 5678 },
    { "sourceId": 1235, "targetId": 5679 }
  ],
  "publish": false
}

Changelog

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.