Install Wavize on Wix

Wix requires two configurations: widget and store

Wix custom code displays the widget. The Wix commerce connection lets Wavize read catalogue and orders through the API using base URL, UUID Site ID and API key. You may install the widget without connecting Wix Stores, but catalogue and tracking answers will then be unavailable.

Wavize detects whether the site uses Wix Stores v1 or Catalog v3 and stores that version on the connection. Testing must succeed before interpreting missing products as an AI issue.

Separate secrets
The public widget token goes into custom code. The Wix API key remains only in the Wavize server form and must never be pasted into Wix Custom Code.

Publish widget with custom code

Your Wix plan and domain must allow custom code.

1. Copy Wavize block

   Under Assistant > Installation, copy the complete script linked to the public Wix domain. Do not replace token with a commerce API key.

2. Add in Wix

   In Wix dashboard, open Settings > Advanced > Custom Code, add the block to body and choose all intended pages. Publish the site after saving.

3. Respect consent and domain

   Trigger code according to cookie policy and test the final URL. A free Wix domain and custom domain are different hosts for Wavize control.

Create a dedicated Wix API key

In Wix account dashboard, open Account Settings > API Keys and create a key limited to the site and required permissions.

1. Name and scope

   Name it Wavize and select the relevant site. Avoid an account-wide key when a narrower scope is possible.

2. Commerce read permissions

   Grant read access to catalogue/products and eCommerce orders. Wix labels may evolve between Catalog v1 and v3; locate corresponding Business Management / Wix Stores / eCommerce permissions.

3. One-time copy and rotation

   Copy the key at creation into secure storage. If lost or exposed, create a new one, update Wavize, test and revoke the old one.

Find the exact Site ID

Site ID is neither site name nor domain. Wavize expects a UUID.

• From Wix developer tools

  Open the site in developer dashboard or account API tools and copy the selected site identifier. It looks like xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

• Verify association

  Site ID must belong to the site authorized by the key. A valid key for another site may produce denial or an empty catalogue.

• Base URL

  Enter the public HTTPS site in Wavize. It is used for product links and connection identity; do not paste a Wix editor URL.

Test catalog version and orders

Save connection, click Test, then activate after successful verification.

1. v1/v3 detection

   Wavize probes available APIs and stores V1_CATALOG or V3_CATALOG. Do not manually change this value; it depends on the Wix site.

2. Product search

   Test a published product with exact name, price and variant. A hidden or unavailable product may be absent from recommendations.

3. Order and email

   Use a test order and its customer email. The answer stays neutral when reference or email does not match, even when the order exists.

Quick Wix diagnosis

Always separate widget invisibility from commerce API failure.

• Widget absent — Check custom code, publishing, domain and consent.
• 401/403 test — Check key, permissions, authorized site and Site ID.
• Empty catalogue — Check detected version, published products and key scope.