Rivlo.ContentExporter.Umbraco8
8.0.0-beta2
dotnet add package Rivlo.ContentExporter.Umbraco8 --version 8.0.0-beta2
NuGet\Install-Package Rivlo.ContentExporter.Umbraco8 -Version 8.0.0-beta2
<PackageReference Include="Rivlo.ContentExporter.Umbraco8" Version="8.0.0-beta2" />
<PackageVersion Include="Rivlo.ContentExporter.Umbraco8" Version="8.0.0-beta2" />
<PackageReference Include="Rivlo.ContentExporter.Umbraco8" />
paket add Rivlo.ContentExporter.Umbraco8 --version 8.0.0-beta2
#r "nuget: Rivlo.ContentExporter.Umbraco8, 8.0.0-beta2"
#:package Rivlo.ContentExporter.Umbraco8@8.0.0-beta2
#addin nuget:?package=Rivlo.ContentExporter.Umbraco8&version=8.0.0-beta2&prerelease
#tool nuget:?package=Rivlo.ContentExporter.Umbraco8&version=8.0.0-beta2&prerelease
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
- 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 | Versions Compatible and additional computed target framework versions. |
---|---|
.NET Framework | net472 is compatible. net48 was computed. net481 was computed. |
-
.NETFramework 4.7.2
- Newtonsoft.Json (>= 12.0.3)
- UmbracoCms.Core (>= 8.6.0 && < 9.0.0)
- UmbracoCms.Web (>= 8.6.0 && < 9.0.0)
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 |