How to sync images

Whalesync uploads images to your WordPress Media Library for you. Map a field that holds images in your other app, such as an Airtable attachment field, to an image field in WordPress, and each image is uploaded as it syncs.

Which WordPress fields take images

• Featured Media, the featured image on Posts, Pages, and custom post types.
• ACF image fields. The field group needs "Show in REST API" turned on. See Advanced Custom Fields (ACF).

Set it up

1. In your other app, add a field that holds images, such as an attachment field in Airtable.
2. In Whalesync, map that field to Featured Media or to your ACF image field.
3. Turn on the sync. Whalesync uploads each image to your Media Library and sets the WordPress field to it.

It works the other way too: an image set in WordPress syncs to the mapped field in your other app.

Things to keep in mind

• The field you map from has to hold files, like an Airtable attachment field or a Notion "Files & media" property. Text and URL fields, such as image links in Google Sheets, can't be mapped to an image field.
• Each image can be up to 20 MB. See File hosting.
• Your site decides which file types it accepts. If it refuses one, such as an SVG on a site without an SVG plugin, the record shows a sync error that starts with "Your WordPress site refused the uploaded file".
• You can't map the Media table itself. See Supporting tables.
• An ACF field with _fk_ in its name, like image_fk_media, is read as a link to another table, not as an image. This guide used to recommend that naming along with a Media table in Airtable. That setup isn't needed anymore, so leave _fk_ out of image field names.