Webflow

Webflow Connector Guide

This guide provides an overview of how to connect Whalesync to Webflow and answers common questions.

Connecting to Webflow

To connect Whalesync to your Webflow account, we use OAuth. This is a secure, standard way for you to grant Whalesync access without sharing your password.

When you set up Webflow in Whalesync, you'll be redirected to Webflow's website. You'll be asked to log in to your Webflow account and then approve the connection to Whalesync. You'll then choose which workspaces or individual sites you'd like to give access to. Once you approve, you'll be sent back to Whalesync to continue your setup.

If you prefer not to sign in, or are connecting Webflow through the API or MCP server, you can use a site API token instead:

Connect with a site API token

Syncing Data

Whalesync treats your Webflow Sites as "bases" and your Collections as "tables". This allows you to sync data between your Webflow CMS and other apps.

Whalesync syncs items from your Webflow CMS Collections. Webflow users can no longer be synced, because Webflow discontinued User Accounts (formerly Memberships) on January 29, 2026. See Webflow Memberships sync.

A special feature of the Webflow connector is the "Webflow Status" field. When you map a Webflow table, Whalesync creates this field. It lets you control whether a CMS item is "Published", "Draft", or "Archived".

Webflow status field

Localized Sites

If your Webflow site uses Webflow Localization, Whalesync syncs each locale as its own table. You'll see your collections show up once per locale, with the locale tag in brackets (e.g. Blog Posts (FR-FR)). Note that creating a record in the primary collection creates it in every locale, but field edits are never copied between locales.

Webflow localization

Automatic Table and Field Creation

Whalesync can automatically create tables and fields in Webflow to match the structure of the other app you're syncing with.

Things to Keep in Mind

Publishing Your Site

Any changes you make to your Webflow data through Whalesync (like creating a new CMS item or updating an existing one) will not be live on your website until you publish your site in Webflow. While you can change an item's status to "Published" using the "Webflow Status" field, the final step is always to go to your Webflow dashboard and publish the site to make the changes public.

Whalesync requires you to republish your Webflow site any time you make a change to the CMS structure (eg. add a new field to a collection) in order for syncing to work.

Webflow sites need to be published to all domains otherwise Webflow rejects API calls (aka sync updates).

Primary Field

In Webflow, the primary field for a Collection is usually the Name field. Webflow requires this field to always have a non-empty value, so it's important to have this mapped correctly for reliable syncing. This is also the value that's used to display records in the Whalesync UI.

Multi-reference fields

Whalesync supports multi-reference fields out of the box! See the guide below to ensure this is configured correctly:

Reference fields

Publishing Schedule Limitations

When Whalesync updates your Webflow CMS items (whether creating new items or modifying existing ones), any publishing schedules configured for those items will be automatically cleared. Webflow schedules are for a specific version of the item content, so any change to that content invalidates the schedule. To maintain your publishing schedule, you'll need to manually reconfigure the publishing schedule in the Webflow Designer.

Supported Fields

Field	Status
🎨 Color	✅ Supported
📅 Date/Time	✅ Supported
✉️ Email	✅ Supported
📂 File	✅ Supported
🖼️ Image	✅ Supported
🆔 Item ID	➡️ Supported (1-Way)
🔗 Link	✅ Supported
🖼️ Multi-image	✅ Supported
🖇️ Multi-Reference	✅ Supported
#️⃣ Number	✅ Supported
🔽 Option	✅ Supported
📞 Phone	✅ Supported
📝 Plain text - single line	✅ Supported
📝 Plain text - multiple line	✅ Supported
🖇️ Reference	✅ Supported
📰 Rich text	✅ Supported
☑️ Switch	✅ Supported
📹 Video link	✅ Supported

Synthetic Fields

Whalesync adds some special fields to your Webflow tables. These fields are not present in your Webflow database but are available to map in your sync.

Field Name	Explanation	Writable
Webflow Status	Controls the state of a CMS item (Active, Draft, or Archived).	Writable
Webflow Record ID	The unique identifier for a record from Webflow's system.	Read-only
Created On	The timestamp for when a record was created in Webflow.	Read-only
Updated On	The timestamp for when a record was last updated in Webflow.	Read-only