> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vortexiq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Ecwid by Lightspeed to Vortex IQ

> Connect Ecwid by Lightspeed to Vortex IQ for 37 KPI cards, plus cross-platform Vortex Mind diagnostics.

Connecting Ecwid by Lightspeed to Vortex IQ gives the AI OS a live read on your Ecwid by Lightspeed data, feeding the Nerve Centre dashboard, Vortex Mind diagnostics, and Ask Viq.

## What data Vortex IQ reads from Ecwid by Lightspeed

* **Product**
* **Order**
* **Customer**
* **Storefront**

## How to connect

<Steps>
  <Step title="Open Connected Sources">
    In your Vortex IQ workspace, go to **Settings → Connected Sources**. You need Admin role in the workspace to connect sources.
  </Step>

  <Step title="Find the Ecwid by Lightspeed card">
    Locate the Ecwid by Lightspeed connector card and click **+ Connect**.
  </Step>

  <Step title="Authorise with Ecwid by Lightspeed">
    You are redirected to Ecwid by Lightspeed's own authorisation page (`https://my.ecwid.com/api/oauth/authorize`). Sign in and approve the requested permissions. Vortex IQ requests these scopes: `read_catalog`, `read_orders`, `read_customers`, `read_store_profile`.
  </Step>

  <Step title="Return to Vortex IQ">
    Ecwid by Lightspeed redirects you back to Vortex IQ once authorisation completes. The connector card flips to Connected automatically; no credentials are copied by hand.
  </Step>

  <Step title="Wait for the first data pull">
    KPI cards begin populating once the first sync completes. Timing depends on the Ecwid by Lightspeed API response size and rate limits.
  </Step>
</Steps>

## Available KPI cards

Vortex IQ populates **37** Nerve Centre cards from your Ecwid by Lightspeed data. See the [Ecwid by Lightspeed KPI card reference](/nerve-centre/kpi-cards/ecwid) for the full list with definitions, calculations, and sentiment bands.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Credential verification fails">
    Re-check each value against the Ecwid by Lightspeed developer console for typos or trailing whitespace. If a scope or permission is missing, Ecwid by Lightspeed will typically return a 401 or 403 on the verification call rather than a generic failure.
  </Accordion>

  <Accordion title="Cards show no data after connecting">
    Allow time for the first sync to complete; large accounts can take longer. If cards are still empty after an hour, disconnect and reconnect to confirm the credentials were saved correctly.
  </Accordion>
</AccordionGroup>