How to Migrate From the Thesis Theme Safely, Step by Step (2026)

Switching away from Thesis is mostly safe for your content. The risk is in the extras Thesis stored on its own, such as SEO fields, boxes, custom code and post images. This guide covers each one.

Moving off Thesis? See what Thrive Suite includes.

Get Thrive Suite

Before You Start: What Actually Changes

Switching themes in WordPress is less risky than it sounds. Your posts, pages, images, comments, categories, tags and users live in the database, not in the theme, so they stay where they are.

What doesn't move by itself is everything Thesis managed on its own:

Item What Happens When You Switch What to Do
Posts, pages, media, comments Stay in place Nothing
Permalinks (URLs) Stay the same Don't change the permalink setting
Thesis SEO titles and descriptions Saved, but ignored by other themes Import into an SEO plugin
Analytics and verification codes in Site Tools Stop loading Re-add through a plugin or your new theme
Custom functions in skin files Stop running Move to a snippets plugin or child theme
Boxes (opt-ins, related posts, social) Disappear Rebuild with theme features or plugins
Skin layouts, header, footer Replaced by the new theme Rebuild
Post images set through Thesis fields May not display Convert to featured images
Menus and widgets Usually kept, may need reassigning Reassign to new locations

The goal of a safe migration is to handle every row in the right column before visitors and search engines see the new design.

Step 1: Back Up Everything

Rack of servers in a server room

Take a full backup of files and the database, and confirm you can restore it. Most hosts offer one-click backups; a backup plugin works too. Also download a copy of your /wp-content/thesis/ folder, which holds your skins, boxes and custom files, so you can refer to your old code later.

Step 2: Set Up a Staging Site

Do the switch on a staging copy, not the live site. Many hosts include one-click staging. Work there until the new design is finished and tested, then push it live. This keeps your live site untouched while you rebuild.

Step 3: Audit Your Thesis Setup

Before changing anything, write down what your Thesis site does. Check these places in the Thesis admin and skin files:

  1. Site Tools: Google Analytics, Google Tag Manager, Search Console verification, other tracking or verification codes, custom 404 page settings.
  2. SEO settings: home page title and description, and whether posts use custom SEO titles and descriptions.
  3. Skin Editor templates: which templates exist (home, single, page, archive, custom templates) and which boxes each uses.
  4. Boxes: every add-on box installed, such as opt-in forms, sliders, social buttons, related posts, ad slots or breadcrumbs.
  5. Custom code: custom.php and any functions in your skin folder, plus custom CSS.
  6. Post images and thumbnails: whether posts use WordPress featured images or Thesis's own image fields.

This list becomes your migration checklist.

Step 4: Move Your SEO Titles and Descriptions

Magnifying glass beside a laptop on a table

This is the step that protects rankings. Thesis stores per-post SEO titles and meta descriptions as post meta, which other themes ignore.

Options for moving them:

  • Use your SEO plugin's import tool. Several SEO plugins include importers for data from other themes and plugins. Check whether yours lists Thesis.
  • Use a dedicated transfer plugin. Tools such as StudioPress's SEO Data Transporter were built to move SEO fields between themes; check that any plugin you use still works with current WordPress.
  • Export and import manually. For a small site, export the post meta to a spreadsheet and paste titles and descriptions into your SEO plugin.

After importing, spot-check a dozen posts to confirm titles and descriptions match the old site.

Step 5: Re-Add Tracking and Verification Codes

Codes saved in Thesis Site Tools stop loading when Thesis is no longer active. Re-add:

  • Google Analytics or Tag Manager
  • Search Console and other verification tags
  • Ad network or affiliate scripts placed in the head or footer

A header-and-footer code plugin or your new theme's hook settings both work. GeneratePress's Elements, for example, can insert code into specific theme hooks.

Step 6: Move Custom Functions

Copy anything still needed from your skin's custom.php into a code snippets plugin or a child theme of your new theme. Remove Thesis-specific hooks and functions, which won't exist anymore. Test each function on staging; old code written for PHP versions from the Thesis 2.x era may need updating.

Step 7: Fix Post Images

Some Thesis setups used their own fields for post images and thumbnails rather than WordPress's featured image. If posts on staging show missing images, convert those fields to featured images. Plugins exist that set featured images from custom fields or the first image in a post; test one on a few posts first.

Step 8: Install and Set Up the New Theme

Desktop computer, laptop and tablet on a desk

Install your new theme on staging and activate it. Then rebuild in this order:

  1. Global styles: fonts, colors, container width
  2. Header and footer, including logo and menus
  3. Single post template, since most traffic lands on posts
  4. Archive and category templates
  5. Home page and key landing pages
  6. Opt-in forms, related posts and other features that boxes used to provide

Which theme? It depends on why you used Thesis. For marketing and list-building sites, Thrive Suite combines a theme builder with opt-ins and landing pages. For lean content sites, GeneratePress is the natural choice. For visual design, Divi or Elementor. The Thesis alternatives guide compares them.

Step 9: Rebuild What Boxes Used to Do

List each box from your audit and decide how to replace it:

Old Thesis Box Typical Replacement
Opt-in or email box Thrive Leads, Divi or Elementor forms, or your email provider's form
Related posts Theme feature or a related posts plugin
Social buttons or follow icons Theme feature or a social sharing plugin
Breadcrumbs Your SEO plugin's breadcrumbs or the theme's
Content slider Block-based layout or builder module (sliders are often worth dropping)
Ad slots Theme hooks or an ad management plugin

Step 10: Test Before Going Live

On staging, check:

  • Every template: home, post, page, category, tag, search, 404
  • Mobile layouts on a real phone
  • SEO titles and descriptions on a sample of posts (view the page source)
  • Tracking codes with your analytics tool's real-time view
  • Forms and opt-ins: submit a test entry
  • Internal links and images: use a broken link checker or a crawl
  • Speed: run key pages through PageSpeed Insights

Step 11: Go Live and Monitor

Push staging to live, or switch the theme on the live site during a quiet period if you rebuilt with a page builder that saves content separately. Then:

  1. Clear all caches (plugin, server and CDN).
  2. Crawl the live site for broken links and missing images.
  3. Check Google Search Console over the next few weeks for coverage errors and ranking changes.
  4. Keep the Thesis folder backup until you are confident nothing is missing.

If rankings dip after the switch, compare the old and new versions of the affected pages first: titles, headings, internal links and page speed are the usual suspects, and most issues can be fixed within days.

Rule of thumb: change the theme, not the URLs or content, in the same move. Keeping URLs, titles and content stable is what keeps rankings stable.

Quick Pre-Migration Checklist

Hand checking off items on a to-do list
  • [ ] Full backup of files and database, tested
  • [ ] Copy of /wp-content/thesis/ saved
  • [ ] Staging site created
  • [ ] List of Site Tools codes (analytics, verification, scripts)
  • [ ] SEO title and description import method chosen
  • [ ] List of boxes and what replaces each one
  • [ ] Custom functions reviewed and moved to snippets
  • [ ] Post image fields checked
  • [ ] New theme chosen and licensed
  • [ ] Test plan for every template type

Common Thesis Migration Problems and Fixes

Problem After Switching Likely Cause Fix
Titles in search results changed Thesis SEO titles not imported Import Thesis title and description fields into your SEO plugin
Analytics shows no visits Tracking code lived in Thesis Site Tools Re-add the code through a plugin or theme hook
Posts show no images on archive pages Thesis post image fields not converted Set featured images from the old fields or first post image
White screen or PHP errors Leftover Thesis functions in custom code Remove Thesis-specific hooks from moved snippets
Opt-in forms missing Forms were Thesis boxes Rebuild forms with your new theme, Thrive Leads or your email provider
Layout looks broken on some pages Pages relied on Thesis custom templates Recreate templates in the new theme and reassign pages
Search Console verification lost Meta tag lived in Thesis Site Tools Re-add the verification tag or use DNS verification

A Realistic Migration Timeline

Site Size Typical Effort Notes
Small blog (under 100 posts, few boxes) 1–2 days Mostly design rebuild and SEO import
Medium site (hundreds of posts, custom templates) 1–2 weeks Templates, boxes and custom code take most of the time
Large or heavily customized site Several weeks Plan in phases and test each template carefully

These ranges are planning estimates, not guarantees. Sites with heavy custom code take longer, and a developer familiar with Thesis can shorten the audit and code steps.

For the general process on any WordPress site, including staging and SEO checks, see our guide to changing your WordPress theme without losing content.

Choosing Where to Move

Former Thesis sites usually fall into one of three groups:

  • Marketing blogs that grew lists and sold offers fit Thrive Suite, which bundles Thrive Theme Builder with Thrive Leads, Thrive Architect and Thrive Optimize for up to five sites. You can see Thrive Suite's plans or browse setup guides at help.thrivethemes.com.
  • Content and affiliate sites that valued lean code fit GeneratePress; see the GeneratePress review.
  • Design-led business sites fit Divi or Elementor; see Divi vs Elementor.

If you'd rather stay inside Thesis, DIYthemes' FOCUS skin is the maintained option; see the Thesis theme today. And if you want to understand what you are moving away from, the Thesis skins guide explains how skins, boxes and site tools fit together.

Frequently Asked Questions

Will Switching From Thesis Hurt My Rankings?

Not if you keep URLs the same, carry over SEO titles and descriptions and avoid breaking internal links. Rankings usually dip only when titles, URLs or content change at the same time as the theme.

How Long Does a Thesis Migration Take?

A small blog can move in a day or two. A larger site with custom boxes, many templates and custom functions can take one to several weeks, mostly for rebuilding layouts and testing.

Where Does Thesis Store SEO Titles and Descriptions?

Thesis stores per-post SEO titles and descriptions as post meta in the WordPress database. They are not used by other themes automatically, so they need to be imported into an SEO plugin before or during the switch.

What Happens to My Thesis Boxes After Switching?

Boxes only work inside Thesis. After switching, anything a box displayed, such as opt-in forms, related posts or social buttons, must be rebuilt with your new theme's features or a plugin.

Do I Need a Developer to Leave Thesis?

Not for a simple site. If your skin relies on custom PHP functions, custom boxes or complex templates, a developer can save time by moving that code into a snippets plugin or child theme.

Moving Off Thesis? See What Thrive Suite Includes

Check the current plans, site limits and refund terms on the official Thrive Suite website.

Get Thrive Suite