# Wix CMS

## Wix CMS Connector Guide

This guide provides an overview of how to connect Whalesync to Wix CMS (also called Content Manager).

If you're unsure whether you're using Wix's CMS, review Wix's overview: [About the CMS (Content Manager)](https://support.wix.com/en/article/cms-content-management-system-an-overview). The CMS is for managing structured content in collections and powering dynamic pages. This is distinct from other Wix features like Wix Blog, Wix Forms, Wix Stores, Wix Bookings, Wix Events, or other Wix data sources.

### Connecting to Wix CMS

To connect your Wix CMS account to Whalesync, you'll authenticate using OAuth. This securely grants Whalesync access without sharing your password.

When you connect, you'll be redirected to Wix to approve the connection. As part of authorization, you must choose the specific Wix site you want Whalesync to access. After approving access to that site, you'll be returned to Whalesync to continue setup.

### Compatible fields

Whalesync does not provide full support for all fields in Wix CMS. If you need anything that is missing, please [reach out and let us know](https://docs.whalesync.com/resources/support) to inform our planning.

| Field                     | Status                        | Notes                           |
| ------------------------- | ----------------------------- | ------------------------------- |
| Text                      | ✅ Fully supported             |                                 |
| Number                    | ✅ Fully supported             |                                 |
| Date                      | ✅ Fully supported             |                                 |
| Time                      | ✅ Fully supported             |                                 |
| Boolean                   | ✅ Fully supported             |                                 |
| Image                     | ✅ Fully supported             |                                 |
| URL                       | ✅ Fully supported             |                                 |
| Document                  | ✅ Fully supported             |                                 |
| Tags                      | ✅ Fully supported             |                                 |
| Color                     | ✅ Fully supported             |                                 |
| Reference                 | ✅ Fully supported             |                                 |
| Multi-reference           | ✅ Fully supported             |                                 |
| Javascript object & array | ✅ Fully supported             |                                 |
| Rich content              | ⚠️ Supported with limitations | Does not support embedded media |
| Media Gallery             | ➡️ Supported (1-Way)          | Read-only                       |
| Address                   | ➡️ Supported (1-Way)          | Read-only                       |
| Rich text                 | ✖️ Not supported              |                                 |
| Audio                     | ✖️ Not supported              |                                 |
| Video                     | ✖️ Not supported              |                                 |
| Multiple documents        | ✖️ Not supported              |                                 |

### Item Visibility

Wix CMS collections have a "Control item visibility" feature that adds a **Status** field to each item, which can be set to "Visible" or "Hidden." This feature is enabled by default for collections created after November 4th, 2025, and can be manually enabled for older collections.

Items marked as "Hidden" in Wix are **not accessible via the Wix API**, which means they will not be synced by Whalesync. This is a Wix platform limitation — there is no way to query hidden items through the API for regular CMS collections.

**If you notice items missing from your sync**, check the Status field in your Wix collection to confirm the items are set to "Visible."

{% hint style="warning" %}
If you are using the built-in visibility feature to manage draft or unpublished content, those items will not sync. Instead, we recommend creating a custom boolean field (e.g., "isPublished") in your collection to control your publishing workflow. Custom fields are always accessible via the API and will sync normally regardless of their value.
{% endhint %}

### Additional Fields

Whalesync adds special fields that are available to map in your sync but are not visible in Wix.

| Field Name    | Explanation                                   | Writable |
| ------------- | --------------------------------------------- | -------- |
| Wix Record ID | The unique identifier for an item in Wix CMS. | No       |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.whalesync.com/connectors/wix-cms.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.