/resources/umbraco-wordpress-migration/pre-migration/
What We Do
Digital Platform MigrationsKey SolutionsManaged ServicesStaffing SolutionsIndustriesProducts
OnePress
Unify multiple brands on one governed WordPress platform.
Design & UI/UX
Gutenberg-native UX, UI, and design systems for visitors and editors.
WordPress Modernization
Modernize WordPress for better performance, architecture, and AI readiness.
WordPress as a DXP
WordPress as a composable DXP when monolithic systems no longer cut it.
Headless WordPress
Omnichannel content delivery without sacrificing marketing autonomy.
Frappe/ERPNext
Build scalable ERP and custom applications, from implementation to ongoing support.
Discovery
Strategic consultancy & project roadmap
Growth Services
On demand development & consultation
Site Maintenance
Annual maintenance. Done for you
QE Services
Testing across SDLC for assured quality
Hosting Migration
Move to a performant hosting with zero downtime
WooCommerce
Enterprise commerce delivered without lock-in
AI
Unlock real use cases and integrations
All Services
A suite of services for any need
Technology STACK
eCommerce
Scale your e-commerce with WooCommerce, integrations, and custom extensions for growth.
EasyEngine
Server management tool that makes using WordPress on Nginx easy.
Web Auditor
Performance Audit & Insights for your Website.
rtMedia
A complete media management plugin for WordPress.
Resources
About Us
CLEAR
Resources Umbraco to WordPress migration guide: Costs, risks, and when it’s worth doing Pre-migration setup
Topics
On this page
- Umbraco to WordPress migration guide: Costs, risks, and when it's worth doing
- Migration process, timeline & team
- Pre-migration setup
Set up the right technical environment
Development environment
Backup procedures
Testing framework
Content preparation
Content mapping
Export content from Umbraco
Import to WordPress
Data cleanup
Asset organization
SEO considerations
Set up URL redirects
Transfer metadata
Preserve canonical tags
Choose an SEO plugin
Final note
Last updated on Sep 22, 2026
Umbraco to WordPress: Pre-migration
The pre-migration phase is where a successful transition begins. It’s about more than just checklists; it’s the foundation for a stable, accurate, and disruption-free migration from Umbraco to WordPress.
This stage is focused on three key areas: technical setup, content preparation, and SEO continuity. Getting these right ensures your migration process runs smoothly and reduces the likelihood of data loss, misalignment, or performance issues.
Set up the right technical environment
A reliable technical setup is what enables realistic testing and smooth execution, without disrupting your live Umbraco website.
Development environment
Start by creating a dedicated development environment that mirrors your eventual production setup. This isolated environment allows your team to build and test themes, plugins, content structure, and integrations without interfering with ongoing site operations.
To ensure consistency across teams and machines:
- Use Docker for environment reproducibility
- Set up Git-based version control with branching strategies
- Implement CI/CD pipelines for automated testing and deployment
- Use local tools like LocalWP, DevKinsta, or Laravel Valet for simple and collaborative development
This environment becomes your sandbox for validating every piece before go-live.
Backup procedures
No migration should proceed without a full backup of your existing Umbraco instance. This should include:
- Your database, containing all content, metadata, and structure
- All media files, including images, videos, and downloads
- Custom code, such as Razor views, templates, or extensions
While Umbraco supports automated backups, also take manual backups using FTP and SQL exports for redundancy. Store backups securely on cloud storage or external drives to ensure fast restoration in case of rollback.
Testing framework
As development progresses, set up a comprehensive testing framework that covers:
- Functional testing: Confirm forms, navigation, search, and interactive elements are working as expected
- Design testing: Compare the new WordPress frontend with your existing Umbraco design for visual consistency
- Performance testing: Use tools like Google PageSpeed Insights, Lighthouse, or GTmetrix to benchmark site speed and responsiveness
- Content validation: Check that all migrated pages, posts, metadata, and media are complete and correctly displayed
Content preparation
Maintain your content’s integrity and structure throughout the migration.
Content mapping
Based on a detailed audit of the Umbraco content tree, create a mapping sheet to align it with WordPress structure:
- Umbraco Content Nodes: Map to WordPress posts, pages, or custom post types.
- Custom Fields in Umbraco: Transfer to Advanced Custom Fields (SCF) in WordPress.
- Parent-Child Relationships: Maintain hierarchies for menus, categories, and subpages.
Below is a table mapping common elements from Umbraco to WordPress:
Content TypeUmbracoWordPressNotesPagesContent nodes with custom fields.WordPress Pages with custom fields.Ensure custom fields are mapped correctly.PostsBlog posts managed through Umbraco.WordPress Posts managed through the dashboard.Ensure blog posts are migrated with metadata.MediaImages, videos, and documents managed through Umbraco.Media managed through WordPress Media Library.Ensure media URLs are updated correctly.Custom post typesCustom document types in Umbraco.Custom post types in WordPress.Need to recreate custom post types in WordPress.TaxonomiesCategories and tags managed through Umbraco.Categories and tags managed through WordPress.Ensure taxonomies are mapped correctly.
Different sites require different methods, and the choice depends on factors such as site size, customizations, and timelines. Common strategies include:
- Automated migration: Ideal for bulk data transfers, such as blogs or media releases.
- Manual migration: Suitable for websites or where content structure and design require significant changes.
- Hybrid migration: Combines automation for repetitive tasks with manual migration for complex pages.
We typically use a hybrid migration approach, combining scripts and tools for structure, with manual QA for accuracy.
Export content from Umbraco
Export content using Umbraco’s built-in features (e.g., Umbraco Deploy or uSync) or third-party tools like SQL Server Management Studio, to ensure all the tables are captured.
- Consider using the Aspose .NET Database Data Exporter module for Umbraco, which allows exporting data directly from your database into various formats, including Excel and CSV. This module requires installation and configuration but provides a straightforward interface for exporting data.
- Scrape the website content from the frontend, which may be needed in case of legacy CMS versions like Umbraco 7.
- Export formats may include XML, CSV, or JSON, ensuring compatibility with WordPress import tools.
Here’s a simplified example of what an exported Umbraco page (document type “BlogPost”) might look like in XML format:
<node id="1234" parentID="5678" nodeTypeAlias="BlogPost" level="2" path="-1,5678,1234" sortOrder="1" uniqueID="guid:456789ab-cdef-1234-abcd-ef1234567890">
<name>My First Blog Post</name>
<properties>
<pageTitle>My First Blog Post</pageTitle>
<bodyText><![CDATA[<p>This is the body text of my first blog post.</p>]]></bodyText>
<publishDate>2023-11-22T12:34:56Z</publishDate>
<author>John Doe</author>
<categories>Technology, Programming</categories>
</properties>
</node>
Explanation of the XML Structure:
-
Node: The root element representing a single node in Umbraco.
-
Attributes:
id: Unique identifier of the node.parentID: ID of the parent node.nodeTypeAlias: Alias of the document type.level: Level of the node in the content tree.path: Path to the node, including parent IDs.sortOrder: Order of the node among its siblings.uniqueID: Unique identifier of the node.
-
Name: The name of the node.
-
Properties: A container for the node’s properties.
- Property: Each property is represented by its name and value.
- CDATA: Used to escape HTML content within the
bodyTextproperty to prevent XML parsing issues.
Import to WordPress
Import content using WordPress import tools:
- Use native WordPress import options, including REST API.
- Convert and import the database into WordPress using tools like WP All Import or custom scripts.
- Maintain content hierarchies (e.g., parent-child relationships) during import.
An example of a script to convert Umbraco nodes to WordPress posts and properties to custom fields or taxonomies:
async function mapUmbracoXMLToWordPress(xmlData) {
// Parse the XML data
const parser = new DOMParser();
const xmlDoc = parser.parseFromString(xmlData, "text/xml");
// Replace with your WordPress REST API URL and authentication details
const WP_API_URL = "https://ancillary-proxy.atarimworker.io?url=https%3A%2F%2Fyour-wordpress-site.com%2Fwp-json%2Fwp%2Fv2%2F%26%2334;;
const WP_USERNAME = "your_username";
const WP_PASSWORD = "your_password";
// Function to fetch WordPress categories
async function fetchWordPressCategories(categoryNames) {
// ... same as in the previous script
}
// Iterate through Umbraco nodes
const nodes = xmlDoc.getElementsByTagName("node");
for (const node of nodes) {
const wpPostData = {
title: node.getElementsByTagName("name")[0].textContent,
content: node.getElementsByTagName("bodyText")[0].textContent,
status: 'publish', // Adjust status as needed
categories: [],
};
// Map categories
const categoryNames = node.getElementsByTagName("categories")[0].textContent.split(',');
const wpCategories = await fetchWordPressCategories(categoryNames);
wpPostData.categories = wpCategories.map(category => category.id);
// Map other properties as needed (custom fields, etc.)
// Send the post data to WordPress REST API
// ... same as in the previous script
}
}
// Assuming you have Umbraco XML data
const xmlData = `
`;
mapUmbracoXMLToWordPress(xmlData);
Data cleanup
Before migrating, it’s important to evaluate your existing content with a critical eye. Start by identifying outdated, redundant, or irrelevant content that no longer serves your audience or business goals. Removing this early helps reduce clutter and keeps your new WordPress instance lean and purposeful.
Next, review the formatting of the remaining content. Ensure consistency in heading levels, spacing, and internal linking so everything aligns with modern web standards and works well within WordPress’s block-based editing environment.
It’s also useful to tag high-performing or strategically important content, like landing pages, cornerstone blog posts, or SEO-critical articles, for early migration and thorough validation post-launch. These pieces often anchor traffic and should be prioritized accordingly.
Asset organization
Migrating media assets requires more than just bulk copying files over. Begin with a full audit of your Umbraco media library to sort assets by type, usage, and importance. This ensures a smooth handoff to WordPress and reduces post-migration cleanup.
Organize and optimize your media in the following ways:
- Images: Compress and resize for performance, ensure correct aspect ratios and alt text are retained
- Videos: Confirm supported formats and consider hosting large files externally (e.g., YouTube, Vimeo) if needed
- Documents: Standardize naming conventions and organize into clearly labeled folders or collections
Once optimized, upload assets into the WordPress Media Library and ensure metadata, such as alt text, captions, and descriptions, is preserved or enhanced. This not only improves SEO but also supports accessibility standards.
SEO considerations
Preserving your SEO equity during migration is non-negotiable. A thoughtful pre-migration SEO strategy helps retain rankings, avoid crawl issues, and ensure a smooth transition for search engines and users alike.
Set up URL redirects
One of the most important steps is mapping old URLs to new ones. Create a URL mapping sheet that aligns each Umbraco URL with its WordPress counterpart. This document will guide your redirect strategy.
- Use 301 redirects to preserve link equity
- Implement redirects using a plugin like Redirection
- Alternatively, configure redirects at the server level (e.g., via
.htaccessor NGINX) for performance and control
Transfer metadata
Umbraco stores important on-page SEO data like meta titles, descriptions, and alt tags that should move with your content.
- Extract metadata using tools like uSync or SQL exports
- Import into WordPress using SEO plugins such as Yoast SEO or Rank Math
- Ensure all metadata fields (titles, descriptions, image alt text) are mapped and retained correctly
Preserve canonical tags
If your Umbraco site uses canonical URLs to manage duplicate content, make sure they’re preserved in the WordPress setup.
- Add canonical fields to your SEO plugin configuration
- Review URLs manually where necessary to ensure they point to the right destination
- Avoid auto-generating canonical tags unless they match your URL strategy
Choose an SEO plugin
Select a reliable SEO plugin to centralize SEO configuration and management. Look for features like:
- Metadata editing (titles, descriptions, canonical tags)
- XML sitemap generation
- Schema markup support
- Integration with Google Search Console
Recommended tools include Yoast SEO and Rank Math, both enterprise-ready and widely supported.
Reconnect analytics and monitoring tools
After migration, re-enable performance tracking and crawling diagnostics.
- Set up Google Analytics on the new WordPress site
- Register your new sitemap and site URLs in Google Search Console
- Use crawl stats and error reports to quickly identify issues like missing redirects or 404s
Final note
Pre-migration SEO planning is what ensures your WordPress site launches without sacrificing visibility. When done right, it prevents ranking drops, maintains traffic, and gives your new platform a strong foundation from day one.
Migration process, timeline & team
PREVIOUS
Credits
Aviral Mittal
Author
Aviral Mittal
Author
Aviral Mittal is the Chief Marketing Officer at rtCamp, where he established and leads the marketing function, building and growing a team of 20+ specialists across content, SEO, design, and growth…
Contributions and Updates: Usama 
Good Work. Good People.
Industry partnerships
Compliance certifications
United States India
© rtCamp Inc. since 2009. All rights reserved.
Terms of Service · Privacy Policy · Trust Center
Company
Solutions
Subscribe to our newsletter and get a few email updates every month.
United States India
© rtCamp Inc. since 2009. All rights reserved.
Terms of Service · Privacy Policy · Trust Center
Cookie Consent
We value your privacy
We use cookies to give you the best possible experience. By clicking “Accept,” you consent to our use of cookies to improve site functionality, analyze usage, and personalize content and communications. Your privacy matters to us, and we are committed to handling your data responsibly and transparently. Please check our Privacy Policy for more details.
Manage PreferencesDon’t AllowAllow All
Why do we use cookies?
×
By clicking "Accept" or "Decline All" at the bottom, you consent to the use of cookies and other tools as described in our Cookie Policy in accordance with your settings and accept our Terms of Service.
Toggle EssentialEssential
Essential cookies enable basic functions and are necessary for the proper function of the website.
Name
Description
Duration
Geolocation Config
This cookie is used to store the consent settings based on the visitor's location.
30 days
Cookie Preferences
This cookie is used to store the user's cookie consent preferences.
30 days
Toggle CloudFlareCloudFlare
CloudFlare provides web performance and security solutions, enhancing site speed and protecting against threats.
Service URL: developers.cloudflare.com (opens in a new window)
Name
Description
Duration
cf_clearance
Whether a CAPTCHA or Javascript challenge has been solved.
session
Toggle CommentsComments
These cookies are needed for adding comments on this website.
Name
Description
Duration
comment_author
Used to track the user across multiple sessions.
Session
comment_author_email
Used to track the user across multiple sessions.
Session
comment_author_url
Used to track the user across multiple sessions.
Session
Toggle GodamGodam
GoDAM" is primarily a specialized WordPress plugin and media management service designed to enhance video hosting, marketing, and asset management directly within the WordPress dashboard.
Service URL: godam.io (opens in a new window)
Name
Description
Duration
user_image
Temporarily stores the path to the user's avatar or profile picture for quick rendering in the website header.
session
user_id
Stores the numerical ID of the logged-in user to maintain session continuity and basic site operations.
session
full_name
Stores the logged-in user's display name to personalize the site interface without needing database queries.
session
system_user
First-party cookie used to store basic application state identifying the current system user role.
session
sid
A generic session ID cookie used to maintain user state and functionality as the visitor navigates through the site.
session
Toggle Google reCAPTCHAGoogle reCAPTCHA
Google reCAPTCHA helps protect websites from spam and abuse by verifying user interactions through challenges.
Name
Description
Duration
_GRECAPTCHA
Google reCAPTCHA sets a necessary cookie (_GRECAPTCHA) when executed for the purpose of providing its risk analysis.
179 days
Toggle Google Tag ManagerGoogle Tag Manager
Google Tag Manager simplifies the management of marketing tags on your website without code changes.
Name
Description
Duration
cookiePreferences
Registers cookie preferences of a user
2 years
td
Registers statistical data on users' behaviour on the website. Used for internal analytics by the website operator.
session
Toggle StatisticsStatistics
Statistics cookies collect information anonymously. This information helps us understand how visitors use our website.
Toggle Factors AIFactors AI
Factors.ai is a B2B account intelligence and marketing analytics platform that helps Go-To-Market (GTM) teams identify anonymous website visitors, track buyer journeys, and measure the ROI of marketing campaigns.
Service URL: www.factors.ai (opens in a new window)
Name
Description
Duration
_fuid
It is sent to capture session details and track user behavior across your website to provide behavioral data and intent signals.
1 Year
Toggle Google AnalyticsGoogle Analytics
Google Analytics is a powerful tool that tracks and analyzes website traffic for informed marketing decisions.
Service URL: policies.google.com (opens in a new window)
Name
Description
Duration
FPGSID
Stores a session or user identifier to track how visitors interact with a website. This helps Google Analytics measure website performance, user engagement, and usage patterns.
Session
FPLC
Used by Google Analytics to link visitor interactions and sessions across multiple related domains.
20 hours
FPID
A server-side Google Analytics cookie used as an alternative user identifier when third-party cookies are restricted.
2 years
_ga
ID used to identify users
2 years
_ga_
ID used to identify users
2 years
Toggle Jetpack StatsJetpack Stats
Jetpack's built-in visitor analytics. It records page views, referring sites, search terms, and outbound link clicks, and also carries the shared visitor-tracking library used by Jetpack Instant Search and WooCommerce Analytics.
Service URL: automattic.com (opens in a new window)
Name
Description
Duration
tk_aip
Stores a list of anonymous visitor IDs so they can be merged into one identity once a visitor is recognized.
Up to 5 years
tk_tc
Used once per page load to work out which cookie domain the Tracks library should use, then removed as soon as it's read back.
Session (deleted immediately after use)
tk_qs
Queues analytics events for Jetpack's Tracks library so none are lost if the page closes before they can be sent.
30 minutes
tk_ai
Stores a randomly-generated anonymous visitor ID so Jetpack's Tracks analytics library can link tracking events to the same visitor.
Session in wp-admin; up to 5 years on the frontend
Toggle Microsoft ClarityMicrosoft Clarity
Clarity is a web analytics service that tracks and reports website traffic.
Service URL: clarity.microsoft.com (opens in a new window)
Name
Description
Duration
CLID
Identifies the first-time Clarity saw this user on any site using Clarity.
12 months
ANONCHK
Indicates whether MUID is transferred to ANID, a cookie used for advertising. Clarity doesn't use ANID and so this is always set to 0.
Session
_clck
Persists the Clarity User ID and preferences, unique to that site is attributed to the same user ID.
12 months
_clsk
Connects multiple page views by a user into a single Clarity session recording.
12 months
Toggle Parse.lyParse.ly
Parse.ly is a content analytics platform that helps publishers optimize audience engagement and content performance.
Name
Description
Duration
_parsely_session
JSON document storing information identifying a browsing session according to Parsely’s proprietary definition
30 minutes
_parsely_visitor
JSON document uniquely identifying a browser and counting its sessions
13 months
cookies.js_dtest
This cookie determines whether the browser accepts cookies.
session
Toggle MarketingMarketing
Marketing cookies are used to follow visitors to websites. The intention is to show ads that are relevant and engaging to the individual user.
Toggle Bing / MicrosoftBing / Microsoft
Bing, powered by Microsoft, is a search engine providing web, image, video, and map search capabilities.
Name
Description
Duration
MR
Used to collect information for analytics purposes.
6 months
ANONCHK
Used to store session ID for a users session to ensure that clicks from adverts on the Bing search engine are verified for reporting purposes and for personalisation
10 minutes
SM
Used by Microsoft in synchronizing the MUID across multiple Microsoft domains to track users for advertising.
session
MUID
Identifies unique web browsers visiting Microsoft sites. These cookies are used for advertising, site analytics, and other operational purposes.
1 year
Toggle DoubleClick/Google MarketingDoubleClick/Google Marketing
A comprehensive digital advertising platform for managing campaigns, optimizing performance, and analyzing audience data.
Name
Description
Duration
IDE
This cookie is used for targeting, analyzing and optimisation of ad campaigns in DoubleClick/Google Marketing Suite
2 years
ar_debug
Store and track conversions
Persistent
Toggle LinkedInLinkedIn
LinkedIn is a professional networking platform for job seekers, employers, and industry connections.
Name
Description
Duration
bscookie
Used by LinkedIn to track the use of embedded services.
1 year
AnalyticsSyncHistory
Used to store information about the time a sync with the lms_analytics cookie took place for users in the Designated Countries
30 days
bcookie
Used by LinkedIn to track the use of embedded services.
1 year
li_sugr
Used to make a probabilistic match of a user's identity outside the Designated Countries
90 days
lidc
Used by the social networking service, LinkedIn, for tracking the use of embedded services.
1 day
UserMatchHistory
Used by LinkedIn Ads to synchronize and match user IDs across different ad networks and data providers.
30 days
Toggle LinkedIn InsightLinkedIn Insight
LinkedIn Insight is a web analytics service that tracks and reports website traffic.
Service URL: www.linkedin.com (opens in a new window)
Name
Description
Duration
li_sugr
Used to make a probabilistic match of a user's identity.
90 days
lidc
Used for routing and session management.
24 hours
Toggle LiveIntentLiveIntent
LiveIntent provides a platform for email advertising and identity-driven marketing solutions.
Name
Description
Duration
_lc2_fpi_js
Companion cookie to _lc2_fpi used by JavaScript to facilitate cross-domain ad tracking and user identification.
1 year
_lc2_fpi
First-party tracking cookie usually associated with LiveRamp to identify users across devices for targeted advertising.
1 Year
_li_ss
Sets a unique ID for the visitor, that allows third party advertisers to target the visitor with relevant advertisement. This pairing service is provided by third party advertisement hubs, which facilitates real-time bidding for advertisers.
1 month
lidid
Collects data on visitors' behaviour and interaction - This is used to make advertisement on the website more relevant. The cookie also allows the website to detect any referrals from other websites.
2 years
Toggle Cookie PolicyCookie Policy
You can find more information in our Privacy Policy.
Allow AllDecline All
Accept