An HTML to WordPress migration checklist should protect five things: your content, your URLs, your design, your forms, and your ability to roll back if anything behaves badly at launch. The real job is not just “moving pages into WordPress.” It is rebuilding the site so it is editable without breaking what already works.
That distinction matters. A static HTML site can look simple from the outside, but the risk usually hides in small places: a hard-coded contact form, an old brochure PDF, a URL that still earns traffic, a tracking script nobody remembers adding, or a mobile layout that only works because of one forgotten CSS file.
Use this checklist before you migrate, while you build, and before you switch visitors to the new WordPress version.
Quick checklist: HTML to WordPress migration
| Stage | What to check | Why it matters |
|---|---|---|
| Inventory | Crawl every live URL, image, PDF, script, and form | Prevents missing pages and broken assets |
| Content mapping | Decide which pages become WordPress pages, posts, blocks, or templates | Keeps the site editable after migration |
| Design rebuild | Recreate layouts as maintainable WordPress templates and Gutenberg blocks | Avoids trapping the new site inside pasted HTML |
| SEO preservation | Map old URLs to new URLs and prepare permanent redirects | Protects search visibility and bookmarked links |
| Staging | Build and test in an isolated WordPress environment | Prevents disruption to the live HTML site |
| Forms | Send real test submissions and confirm mailbox delivery | Prevents silent lead loss |
| Cutover | Backup, switch traffic, verify, and keep rollback ready | Keeps launch controlled instead of risky |
1. Crawl the old HTML site before touching WordPress
Start with a complete inventory. Not a guess. Not just the pages in the top navigation.
For a small static site, that means checking every .html page, image folder, downloadable file, canonical URL, stylesheet, JavaScript file, and form endpoint. For an older business site, also look for forgotten landing pages that are not linked in the menu but still receive traffic from Google or old email campaigns.
At minimum, capture:
- Current page URLs, including trailing-slash and
.htmlvariations. - Page titles and meta descriptions.
- H1 headings.
- Important images and alt text.
- PDFs, brochures, menus, catalogues, or forms.
- Analytics, pixels, chat widgets, cookie scripts, and schema markup.
- Contact forms and the mailbox they should deliver to.
Our recommendation: treat the crawl as the migration control sheet. If a URL is not in the sheet, it is easy to forget. If a form is not in the sheet, it is easy to launch with a form that looks fine but sends nowhere.
2. Decide what should become editable in WordPress
A common mistake is to paste old HTML into WordPress and call the migration finished. It works at first glance. Then the business owner tries to edit a headline, replace a service section, or add a new location page — and the “new WordPress site” still behaves like a hard-coded static site.
Before rebuilding, decide how each part should live in WordPress:
| Old HTML element | Better WordPress destination |
|---|---|
| Main service pages | WordPress pages with reusable block sections |
| Blog/news pages | Posts with categories and archive templates |
| Repeated headers, footers, CTAs | Theme templates or reusable blocks |
| Staff cards, services, testimonials | Structured blocks or custom fields if needed |
| One-off legacy code snippets | Rebuilt only if they still serve a business purpose |
The goal is not to preserve old code. The goal is to preserve the useful front-end experience while making the back end easier to manage.
3. Rebuild the design, do not blindly import it
There are tools and plugins that can import HTML into WordPress. They can help with content extraction, but they rarely solve the real migration problem by themselves.
A safe static HTML to WordPress migration usually needs a design rebuild. That does not mean changing the brand. It means recreating the layout inside a WordPress theme so the site keeps its familiar appearance while gaining proper editing, navigation, templates, responsive behavior, and update paths.
Check these design details carefully:
- Desktop, tablet, and mobile layout spacing.
- Header and navigation behavior.
- Buttons, hover states, and form states.
- Font loading and fallback fonts.
- Image cropping on mobile screens.
- Footer links and legal pages.
- Existing visual proof, such as portfolio images or case studies.
For business sites, we prefer visual parity where it matters and improvement where the old site is obviously weak. A migration is a good moment to fix brittle mobile spacing or unreadable CTAs, but it should not surprise returning customers with a totally unrelated design unless that was the plan.
4. Map old URLs to new WordPress URLs
This is the part people skip until traffic drops.
If your old site has /services.html and the new WordPress page is /services/, you need a permanent redirect. If a PDF moved, redirect it. If a page is intentionally removed, point it to the closest useful replacement instead of dumping every old URL onto the home page.
Google’s own documentation on redirects and Google Search explains that redirects tell visitors and search engines that a page has a new location. For larger URL changes, Google also recommends using permanent server-side redirects where possible in its site moves with URL changes guidance.
A practical redirect map includes:
| Old URL | New URL | Redirect type | Notes |
|---|---|---|---|
/index.html |
/ |
301 or 308 | Home page |
/services.html |
/services/ |
301 or 308 | Service page |
/contact.html |
/contact/ |
301 or 308 | Test form after launch |
/brochure.pdf |
/brochure/ or new PDF URL |
301 or 308 | Avoid broken download links |
Do not rely on “WordPress will probably handle it.” WordPress handles many URL structures well, but it cannot magically know every old static file path unless you map it.
5. Build in staging, not over the live HTML site
The safest migration pattern is simple: leave the current HTML site running while WordPress is built in an isolated staging environment.
That staging site should be blocked from indexing, protected from casual visitors, and tested like the real site. This is where you confirm the theme, imported content, menus, forms, redirects, performance, and multilingual behavior if the site has more than one language.
This is also where rollback planning starts. Before launch, you should know exactly how to put the old site back if something unexpected happens. That can mean a server snapshot, a file backup, DNS rollback notes, or a preserved copy of the original static hosting setup.
Our view is blunt: if there is no staging site and no rollback path, the migration is not ready.
6. Test forms with real mailbox delivery
A contact form is not working just because the green success message appears.
Test the complete path:
- Submit the form from the staging site.
- Confirm the email arrives in the correct mailbox.
- Check the sender, reply-to, subject, and message body.
- Confirm spam filtering does not hide it.
- Repeat after launch from the public domain.
This is especially important when moving from static HTML forms, old PHP mail handlers, or third-party form embeds. The form might look identical after migration, but the delivery route may have changed completely.
For lead-generation sites, this is a business-critical check. A silent form failure can cost more than the whole migration.
7. Verify before and after cutover
Before switching traffic, run a final acceptance pass. After switching traffic, run it again on the live domain.
Use this pre-launch list:
- Key pages return HTTP 200.
- Old URLs redirect to the right new URLs.
- No staging URLs appear in the live HTML.
- Menus and footer links work.
- Forms deliver to the correct mailbox.
- Mobile layouts are readable and usable.
- Analytics and conversion tracking are present.
- The old site backup and rollback path are documented.
Then repeat the checks after launch. Verification is not a formality; it is how you catch the difference between “the site is online” and “the migration is actually safe.”
8. When should you hire an HTML to WordPress migration service?
DIY can make sense when the site is tiny, non-commercial, and easy to recreate. A five-page brochure site with no forms, no rankings, and no unusual layout is a reasonable learning project.
Hire help when the site has business value or migration risk:
- Existing Google traffic you do not want to lose.
- Contact forms or quote forms that generate leads.
- Multiple languages or regional pages.
- A custom design that must stay visually consistent.
- Old
.htmlURLs with backlinks or bookmarks. - Analytics, tracking, scripts, or embedded tools.
- A need for staging, backup, rollback, and launch verification.
The deciding question is not “Can someone copy the pages?” The better question is: “Can we move this site without losing leads, links, editability, or trust?”
Our recommended migration flow
For business websites, we use a controlled safe-passage process:
- Inventory the current site and migration risks.
- Build WordPress in a private staging environment.
- Recreate the design as editable WordPress pages and templates.
- Map old URLs and prepare redirects.
- Test forms, mobile views, legal pages, and tracking.
- Backup the old site and document rollback.
- Cut over only after verification is ready.
- Re-check the live site after launch.
That process is slower than pretending migration is a copy-paste task, but it is much safer. The win is not merely “now it is WordPress.” The win is a site that looks right, edits cleanly, preserves important URLs, and can be launched without business interruption.
If you want that kind of migration, start with our HTML to WordPress migration service guide or review our acceptance checklist before you begin.
Planning a safer HTML to WordPress migration? Review our acceptance checklist or see what a proper HTML to WordPress migration service should include.