Known issues

There are a few uncommon problems that you may encounter while using Whalesync. We're actively working on fixes, but in the meantime these are some workarounds.

Images that are too large or have missing headers won't sync to Webflow


Webflow is very particular about what images it accepts and will silently fail to sync images that do not meet certain criteria. Specifically images can be synced to Webflow if:

  1. They are less than 4 MB in size

  2. They are configured correctly on the server with a known image MIME type that has lowercase letters


If your images are over 4 MB, you can make them smaller with image editing software to reduce their size.

If your images are hosted on a service that does not produce the correct MIME type, you may need to rehost your images on a service that does, such as Cloudinary.

Images that were synced from Airtable are broken


When syncing images from Airtable to Bubble, Notion, or Postgres, the images appear to be broken after a few hours. This is due to a recent change in how Airtable exposes its image URLs. Now they expire, after which the URL won't work anymore.


Please see File hosting for details on making sure your base is set up to handle this.

Airtable linked records, Airtable views, and record deletes in Webflow


If you're syncing an Airtable view to Webflow, if a record that was previously in the view is then removed from the view, Whalesync will sync that removal as a record delete. If that record is referenced by another table in Airtable via a linked record field and that field is synced to Webflow, Whalesync will be unable to delete the record in Webflow. You will see an error on the issues page: "This item is being referenced by another item in your CMS".

For example, let's say you have a "Published Blog Posts" Airtable view for a blog posts table and an "Authors" table that has a linked record field pointing to every blog post an author has written. One of your blog posts that was previously visible in the published view then is unpublished, hence disappearing from the view. The author still has a reference to that blog post in its linked record field. Whalesync will be unable to delete the blog post from Webflow as long as that reference exists in the linked record field.


There are two possible workarounds (using the above example):

  1. Create a new linked record field that only has a the blog posts in the "Published Blog Posts" view and sync that field to Webflow. You can use Airtable automations to dynamically update this field as blog posts come in and out of the view. Here is a video showing the workaround.

  2. Update the linked record field on a one-by-one basis in either Airtable or Webflow to remove references to blog posts no longer in the view.

Last updated