Umbraco → WordPress

Umbraco to WordPress migration

Translate Umbraco document types and property-editor values into a prepared WordPress content model using the Delivery API or approved source access, while separating members, templates, compositions, and custom .NET behavior from portable content.

Self-service migration path

Start with your actual Umbraco data

This pair is not currently listed as a fully supported self-service direction. umbraco: Beta. wordpress: Available. Review system status and directions. Available migration objects and capabilities depend on the selected source and target systems.

Create an account, connect a staging destination, and let the app analyze the supported scope for this direction.

No credit card required to analyze the migration and run a free sample.

Scope

What can move and what needs review

The app confirms available entities after connection. Final coverage depends on source access, downloadable assets, and the destination model you prepare.

Supported scope

  • Published content items, content type aliases, hierarchy, names, routes, dates, cultures, and accessible properties from the Umbraco Delivery API
  • WordPress pages, posts or custom types, fields, authors, taxonomies, media, slugs, source IDs, and redirects

Confirm after connection

  • Delivery API enablement, preview access, property expansion, Block List/Grid values, compositions, variants, media, document types, redirects, and unpublished content
  • Management API availability, backoffice authors, members, protected content, custom property editors, and destination blocks/fields

Separate or custom work

  • Member authentication, passwords, groups, protected-content behavior, custom indexes, relations, and application data
  • Razor views, templates, macros, Surface/API controllers, packages, workflows, forms, and .NET integrations

Before you connect

Access requirements

Use a staging destination and the least-privilege access supported by each platform. Do not send credentials through a public form.

Delivery API access

Enable the Umbraco Content Delivery API and provide the site URL. Supply the API key only when public access is disabled or preview data is explicitly in scope.

Optional Management API access

Provide a least-privilege client ID and secret only if document types, media, users, members, redirects, or unpublished records require Management API coverage.

WordPress staging

Prepare post types, taxonomies, fields/blocks, users, media, multilingual and SEO plugins, permalinks, and authenticated destination access.

How it works

From connection to full migration

You control each stage in the app. Optional expert assistance is available for custom data or destination requirements.

01

Choose Umbraco and WordPress

Start in the app and select the real source and target.

02

Connect both systems

Authorize read access to Umbraco and connect a prepared staging WordPress destination.

03

Analyze the source

Review detected records, available entities, media, URLs, and anything that needs a decision.

04

Confirm the mapping

Choose where supported Umbraco data belongs in the prepared WordPress model.

05

Run a free sample migration

Move a small set of real records to staging and inspect the result before purchasing the full migration.

06

Validate and launch

Review counts, records, media, links, warnings, and exceptions, then purchase and start the full migration when ready.

Technical detail

Platform-specific migration notes

Open only the detail you need for planning, mapping, or validation.

Current app compatibility

Umbraco is beta and source-only in the site snapshot. The current app has a dedicated Delivery API source adapter, integration coverage, and an Umbraco-to-WordPress E2E scenario for Umbraco 13 fixtures.

Umbraco source path

Published content is read primarily through /umbraco/delivery/api/v2. An API key can unlock protected API access; optional Management API credentials are reviewed only where backoffice data is required.

WordPress destination path

Document types and properties are routed into a prepared WordPress model after hierarchy, property-editor, media, culture, and URL rules are approved.

Umbraco to WordPress compatibility matrix

Standard covers published Delivery API content. Property editors, backoffice records, protected content, and application behavior require explicit review.

Umbraco sourceWordPress targetStatus and boundary
Published content itemsPages, posts, or prepared custom post typesStandard with modeling: route each contentType alias to an approved destination type.
Document type aliases and propertiesPost types, fields, taxonomies, or blocksReview: property editor and value shape determine the transformation.
Content tree hierarchy and routesPage parents and permalinksStandard with URL review: preserve parent context while approving final paths.
Block List, Block Grid, Nested Content, and compositionsBlocks, repeaters, child records, or fieldsReview/custom: nested values and rendering need schema-specific transformation.
Cultures and variantsConfigured multilingual modelReview: use culture, route, translation group, and fallback rules.
Media library items and pickersWordPress media and referencesReview: expand media values, download originals, upload, and rewrite.
Backoffice users used as authorsWordPress authorsReview: Delivery API may not expose full author profiles; Management access can be required.
Tags and category-like document typesTaxonomiesReview: Umbraco has no universal taxonomy model, so each source schema is inspected.
Draft and preview contentWordPress draft/private stateReview: requires configured preview access and an explicit retention policy.
Members and protected contentMembership or access-control solutionSeparate security scope: profiles do not reproduce authentication or protection rules.
Templates, Razor views, controllers, packages, and formsTheme, plugins, forms, or applicationsRebuild: .NET behavior does not transfer as JSON content.
Example Umbraco to WordPress mapping rules

The mapping contract is organized by content type and property editor, not by field names alone.

Umbraco valueMigration ruleWordPress result
Content GUID and idPreserve stable identity and source routeDestination ID map and rerun lookup
contentType aliasRoute through the approved type matrixPage, post, or custom post type
name and route.pathMap title and approve destination slug hierarchyTitle, permalink, and URL-map entry
properties by aliasTransform according to property editor and value shapeCore field, post meta, ACF, block, or taxonomy
Block List/Grid JSONResolve element types, order, nested values, and referencesBlocks, repeaters, or child records
Media picker valueExpand media, download, validate, upload, and resolve IDWordPress media reference
cultures and Accept-Language variantGroup translations and map localeMultilingual destination relationship
createDate/updateDate and stateNormalize timestamps and approved visibilityWordPress dates and status
Map Umbraco document types and property editors

Two Umbraco fields with similar labels can return entirely different JSON depending on their property editors.

Inventory document types

Capture aliases, compositions, properties, data types, allowed children, cultures, variations, and content counts.

Profile property values

Sample text, rich text, links, pickers, media, blocks, grids, nested content, repeaters, and custom editors.

Prepare WordPress types

Approve post types, taxonomies, fields, blocks, relationships, authors, and fallback handling before loading.

Load dependencies first

Create authors, taxonomies, media, and reusable referenced records before dependent documents resolve IDs.

Use Delivery API and Management API deliberately

Published delivery content and backoffice management data have different access and risk profiles.

Start with Delivery API

Read published JSON, routes, cultures, properties, hierarchy, and expanded references through the least-privilege source.

Add preview only when needed

Use an API key for draft or restricted Delivery API access only when those records are approved scope.

Limit Management credentials

Request OAuth credentials only for required document type, media, user, member, redirect, or unpublished-data gaps.

Keep members separate

Treat member profiles, passwords, groups, protected routes, and authentication as a distinct security workstream.

Validate Umbraco routes, variants, media, and blocks

Acceptance must cover the rendered result of transformed property data, not only source JSON counts.

Reconcile by content type

Compare source, extracted, transformed, loaded, skipped, failed, published, draft, and culture totals.

Inspect complex properties

Review blocks, grids, pickers, compositions, media, links, variants, dates, and custom-editor fallbacks.

Crawl route variants

Test source routes, language paths, redirects, canonicals, sitemap entries, internal links, and media URLs.

Confirm repeatability

Validate source-to-target IDs, relationship resolution, reruns, documented exceptions, cutover checks, and monitoring.

Technical references

Before purchase

Verify real output in staging

The free sample migration creates a limited set of records in staging. Check fields, relationships, media, URLs, rendering, and reported exceptions before paying for the full run.

Pricing

One migration, one-time payment

Package fit depends on supported record volume and complexity. Analyze the source first, then review the fixed package or dynamic estimate shown for the migration.

Compare migration packages

Plan the move

Umbraco to WordPress guides

Umbraco migration workflows

Review Delivery API access, document types, property editors, cultures, media, and members.

Open guide →

WordPress migration workflows

Review WordPress destination modeling, users, taxonomies, media, SEO, and custom fields.

Open guide →

CMS migration workflows

Understand the broader self-service migration scope and delivery boundaries.

Open guide →

CMS migration cost

See package limits, estimate factors, exclusions, and fixed-scope rules.

Open guide →
More migration planning guides

Clear answers

Frequently asked questions

The current app uses the v2 Content Delivery API and has an Umbraco 13 E2E fixture. Other versions are accepted only after endpoint and property-shape verification.

Yes for the standard source path. Public access or an API key must expose the approved content.

Yes after element types, nested properties, ordering, references, and destination blocks or fields are mapped.

Yes when cultures and variants are accessible and the WordPress multilingual model, translated paths, and fallbacks are prepared.

Accessible media values and originals can be expanded, downloaded, validated, uploaded, and rewritten.

Not as standard content. Members, passwords, groups, protected routes, and authentication require a separate security and destination design.

No. Views, controllers, packages, forms, integrations, and custom application behavior require WordPress-native redevelopment.

Next step

Start your Umbraco to WordPress migration

Create an account, connect the systems, and analyze the supported scope before purchasing the full migration.