Skip to main content
Theme

How-to

Get a Wix API key and site ID

The tool reads a Wix site with an API key and the site's ID. The key only reads: nothing is written back to Wix. This takes about five minutes. You need to be the owner or a co-owner of the Wix account that owns the site.

Make the API key

  1. Sign in to Wix with the account that owns the site, and open the API Keys Manager at manage.wix.com/account/api-keys.
  2. Click Generate API Key and name it Insites Migration Tool.
  3. Under Sites, choose Specific sites and pick the site you are migrating. Leave the other sites out.
  4. Under Permissions, give the key read access to each of these, and leave everything else off:
    • Wix Site URLs: the site's published addresses, so the tool can check it reads the site you named.
    • Site Properties: the site's name, language, time zone and email address.
    • Wix Blog: posts, categories and tags.
    • Wix Data: the CMS collections and their items.
    • Wix Forms: the forms and their submissions.
    • Contacts and Members: the people who move into the CRM.
    • Media Manager: the site's files.
    • SEO: the redirects in the URL Redirect Manager.
  5. Click Generate Key and copy the key. Wix shows it once. Keep it somewhere safe until you paste it into the tool.

A permission you leave off is not fatal. When you connect, the tool lists what the key cannot read, and the migration goes ahead without it. Only Site Properties is required.

Find the site ID

  1. In Wix, open the site's dashboard.
  2. Look at the address in your browser. It reads manage.wix.com/dashboard/1a2b3c4d-1234-5678-9abc-0123456789ab/home. The part after /dashboard/ is the site ID: 36 characters, with four dashes.

Connect in the tool

On the Source step, choose Wix site. Give the address visitors use (for a free site, its wixsite.com address), the site ID, and the key. The tool checks the key reads the site at that address, and says which site it reads if it does not.

After the migration

Delete the key in the API Keys Manager when the migration is finished. The tool also removes its encrypted copy when you close the migration: how long a key is kept.

What the tool copies, and what stays on Wix, is on the Wix connector page.