Insites Studio®Docs

Command Palette

Search for a command to run...

Add a connector

Wire a Shopify, WordPress, Webflow, Wix, or Squarespace source into a Studio project.

Connectors let Studio read content from an external CMS or commerce platform during a migration. Each connector has its own setup pattern — credentials, scopes, gotchas. This guide is the cross-cutting how-to; the specifics live in the per-platform pages.

Pick your source#

Shopify

Custom App with Admin API scopes.

WordPress

REST API or XML export.

Webflow

Site export plus CMS API.

Wix

Public crawl plus content endpoints.

Squarespace

Export bundle plus API.

Custom

Generic crawl for arbitrary sites.

The shared steps#

  1. Open the Migrate flow

    From the workspace dashboard: New project → Migrate. (If you're adding a connector to an existing migration, the same form is reachable from the project's Migration page.)

  2. Generate platform credentials

    Open the connector guide for your source. Each one tells you exactly which scopes or API tokens to grant — read it before generating anything. Granting too few scopes silently skips data; granting too many widens your token's blast radius unnecessarily.

    For ecommerce migrations, the Required table lists scopes that must be on, and the Recommended table lists scopes that unlock additional data. Anything in Skip these is unnecessary and should not be granted.

  3. Test the connection

    The migrate form's Test connection button calls POST /api/connectors/<platform>/test. A green check means the credentials are valid; a red error tells you exactly what's missing. Don't proceed past this step until it passes.

  4. Run the import

    The import streams progress: products fetched, pages crawled, assets transferred. Most imports take a few minutes; large stores can take an hour or more.

  5. Review the migration plan

    Studio sends the captured fingerprint to Claude and produces a markdown migration plan. Review it before building — see Migrate an existing site for what the plan covers.

Rotating credentials#

Connector credentials are sensitive. Rotate the source-platform token after the migration completes:

  • For Shopify: revoke the Custom App token from Settings → Apps and sales channels.
  • For WordPress: regenerate or revoke the REST API key.
  • For Webflow / Wix / Squarespace: revoke the API token in the platform's developer settings.

Studio doesn't keep tokens after a successful migration in the alpha — they live in your browser's localStorage for the session, then they're gone. (When OAuth lands before GA, tokens won't touch the browser at all.)