Skip to content

Console · Migration Tool

Create the new Insites site

Last updated 18 November 2026

Create the Insites site a site migrates to in Insites Console, choose its plan, and get the access token the tool connects with.

The tool copies a site onto an Insites site that already exists. You create it in Insites Console, then give the tool an access token for it. Create a new, empty one: nothing is written to it until you have read and approved the plan.

Staging or production

Console offers two kinds of site. Which one you need depends on what you are doing.

In ConsoleWhat it isUse it for
Build and testA staging site, free. Its address ends staging-insites.io.A dry run, or trying the tool on a copy of the site.
Go liveA production site, on a paid plan. Its address ends prod01-insites.io.The real migration. The copy, the final sync and the domain move all happen on this one site, so create the one the site will run on.

The plan, and what it costs

A staging site is free. A production site is on one of four plans: Starter, Growth, Business or Pro, paid monthly or yearly. You choose the plan while you create the site, and pay at a secure checkout once you press Create site. Console shows the plans to choose from. Each plan includes a monthly amount of use, such as API calls, which the site's Usage tab in Console shows against the plan. Ask your Insites contact if you are not sure which plan the site needs.

Create it

  1. Sign in to Insites Console and open Sites from the main menu.
  2. Press Create site.
  3. Give it a name and check its address. The address is made from the name, and you can change it. Choose Build and test or Go live.
  4. When it asks how to start, choose from scratch, not a template. A template adds its own pages and records, which the migration would then have to fit around.
  5. For a production site, choose its plan and whether to pay monthly or yearly.
  6. On Review & create, press Create site. A production site then goes to the secure checkout.

Every new site comes with the Insites modules. The plan checks that their versions can take the old site's data, and says so if one needs updating first.

Get the access token

The tool connects to the new site with your own Console access token.

  1. In Console, open the new site, then its CLI tab. The Access Token card is the last one on the tab.
  2. Press Get my token and copy the token. It starts iak_.
  3. In the tool, on the Destination step, paste the address of the new site and the token.
The token needs the Developer role on the site. Admin and Owner include it. A migration changes code, settings and files as well as records, and an Editor's token can only change records, so the tool refuses an Editor's token when you connect, before anything is planned. If you are an Editor, ask an admin of the site to give you the Developer role, then get a new token.

More on the token, how long it lasts and what happens to it, and on the key for the old site: Get the key for each site.