Rivlo.ContentMigrationManager 13.0.1

📦 Rivlo.ContentMigrationManager

Flexible content, member, and media migration toolkit for Umbraco 10 and 13

A developer-focused toolkit for migrating and synchronising Umbraco data between environments. Includes secure import/export APIs, a full backoffice interface, API key management, recent activity tracking, and deep extensibility for custom property and block handling.

✅ Key Features

• 🔁 Import and export of Content, Members, and Media
• 🧱 Tree-based UI for each migration type with separate dashboards
• ⚙️ Flexible mapping of content types, property aliases, and presets
• 🧩 Supports deeply nested blocks, UDI resolution, and media linking
• 🧾 Activity log showing recent import/export history
• 🔐 API key system with permission scopes and expiry
• 🚀 Background job manager for long-running media exports
• 🔄 Dry-run validation, overwrite rules, and published-only import options
• 💡 Fully extensible via IPropertyValueHandler and IContentImportHook

🧭 Backoffice Overview

Once installed, a new Content Migration section appears in the Umbraco backoffice with the following tree:

Content Migration
 ├─ Content
 ├─ Members
 ├─ Media
 ├─ Security
 ├─ Workflows     (reserved for future workflow/webhook triggers)
 └─ Jobs          (background export monitoring)

Each node provides import/export dashboards tailored to that entity type.

If you cannot see the Content Migration section you may need to add permissions in the Users section.

🧩 Content Import

Use this dashboard to paste JSON exports or envelopes from other sites.

Options include:

📤 Content Export

Export any content tree to JSON with flexible filtering.

Exports generate a downloadable JSON file for re-import or external processing.

👥 Member Import

Import members and member groups from JSON exports.

📤 Member Export

🌄 Media Import

ZIP packages should contain a media.json file and the exported folder structure.

📤 Media Export

📋 Jobs

The Jobs node lists active and completed background exports (currently used for media). Each job shows:

• Job ID, date/time and type
• Status (Queued, In Progress, Completed, Failed)
• Progress percentage
• Download link (for completed jobs)

The dashboard automatically refreshes every 30 seconds.

🧾 Recent Activity

The last five import and export operations are logged in the Recent Activity panel on the root Content Migration dashboard, showing date, type, user, and result counts for quick auditing.

🔐 Security (API Keys)

Generate and manage scoped API keys for remote automation or integration.

Each key includes:

• Name and optional environment label
• Expiry date (optional)
• Allowed actions (import/export)
• One-time visible token at generation

🧩 Extensibility

IPropertyValueHandler

Transform or normalise editor values during export/import.

Supports alias remapping, nested transformations, and UDI resolution.

public interface IPropertyValueHandler {
    string EditorAlias { get; }
    bool CanHandle(string propertyAlias, string editorAlias);
    object ExportValue(string propertyAlias, object value, IDataType dataType);
    object TransformValue(string propertyAlias, object value, IDataType dataType, JObject? config = null);
}

Handlers must be registered in a composer class:

public class RegisterPropertyValueHandlersComposer : IComposer
{
    public void Compose(IUmbracoBuilder builder)
    {
        builder.Services.AddTransient<IPropertyValueHandler, MyPropertyValueHandler>();
    }
}

Included handlers:

• BlockListPropertyValueHandler
• MediaPickerPropertyValueHandler

IContentImportHook

For custom pre-processing at content-type or property level:

public interface IContentImportHook {
    bool CanHandle(string contentTypeAlias);                      // Match on type
    IEnumerable<string> HandledPropertyAliases();                 // e.g. ["*", "heroImage"]
    void Transform(ExportedPage source, IContent target, ImportConfig config = null); // Modify target
}

Can handle:

• Special logic per content type
• Global handlers (*)
• Pre-transform block content, images, or multi-property logic

Content Import Hooks must be registered in a composer class:

public class RegisterContentImportHooksComposer : IComposer
{
    public void Compose(IUmbracoBuilder builder)
    {
        builder.Services.AddTransient<IContentImportHook, MyContentImportHook>();
    }
}

🚧 Limitations (v5 Beta)

• ✅ Content, Member, and Media import/export fully supported
• ⚙️ Jobs monitoring and history included
• ❌ User import/export coming soon
• ❌ Workflows & webhooks coming soon
• ⚠️ Only tested with Umbraco 10 and 13 at present

📄 License

This package requires a valid RivloTools licence file to run in production.

Trial Mode: 14 day trial is automatically enabled on first install (30 days whilst in beta)

Licensing: Per-site (3 domains included for live, and staging/test) with optional version-lock

For the full End User Licence Agreement see https://www.rivlotools.com/products/content-migration-manager/eula

🌐 Learn More

Explore the full RivloTools suite at

👉 www.rivlotools.com

© CS Software Ltd