Content Migration Framework

What to do before, during and after migrating content to a new domain or CMS

Andreea Macoveiciuc

Written on 8th February, 2021 |

4 min read

Share this article

A good old quote says that failing to plan is planning to fail. So if you’re redesigning your website, moving it to a new domain, or switching to a new CMS, make sure you have a clear and well-documented process for migrating your content.

I’ll detail the steps and explain why you need to prepare so many things before moving the content, instead of just starting the copy-paste work.

If you’re already familiar with the process, you can skip the reading and get the checklist here: Content migration framework

The content migration process has three main phases:

  1. Preparing the migration

  2. Execution phase

  3. Post-migration phase

Let’s see what each of these three stages involves.

Preparing the content migration

This first phase, at its turn, can be split into three main steps, as follows.

Step 1: What content will we migrate and why?

  1. Perform a content inventory to get a good feeling of how much content your company has, where it is stored, in what formats, and who owns it.

  2. Perform a content audit to get an idea of how your content is performing, what works, and what doesn’t. Look at the content structure, clarity, and overall quality.

  3. Analyze the content gaps and decide how you want to approach the missing topics. Will they bring enough value, will they align with the business and marketing objectives?

  4. Organize an ideation session with stakeholders & SMEs to gather all the topics that they find relevant and that users might find interesting.

  5. Perform keyword research, based on business value and user intent

  6. Perform competitor research to see what topics they cover and you don’t and what queries they rank for and you don’t. Decide whether those would add value to your business.

  7. Identify taxonomy needs and agree with stakeholders upfront on a shared controlled vocabulary.

  8. Define the scope of the migration project by putting together all the information gathered until now.

  9. Decide what content should be kept & improved, and what content should be retired.

  10. Decide what new content needs to be created from scratch, to cover the gaps.

  11. Do an SEO audit for monitoring rankings before & after the migration, for target keywords.

Step 2: How will the migration be done?

  1. What’s the proposed technical solution? Manual, automated, or semi-automated migration?

  2. How will the domain architecture look like?

  3. If using a headless / decoupled CMS, analyze potential needs for additional templates & components.

  4. If a taxonomy will be created, who will do it and how?

  5. How will the old links be handled?

  6. How will the assets be migrated?

  7. Who will own the project and who will be the backup?

  8. How will the internal and external users be notified once the migration is done?

  9. Backup and fallback scenario.

  10. Workflows for during and after migration.

  11. Based on these, define the project roadmap.

Step 3: Acceptance criteria (when can you move on to the next step)

  1. Agreement on a technical solution in place.

  2. Domain architecture in place.

  3. Strategic intent clear for the content in scope.

  4. Missing templates and components in place. If postponed, the clear deadline for implementation.

  5. Backup is done for both content and assets.

  6. Taxonomy in place. If postponed, a clear deadline for implementation.

  7. Tracking plan in place.

  8. Workflows in place.

  9. The migration can be performed.

Executing the content migration

Step 1: Create the domain architecture & migrate the content

  1. Disable the crawlability of the website during migration, you don’t want SE to index anything before it’s ready.

  2. Verify the backup for content & assets.

  3. Perform a test migration & check that the redirects work properly.

  4. Create the structure of the website, as per the agreed architecture.

  5. Migrate the content pages as per the agreed technical solution.

  6. Migrate the assets.

  7. Implement the taxonomy.

  8. Implement tracking.

  9. If in scope, start developing the missing templates & components.

Step 2: Optimize the content & implement redirects

  1. As per the content audit, optimize the pages that require optimization. You can use this approach: Content optimization framework.

  2. Tag the pages according to the taxonomy.

  3. Make sure the metadata is in place.

  4. Make sure that forms & subscribe boxes are working properly.

  5. Make sure tracking works properly.

  6. Enable the crawlability of the website.

  7. Perform manual checks / automated QA.

  8. Implement redirects.

  9. Retire the old website or implement canonicals. If you opt for canonicals, have a clear deadline for completely retiring the old content.

  10. When all is done, start preparing the internal and external communication.

Step 3: Acceptance criteria (when can you move on to the next step)

  1. Pages that needed to be created from scratch aren’t visible in navigation / internal links. Since they’ll be created after the migration, you don’t want those pages (placeholders) to be visible yet. The metadata can be in place though.

  2. Manual checks & automated tests show no blocking issues.

  3. Metadata & tags are in place.

  4. Forms & subscription boxes work properly.

  5. Tracking works properly.

  6. Redirects work properly.

  7. When these steps are done, you can send internal and external communication materials.

Post-migration actions

Step 1: Create the missing content

  1. As per the content audit, create the missing content.

  2. Tag the pages accordingly.

  3. Make sure metadata is in place.

  4. Make sure that forms & subscribe boxes are working properly.

  5. Make sure tracking works properly.

  6. Enable the pages to be indexed.

  7. Perform manual & automated checks.

  8. Publish the content & promote it in the target channels.

  9. When all is done, start preparing the internal and external communication.

Step 2: Tracking the content and analyzing the performance

  1. Send internal and external communication for the newly created content. This is an ongoing activity.

  2. As per the SEO report, monitor rankings for the optimized & new pages.

  3. Perform on-going optimization as needed.

  4. When the migration process is done, you can start planning your e-mail strategy and marketing automation flows.

I hope this gives you a good overview of how a proper content migration is done. It may look like a lot of work, but I like doing things properly rather than quickly.

If you need help preparing a content migration project, get in touch with our team.

Return to all articles

Learn from our experience

Receive actionable content strategy & marketing articles directly in your inbox by subscribing to our newsletter