Page cover

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.

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 can sync several types of data from Webflow:

  • CMS Data: Sync items from your Webflow CMS Collections.

  • Users: If you use Webflow Memberships, you can sync your user accounts.

  • Form Submissions: Data from your Webflow forms can be synced to other tools for analysis or processing.

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

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:

Relation fields

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

Last updated

Was this helpful?