Rivlo.ContentExporter.Umbraco8 8.0.0-beta2

This is a prerelease version of Rivlo.ContentExporter.Umbraco8.
dotnet add package Rivlo.ContentExporter.Umbraco8 --version 8.0.0-beta2
                    
NuGet\Install-Package Rivlo.ContentExporter.Umbraco8 -Version 8.0.0-beta2
                    
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="Rivlo.ContentExporter.Umbraco8" Version="8.0.0-beta2" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Rivlo.ContentExporter.Umbraco8" Version="8.0.0-beta2" />
                    
Directory.Packages.props
<PackageReference Include="Rivlo.ContentExporter.Umbraco8" />
                    
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 Rivlo.ContentExporter.Umbraco8 --version 8.0.0-beta2
                    
#r "nuget: Rivlo.ContentExporter.Umbraco8, 8.0.0-beta2"
                    
#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 Rivlo.ContentExporter.Umbraco8@8.0.0-beta2
                    
#: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=Rivlo.ContentExporter.Umbraco8&version=8.0.0-beta2&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Rivlo.ContentExporter.Umbraco8&version=8.0.0-beta2&prerelease
                    
Install as a Cake Tool

Rivlo Content Exporter for Umbraco 8

Rivlo.ContentExporter.Umbraco8 is a lightweight API-only tool that enables structured export of content and members from Umbraco 8 sites. It is ideal for use in site upgrade or migration workflows and is extensible via custom property value handlers.

⚠️ This package is provided free of charge, with no licensing or API key enforcement. It supports export only (no import functionality) and has no backoffice UI. For full migration tooling across modern Umbraco versions (v10+), visit www.rivlotools.com.


✨ Features

  • Export Umbraco content by document type and property alias
  • Export member data including groups and hashed passwords
  • Extensible via custom IPropertyValueHandler implementations
  • Supports media URL resolution from UDI references
  • Lightweight, API-only — no UI dependencies

📦 Installation

Install via NuGet:

Install-Package Rivlo.ContentExporter.Umbraco8 -Version 8.0.0-beta1

Target framework: .NET Framework 4.7.2

Umbraco dependency: 8.6.0+

🚀 Usage

📄 Export Content

Send a GET request to:

/umbraco/api/ContentExporter/ExportContent?documentTypeAlias=[alias]&propertyAliases=[alias1,alias2,...]

🔧 Query Parameters:

Parameter Required Description
documentTypeAlias ✅ Yes The alias of the content type you want to export
propertyAliases ✅ Yes Comma-separated list of property aliases to include
parentId ❌ No Limits export to content under a specific node ID
recursive ❌ No (default: true) If true, exports all descendants of the parent; if false, only immediate children
includeParent ❌ No (default: true) If true, includes the parent node in the results (if it matches the content type)
🧪 Examples:

Export all newsArticle content anywhere on the site:

/umbraco/api/ContentExporter/ExportContent?documentTypeAlias=newsArticle&propertyAliases=heading,image,bodyText

Export all event content under node 1234, recursively:

/umbraco/api/ContentExporter/ExportContent?documentTypeAlias=event&propertyAliases=title,date,location&parentId=1234

Export only first-level children under node 5678, excluding the parent:

/umbraco/api/ContentExporter/ExportContent?documentTypeAlias=product&propertyAliases=name,sku,price&parentId=5678&recursive=false&includeParent=false

This will return a structured JSON array of content items with matching type and properties.

👤 Export Members

Send a GET request to:

/umbraco/api/MemberExport/ExportAll

Returns an array of members including:

  • Username
  • Email
  • Name
  • Password hash (if available)
  • Custom properties
  • Member groups

🧩 Extending Property Handling

You can create custom handlers for complex or structured property types by implementing:

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

Register your handler with Umbraco DI via a Composer:

[RuntimeLevel(MinLevel = RuntimeLevel.Run)]
public class MyHandlerComposer : IUserComposer
{
    public void Compose(Composition composition)
    {
        composition.Register<IPropertyValueHandler, MyCustomHandler>(Lifetime.Singleton);
    }
}

⚠️ Limitations

  • This package is intended for export only.
  • No import functionality is included.
  • No backoffice dashboard is provided.
  • No authentication or API key protection is implemented — use responsibly.
  • Support is community-based and limited to the current version.

📝 License

This package is distributed under a proprietary licence. You may use it freely in commercial or private projects, but redistribution is not permitted.

For the full End User Licence Agreement (EULA), see: https://www.rivlotools.com/products/content-exporter-umbraco8/eula

💬 Feedback & Upgrades

Looking for import support, API keys, or Umbraco 10+ compatibility?

👉 Check out the full RivloTools suite www.rivlotools.com

Product Compatible and additional computed target framework versions.
.NET Framework net472 is compatible.  net48 was computed.  net481 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
8.0.0-beta2 195 8/6/2025
8.0.0-beta1 198 8/5/2025