Convert from Textpattern to WordPress

Textpattern is one of the older PHP/MySQL content management systems, with a loyal community of users who chose it years ago for its simplicity and focus. The platform has aged gracefully but quietly; development has continued, but the world around Textpattern has moved on. WordPress now powers more than 40% of the web, while Textpattern’s user base has stayed small.

For anyone who built a site on Textpattern recently or many years ago and now wants to migrate, the conclusion is the same: it’s time to bring the content to a platform with a larger ecosystem, easier customization, and broader long-term support.

If you’ve decided to convert from Textpattern to WordPress, you’re not abandoning a bad CMS. You’re moving from a focused, simple tool to a flexible, complex one with significantly more options for the future.

Why WordPress is the right move after Textpattern

Textpattern and WordPress share a similar architecture (PHP plus MySQL database), so the migration is straightforward in concept. The reason most users decide to move comes down to ecosystem and momentum. Textpattern has a small, dedicated community.

WordPress has the largest CMS community in the world. That single difference shapes everything: theme options, plugin availability, themes for customization, comments management, and the ease of adding new functionality years down the road.

A WordPress site offers nearly everything Textpattern does (clean post content management, simple settings, easy categorization, comments) plus a vastly larger ecosystem on top.

A few reasons users decide to convert from Textpattern to WordPress:

  • A vastly larger ecosystem – Thousands of WordPress themes and tens of thousands of plugins, versus Textpattern’s small selection
  • Easier customization – WordPress themes and CSS customization are easier to find, easier to modify, and easier to maintain
  • Active development and security – WordPress has a massive team of developers behind it; Textpattern’s development pace is much slower
  • Bigger pool of WordPress developers – Finding help is dramatically easier on WordPress than on Textpattern
  • More functionality out of the box – Comments, tags, categories, custom post types, and media management all work better in WordPress
  • A cleaner, more flexible admin – WordPress’s admin is more capable and easier to navigate than Textpattern’s
  • Better SEO – Yoast SEO and Rank Math give WordPress a stronger SEO than Textpattern’s built-in features
  • An easier path forward – Years from now, your WordPress site will still be easy to maintain; Textpattern’s future is less certain

If your Textpattern site has hit a wall on customization, plugins, or community support, the move to WordPress is the simple, sensible call.

WordPress vs. Textpattern comparison

Here’s how the two platforms stack up once you start weighing whether to keep Textpattern or migrate to WordPress:

CategoryTextpatternWordPress
ArchitecturePHP + MySQL databasePHP + MySQL database (same fundamentals)
Community sizeSmall, dedicated communityThe largest CMS community on the web
Plugin ecosystemLimited Textpattern pluginsTens of thousands of WordPress plugins
ThemesSmall theme selectionThousands of WordPress themes, free and premium
CustomizationManual CSS work and theme editingEasier customization via themes, builders, and plugins
CommentsBuilt-in commentsBuilt-in comments plus extensive plugin options (Disqus, Akismet, etc.)
Content editingTextile or HTML in the adminGutenberg block editor, with Textile and HTML support via plugins
DocumentationLimited tutorials and forumsMassive documentation, tutorials, and an active community
Best fitExisting Textpattern sites are already running cleanlySites of any size needing flexibility, themes, and a real ecosystem

Ready to move? Talk to our migration team, and we’ll map out your Textpattern to WordPress migration from database export to launch.

How do you convert your website from Textpattern to WordPress?

The good news about a Textpattern to WordPress migration is that both platforms run on PHP and MySQL, so the underlying data model is similar. The challenge is that Textpattern’s built-in WordPress importer (and WordPress’s built-in Textpattern importer) has been broken for years and isn’t reliable for modern versions. The practical path uses RSS feeds, custom scripts, or direct database queries.

Here’s the high-level path:

  1. Audit your Textpattern site – Inventory all your posts, pages, categories, tags, comments, images, and any custom Textpattern functionality
  2. Back up your Textpattern site – Full backup of the Textpattern site, including the MySQL database and the images/ and files/ folders. Don’t migrate without a backup; if anything goes wrong, the backup is your safety net
  3. Set up the new WordPress site – Install WordPress on your hosting (PHP and MySQL on the server), pick a WordPress theme, configure permalinks to match Textpattern’s URL structure as closely as possible
  4. Choose your migration approach – Three viable options: RSS feed import via WordPress’s generic RSS importer (simplest but limited), drewm/textpattern-to-wordpress GitHub tool that generates a WordPress extended RSS export file from the Textpattern database (recommended), or a custom script that reads the Textpattern database and writes to WordPress via the REST API
  5. Generate a WordPress-format export from Textpattern – Use the drewm/textpattern-to-wordpress PHP script, place it in the root of your Textpattern site, and run it in your browser. The script outputs a WordPress-compatible XML file
  6. Import the XML into WordPress – From your WordPress dashboard, head to Tools → Import → WordPress, install the WordPress Importer, and upload the XML file generated from Textpattern
  7. Map authors – During the import process, map Textpattern authors to existing WordPress users or assign all imported content to a single user
  8. Migrate images and files – Manually transfer files from Textpattern’s images/ and files/ folders to WordPress’s /wp-content/uploads/ directory, then rewrite URLs across imported post content
  9. Recreate the design – Textpattern themes don’t transfer to WordPress (different templating systems), so the original theme needs to be rebuilt in a WordPress theme or replaced with a new one. This is a chance to focus on a clean, modern design
  10. Reconfigure settings – Site title, tagline, timezone, comment policy, and other WordPress settings need to be set to match your Textpattern site
  11. Fix any broken HTML or formatting – Textpattern uses Textile markup; if posts were stored in Textile, the import may need cleanup of HTML formatting
  12. Set up SEO and redirects – Install Yoast SEO; migrate meta titles and descriptions; build a complete 301 redirect map from Textpattern URLs to WordPress URLs
  13. Test on staging – Validate every imported post, every image, every link before launching
  14. Launch – Switch DNS to point to the new WordPress site; monitor for issues in the first few weeks

The complete process for a small Textpattern site can run from a couple of hours to a couple of days. Larger sites with hundreds of posts, complex categorization, and significant image folders typically take longer.

The Textpattern to WordPress migration process

Most articles online about Textpattern to WordPress migration focus on the basic content move and skip the details. For a small Textpattern blog with a couple of dozen posts, the basic process works. For a Textpattern site that’s been running for years with thousands of posts, customized themes, and serious content, the migration takes more careful work.

Here’s what actually happens during a serious Textpattern migration.

What can be migrated reliably:

  • Posts and post content (titles, body content, dates, slugs)
  • Authors (mapped to WordPress users)
  • Categories and tags
  • Comments (if you’re using Textpattern’s native comments)
  • Basic post metadata (publication date, status, slug)
  • Images and files (via manual upload to WordPress media library)
  • Permalink structure (with proper configuration)

What needs manual work:

  • Themes (Textpattern’s PHP-based themes don’t translate to WordPress; rebuild as a WordPress theme)
  • Custom plugins or Textpattern-specific functionality (replace with WordPress plugins)
  • Custom Textile formatting (convert to HTML or Markdown for WordPress)
  • Custom URL structures (recreate with WordPress permalinks)
  • Multi-author workflows (configure WordPress user roles to match)

A complete Textpattern to WordPress migration project covers:

  • Discovery and content audit – Inventory all your posts, categories, tags, authors, images, and any custom Textpattern features
  • Database backup – Full backup of the Textpattern MySQL database and the file/image folders
  • WordPress setup – Install WordPress, configure permalinks to match Textpattern’s URL pattern, install Yoast SEO, and any other essential plugins
  • Generate the WordPress-format export – Use drewm/textpattern-to-wordpress to convert your Textpattern database into a WordPress XML file
  • Import content – Run the WordPress Importer with the generated XML; map authors; verify the import completed cleanly
  • Image and file migration – Move every image and file from Textpattern’s folders to the WordPress media library
  • Theme rebuild – Build a new WordPress theme matching your original Textpattern design, or pick a clean WordPress theme that fits your site’s focus and style
  • Comments migration – If you used Textpattern’s native comments, they come over with the import; you may want to test how they display in WordPress
  • SEO transfer – Move meta titles, descriptions, and any structured data to Yoast SEO
  • Redirect map – Build 301 redirects from every Textpattern URL to its new WordPress URL to preserve search rankings
  • Performance and security – Set up caching, security plugins, and backups for the new WordPress site
  • Testing on staging – Validate every page, every link, every comment, every form before going live
  • Launch – Switch DNS and monitor for the first 30 days

For an established Textpattern site that’s been running for years, the migration can be a few hours of focused work for a developer or a couple of weeks of careful manual work for someone less experienced. Working with a developer who has worked with both Textpattern and WordPress significantly shortens the process.

You’ve completed your migration. What’s next?

Migration is the starting line. Once your Textpattern content is fully imported into your new WordPress site, work through this post-launch checklist:

  • Verify every imported post – Walk through every post on the new WordPress site side-by-side with the original Textpattern site to confirm content, images, and formatting transferred cleanly
  • Check the WordPress database – Confirm posts, categories, tags, and authors imported correctly
  • Validate all images – Confirm images load from /wp-content/uploads/ and not from the old Textpattern image folder
  • Test comments – Confirm imported comments display correctly and that new comments work on the live site
  • Confirm permalinks – Verify URL structure matches what you configured, and that every old Textpattern URL redirects to its new WordPress URL
  • Submit your sitemap – Push the updated sitemap to Google Search Console
  • Monitor traffic and search rankings – Track the first 30 days closely to catch any SEO issues from the cutover
  • Fix any broken HTML or formatting – Spot-check older imported posts for any leftover Textile artifacts or broken formatting
  • Take time to customize – With WordPress, you have a lot of options to customize the design, add plugins, and improve the site beyond what was available on Textpattern
  • Polish the design – A new theme or WordPress design refresh is the chance to upgrade visual elements

Lock in managed hosting, security hardening, and ongoing WordPress maintenance so the new site stays fast and secure.

Hire Freshy to manage your WordPress migration

Textpattern to WordPress migration is straightforward when handled by someone with experience in both platforms, but the broken built-in importers and the manual image work catch most DIY attempts off guard. Freshy handles the full migration for you, from database export through theme rebuild.

A typical engagement covers:

  • Discovery and content audit – Full review of your Textpattern site, content, authors, and design
  • Database backup and content extraction – Full backup of the Textpattern database, then a WordPress-format XML export generated via a custom script
  • WordPress setup and theme build – New WordPress site on managed hosting, custom theme matching your Textpattern design, or a clean new look
  • Content import – Posts, categories, tags, comments, and authors imported into WordPress with proper field mapping
  • Image and file migration – Every image and file moved from Textpattern’s folders to the WordPress media library
  • Complete redirect map – Every Textpattern URL pointed to its new WordPress URL
  • SEO setup – Yoast SEO, schema, sitemap submission, search engine optimization
  • Mobile-first responsive build – Optimized for every device
  • Managed hosting, SSL, and security – Ready for traffic from day one
  • Training and ongoing support – So you can manage WordPress comfortably without the learning curve

If you’ve decided to convert from Textpattern to WordPress and want it done right, get in touch with our team to scope your migration.

Frequently Asked Questions

How long does a Textpattern to WordPress migration take?

A simple Textpattern site with a couple of dozen posts can move in a few hours of focused work for a developer or a couple of days for someone less experienced. Larger Textpattern sites with hundreds of posts, custom themes, and significant content can run 2 to 6 weeks for a complete, polished migration.

Will I lose SEO when I convert from Textpattern to WordPress?

Not if the migration is handled properly. Building a complete redirect map from every Textpattern URL to its new WordPress URL is the most important step. Done well, most sites stabilize within 4 to 8 weeks and often see search rankings improve thanks to stronger WordPress SEO tools.

Can I keep my Textpattern site online during the migration?

Yes. Most migrations build the new WordPress site on a staging environment, away from your live Textpattern site. The final cutover happens in a single planned window once everything has been tested.

Does WordPress have a working Textpattern importer?

The built-in Textpattern importer in WordPress has been broken for years and isn’t reliable for modern versions of either platform. The practical path is to use the drewm/textpattern-to-wordpress PHP script to generate a WordPress-format XML file from your Textpattern database, then import that XML into WordPress.

How do I move my Textpattern images and files to WordPress?

Manually. Download files from Textpattern’s images/ and files/ folders, then upload them to WordPress’s /wp-content/uploads/ directory. After upload, rewrite URLs across your imported post content to point to the new locations.

What about my Textpattern theme?

Textpattern themes don’t transfer to WordPress because the two systems use different templating engines. The original theme needs to be rebuilt as a WordPress theme, or you can pick a clean new WordPress theme that fits your focus. Either way, the design work needs to be redone.

Will my Textpattern comments come over?

Yes, if you used Textpattern’s native comments. They get imported alongside the posts in the WordPress XML import. After import, the comments display through WordPress’s native comment system, which you can further extend with plugins like Akismet for spam filtering.

Are there any issues with Textile formatting?

Possibly. Textpattern uses Textile markup, and posts stored as raw Textile may need conversion to HTML during the import. The drewm/textpattern-to-wordpress script can be configured to export posts as HTML (the default) or as raw Textile if you want to convert them later in WordPress.

Can I keep using Textile in WordPress?

Yes, with a plugin. WordPress supports Textile through the Textile for WordPress plugin or similar tools. Most users find Gutenberg’s block editor more convenient than Textile, but the option is there if you want to keep your writing workflow simple.

Do I need a developer to migrate from Textpattern to WordPress?

For a small Textpattern site with limited customization, a confident user can handle the migration with the drewm/textpattern-to-wordpress script and a couple of hours of focused work. For larger sites or sites with custom themes and complex content, working with a developer makes the process much easier and produces a cleaner result.

Ready to convert from Textpattern to WordPress?

Textpattern served its place well for years, but the world has moved to WordPress. For most Textpattern users today, the move is the natural simplification onto a platform with a larger community, more themes and plugins, and an easier path forward for whatever you want to build next.

We’ve helped users complete the conversion from Textpattern to WordPress journey without losing post content, images, or search rankings. If you’ve found yourself thinking it’s time to make the switch, contact us to scope your migration.