Skip to content

Blacklane WordPress to Contentful Migration

Moved Blacklane’s older Contentful pages and its WordPress blog onto the Next.js site.

Line-art illustration of WordPress article content moving into structured Contentful modules

The brief

Articles were still authored in WordPress, and a set of older Contentful types still sat beside the page system: city landing pages, SEO pages, and chauffeur stories. Anyone publishing a city page, an article, or a press release was working in more than one place.

From August 2024 to January 2025 I put that content on the Next.js and Contentful platform. The job was to retire the old types, move the entries, and replace the WordPress blog with pages on the same system as the rest of the site.

The work

The key piece was a migration framework. It let me change the Contentful content model, and the content itself, in a reliable way: move data from one field to another, create content types, and run the steps that took the old pages across. That framework did the migration. City pages then rendered through the shared page route.

The migration tooling:

  • Scripts to archive entries, migrate city pages and SEO pages, and migrate press releases.
  • Scripts to delete a content type, and the references left behind, once nothing still pointed at it.
  • Press releases gained the new fields. The body can contain embedded entries, and the author is chosen in Contentful instead of being fixed in the template.

Replacing the WordPress blog:

  • WordPress had already exported the articles, and that export is what I brought into Contentful. The images came with them, into Contentful’s own storage.
  • Article pages render the migrated posts, including the HTML from WordPress, with those images served from Contentful.
  • An article has breadcrumbs, and a table of contents built from the headings in the body.
  • The index lists posts from Contentful, with pagination. Each category has its own route and its own paged list.

What Blacklane could do afterwards

City pages, SEO pages, press, and the blog were on one Contentful and Next.js platform. A new article no longer had to be written in WordPress and then reconciled with the rest of the site.

Technologies

  • WordPress
  • Contentful
  • Next.js