SplatDev.Umbraco.Plugins.Schema2Yaml
2.1.2
dotnet add package SplatDev.Umbraco.Plugins.Schema2Yaml --version 2.1.2
NuGet\Install-Package SplatDev.Umbraco.Plugins.Schema2Yaml -Version 2.1.2
<PackageReference Include="SplatDev.Umbraco.Plugins.Schema2Yaml" Version="2.1.2" />
<PackageVersion Include="SplatDev.Umbraco.Plugins.Schema2Yaml" Version="2.1.2" />
<PackageReference Include="SplatDev.Umbraco.Plugins.Schema2Yaml" />
paket add SplatDev.Umbraco.Plugins.Schema2Yaml --version 2.1.2
#r "nuget: SplatDev.Umbraco.Plugins.Schema2Yaml, 2.1.2"
#:package SplatDev.Umbraco.Plugins.Schema2Yaml@2.1.2
#addin nuget:?package=SplatDev.Umbraco.Plugins.Schema2Yaml&version=2.1.2
#tool nuget:?package=SplatDev.Umbraco.Plugins.Schema2Yaml&version=2.1.2
Schema2Yaml
Export Umbraco document types to YAML format — reverse operation of Yaml2Schema. Exports content types, media types, members, and content to YAML files for version control or migration.
Compatibility
| Umbraco | .NET | Package Version |
|---|---|---|
| 13.x | 8.0 | 2.0.7 |
| 17.x | 10.0 | 2.0.7 |
Installation
dotnet add package SplatDev.Umbraco.Plugins.Schema2Yaml
Quick Start
No explicit registration required — the plugin self-registers via Schema2YamlComposer on startup and the dashboard appears automatically in the Settings section of the backoffice.
Configuration
Add to appsettings.json:
{
"UmbracoSchema2Yaml": {
"ExportPath": "exports/umbraco.yml",
"IncludeMedia": true,
"IncludeContent": true,
"IncludeMembers": true,
"IncludeUsers": false
}
}
| Key | Type | Default | Description |
|---|---|---|---|
ExportPath |
string | exports/umbraco.yml |
Output file path |
IncludeMedia |
bool | true | Export media types |
IncludeContent |
bool | true | Export document types |
IncludeMembers |
bool | true | Export member types |
IncludeUsers |
bool | false | Export user definitions |
Usage
Access the Schema2Yaml dashboard from the Umbraco Settings section. Select the entity types to export and click "Export" to generate a YAML file at the configured path. Use the resulting YAML with Yaml2Schema to import into another Umbraco instance.
Known Limitations
- Exports to a single YAML file — no support for splitting into multiple files per content type
- Export path is relative to the application root; ensure the directory is writable
- No incremental/delta export; always exports the full schema
Changelog
2.1.2 — 2026-08-24
Removes a dashboard screenshot that showed an error toast. It was captured against a site where this plugin's API was unreachable, so it advertised a broken dashboard. No screenshot is better than a misleading one; a replacement will be taken against a working install.
2.1.1 — 2026-08-24
Package metadata only: the listing now carries an icon and search tags, and the project and repository links point at the organisation that actually hosts this code. No code changes.
2.1.0 — 2026-08-23
Fixes the Umbraco Marketplace listing, which pointed its screenshot at a different repository and returned 404 — so the entry showed a broken image.
2.0.10 — 2026-08-22
- The backoffice dashboard now appears. Its assets lived under
wwwroot/App_Plugins/, which is not a path Umbraco or the static-file middleware ever serves from — every request for the manifest and the bundle returned 404, so the dashboard was unreachable on any install. - The plugin now embeds its
App_Pluginsin the assembly, serves them from there, and registers its own package manifest, matching every other plugin in this repo. It no longer depends on abuildTransitivecopy step that silently does nothing when it fails.
License
MIT © SplatDev
| Product | Versions 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 is compatible. 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. |
-
net10.0
- Microsoft.Extensions.FileProviders.Embedded (>= 10.0.6)
- Umbraco.Cms.Core (>= 17.0.0 && < 18.0.0)
- Umbraco.Cms.Web.Common (>= 17.0.0 && < 18.0.0)
- YamlDotNet (>= 15.1.0)
-
net8.0
- Umbraco.Cms.Core (>= 13.0.0 && < 14.0.0)
- Umbraco.Cms.Web.Common (>= 13.0.0 && < 14.0.0)
- YamlDotNet (>= 15.1.0)
-
net9.0
- Umbraco.Cms.Core (>= 15.0.0 && < 17.0.0)
- Umbraco.Cms.Web.Common (>= 15.0.0 && < 17.0.0)
- YamlDotNet (>= 15.1.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 |
|---|---|---|
| 2.1.2 | 0 | 8/24/2026 |
| 2.1.1 | 0 | 8/24/2026 |
| 2.1.0 | 36 | 8/23/2026 |
| 2.0.10 | 38 | 8/22/2026 |
| 2.0.9 | 51 | 8/20/2026 |
| 2.0.8 | 892 | 6/1/2026 |
| 2.0.7 | 174 | 5/16/2026 |
| 2.0.7-v1.0.38 | 58 | 5/16/2026 |
| 2.0.6 | 102 | 5/16/2026 |
| 2.0.5 | 150 | 4/7/2026 |
| 2.0.4 | 125 | 4/7/2026 |
| 1.0.12 | 114 | 4/7/2026 |
| 1.0.11 | 111 | 4/7/2026 |
v2.0.7: Fix auth token — revert _getToken() to getLatestToken() (getOpenApiConfiguration() has no .token, causing 401 on every API call). Fix .chip.selected text contrast (white text on dark background). v2.0.6: Fix ExportProfile route templates, WCAG UI/UX audit, contrast fixes.