---
title: "Using the 1-click migration tool for a legacy site"
updated: 2026-01-23
---

# Using the 1-click migration tool for a legacy site

> **Disclaimer**
>
> These instructions apply to the legacy Website Builder, which is only available to publications created before July 15, 2025. The legacy Website Builder is no longer being updated. Please migrate your site to the new Website Builder for the best use of beehiiv.

Publications that originally built their website using the legacy Website Builder can use the 1-click migration tool to transfer their site to the new Website Builder.

This option is designed to quickly move your existing site into the new builder while preserving key settings and structure, giving you a starting point that you can review, customize, and publish.

If you’d prefer more control over how your site is rebuilt, you can also migrate your legacy site manually. For step-by-step guidance, see [Manually migrating a legacy website to the new builder (Part 1)](https://www.beehiiv.com/support/article/34881541755287-manually-migrating-a-legacy-website-to-the-new-builder-part-1) and [Manually migrating a legacy website to the new builder (Part 2): Adding custom pages and featuring posts](https://www.beehiiv.com/support/article/34882422067479-manually-migrating-a-legacy-website-to-the-new-builder-part-2-adding-custom-pages-and-featuring-posts).

---

## Access the 1-click migration tool

To get started, log in to your account and go to the banner at the top of your dashboard, click **New builder**.

![](https://beehiivhelp.zendesk.com/hc/article_attachments/37899491797911)

If you’ve already started setting up a site in the new Website Builder, you’ll be prompted to choose one of the following:

-   **Go to editor:** Opens the new Website Builder where you can continue to customize your site.
-   **Re-migrate from legacy site:** Restarts the migration using the 1-click migration tool.  
      
    ![](https://beehiivhelp.zendesk.com/hc/article_attachments/37899517657623)

If you choose to re-migrate your site, a notice will appear outlining what to expect.

To continue:

-   Check the box next to **I understand and want to proceed with migration**.
-   (Optional) Select **Auto-publish after migration** if you’re ready to make your site live immediately.
-   Click **Start migration**.

Once migration is complete, the new Website Builder will open with your site ready to review, edit, or publish.

To get familiar with the builder and its tools, refer to [Website Builder Orientation](https://www.beehiiv.com/support/article/33509520853399-how-to-use-the-website-builder).

---

## Try a different website template after migration

After migrating your legacy site, you may want to explore a different template or update your site’s design. To do this, go to the left panel icons menu and click on **Settings**, then select **All settings**. 

![](https://beehiivhelp.zendesk.com/hc/article_attachments/37899517658135)

From the left panel, select **Themes**.

![](https://beehiivhelp.zendesk.com/hc/article_attachments/37899517658775)

On the **Themes** page, click **Switch Templates**. 

![](https://beehiivhelp.zendesk.com/hc/article_attachments/37899517661463)

You’ll be taken through the [Website Builder onboarding flow](https://www.beehiiv.com/support/article/29730433807767) again.

---

## Set your site purpose and continue onboarding

The onboarding flow will begin with the **Purpose of your site**. Since your legacy site has already been migrated, the **Migrate from legacy beehiiv site** option will be preselected but unavailable.

Select one of the other options to continue:

-   **Link in bio:** A dedicated landing page with links to your content.
-   **Simple blog:** A streamlined site focused on posts or newsletters.
-   **News site:** A full-featured content website.

Click **Next** to move through the remaining onboarding steps.

![](https://beehiivhelp.zendesk.com/hc/article_attachments/37899517662103)  
For a full walkthrough of selecting a template, customizing your theme (global design settings), and completing onboarding, see [Getting started in the Website Builder: Selecting a template and theme](https://www.beehiiv.com/support/article/29730433807767-getting-started-in-the-website-builder-selecting-a-template-and-theme).

---