🛠️ Common failure modes and fixes
🔑 Auth error — connector marked as invalid
Cause: Your Wix OAuth token has expired, or your Wix API Key is missing a required permission. A common case is the API Key lacking the Manage Blog permission, which surfaces as: Categories endpoint failed: Invalid or expired API Key. Please ensure your Wix API Key has the 'Manage Blog' permission enabled.
Fix: Delete the connector in Account Menu → Settings → CMS Connectors and reconnect with a fresh OAuth authorization. Make sure you authorize all requested permissions, including Manage Blog. The connector now tracks and exposes its credential status, so an invalid or disconnected connector is flagged in the UI before publishing; use the reconnect flow to restore it.
🔍 Meta-site not found — sync fails resolving the Wix site
Cause: The credential can't be matched to a valid Wix site (meta-site), shown as Categories endpoint failed: meta-site not found.
Fix: Reconnect the connector and authorize the correct Wix site so the credential is bound to a resolvable meta-site.
👤 Missing member — publish fails with member_id required
Cause: No author/member was selected in the connector settings.
Fix: Edit the connector and select a valid Wix member as the default author. The member must exist in your Wix site's member list.
⏳ Rate limit — publish hangs
Cause: Wix API rate limit hit during batch publishing.
Fix: Handled automatically with retry logic. Wait a few minutes; the publish will complete on its own.
✅ Post-publish verification error codes
CONTENT_MISSING— article didn't appear; try republishingPAGE_NOT_ACCESSIBLE— page is live but returns an error when accessedCONTENT_MISMATCH— content on page doesn't match what was sent
Contact support with the error code and article URL if the issue persists after republishing.