Wp2hugo screenshot

Wp2hugo

Author Avatar Theme by Ashishb
Updated: 22 May 2025
257 Stars

The best WordPress to static site migrator

Overview:

The WordPress to Hugo Static Site Migrator is a tool designed to facilitate the migration of a WordPress website to a Hugo-based site. This tool handles various complexities and edge cases that may arise during the migration process, making it an efficient solution for users looking to switch to a static site generator like Hugo.

Features:

  • Migrate Various Post Types: The tool can efficiently migrate posts, pages, tags, categories, and even custom post types like FAQs and Portfolios from WordPress to Hugo.
  • Preserve Permalinks: It ensures that all URLs, including media URLs, are migrated correctly to maintain link structures.
  • Support for Content Elements: The tool can migrate content elements like excerpts, “Show more…” sections, tables of content, embedded media (YouTube, Google Maps, GitHub gists), and WordPress shortcodes to their Hugo equivalents.

Installation:

To install the WordPress to Hugo Static Site Migrator, follow these steps:

  1. Download the wp2hugo tool from the releases section.
  2. Export your WordPress website using the Tools -> Export option in the admin dashboard to generate a wordpress-export.xml file.
  3. Run the migration tool using the command: $ wp2hugo --source wordpress-export.xml --download-media.

Summary:

The WordPress to Hugo Static Site Migrator is a versatile tool that streamlines the migration process from WordPress to Hugo-based websites. With features like preserving permalinks, migrating various content elements, and supporting different post types, this tool ensures a smooth transition while handling complex scenarios efficiently. Whether for personal use or commercial projects (with proper licensing), this migrator can be a valuable asset for users looking to switch to a static site setup.