# Whalesync Docs

> Whalesync two-way syncs SaaS apps such as Webflow, HubSpot, Postgres, and Supabase with Airtable, Notion, and Google Sheets. Each link below is a page of these docs as Markdown; any page is available as Markdown by adding `.md` to its URL.

The full text of every page, in one file: https://docs.whalesync.com/llms-full.txt

- [What is Whalesync?](https://docs.whalesync.com/readme.md): Whalesync is a no-code tool that two-way syncs your SaaS apps with Airtable, Notion, and Google Sheets. What it does and how it differs from Zapier.

## Start Here

- [Quick start](https://docs.whalesync.com/start-here/quick-start.md): Set up your first Whalesync sync in under five minutes. Create a sync, connect your apps, map tables and fields, then activate it.
- [MCP quickstart](https://docs.whalesync.com/start-here/mcp-quickstart.md): Build a Whalesync sync by chatting with your AI agent. Connect the Whalesync MCP server, sign in to your apps, map tables, then review and activate.
- [Video tutorials](https://docs.whalesync.com/start-here/video-tutorials.md): Video tutorials from automation experts and Webflow on Airtable + Webflow, Airtable + Notion, HubSpot + Airtable, programmatic SEO, and blog content.

## Popular Syncs

- [Webflow + Airtable](https://docs.whalesync.com/popular-syncs/webflow-+-airtable.md): Use Airtable as a CMS for your Webflow site with Whalesync. Build programmatic SEO pages and manage translated CMS content for each Webflow locale.
- [HubSpot + Notion](https://docs.whalesync.com/popular-syncs/hubspot-+-notion.md): Two-way sync HubSpot and Notion with Whalesync to view and edit your most important CRM data, like deals, from within your Notion company wiki.
- [Supabase + Airtable](https://docs.whalesync.com/popular-syncs/supabase-+-airtable.md): Sync Supabase and Airtable so anyone can edit your database from a spreadsheet, and build internal tools without needing any engineers.
- [Notion + Google Sheets](https://docs.whalesync.com/popular-syncs/notion-+-google-sheets.md): Two-way sync Notion databases and Google Sheets with Whalesync, so you can bring Sheets formulas into Notion and edit your data in either app.

## Connectors

- [Affinity](https://docs.whalesync.com/connectors/affinity.md): Two-way sync Affinity people, organizations, opportunities, notes, and lists with Airtable, Notion, Google Sheets, and more.
- [Authorize Affinity](https://docs.whalesync.com/connectors/affinity/authorize-affinity.md): Get the API key Whalesync needs to authorize Affinity. In Affinity, click Settings, then API, and copy your API key to connect your account.
- [Full records vs. shallow records](https://docs.whalesync.com/connectors/affinity/full-records-vs.-shallow-records.md): Why Whalesync syncs Affinity records as shallow records with only a name and email by default, and how to fully sync a list to get every field.
- [List-specific fields](https://docs.whalesync.com/connectors/affinity/list-specific-fields.md): Sync Affinity list-specific fields, which only appear on certain lists. Whalesync shows them as fields you can map, prefixed with the list's name.
- [Notes in Affinity](https://docs.whalesync.com/connectors/affinity/notes-in-affinity.md): Whalesync can edit only the content of an Affinity note, not its linked people, organizations, or opportunities, and writes rich text as raw Markdown.
- [Airtable](https://docs.whalesync.com/connectors/airtable.md): Two-way sync Airtable bases with Notion, Webflow, HubSpot, Postgres, and more. Covers connecting, view sync, API quotas, and supported fields.
- [Airtable view sync](https://docs.whalesync.com/connectors/airtable/airtable-view-sync.md): Sync a filtered Airtable view instead of the entire table. Changes to the view's filters don't sync until Whalesync's next full sync.
- [Airtable API quota](https://docs.whalesync.com/connectors/airtable/airtable-api-quota.md): Airtable's Free and Team plans cap monthly API calls. How Whalesync uses your Airtable API quota, and which Airtable plan to choose for syncing.
- [Connect with a personal access token](https://docs.whalesync.com/connectors/airtable/personal-access-tokens.md): Connect Airtable with a personal access token instead of signing in. The seven scopes and base access the token needs, and how to fix token errors.
- [Asana](https://docs.whalesync.com/connectors/asana.md): Two-way sync Asana tasks, sections, assignees, and custom fields with Airtable, Notion, Google Sheets, and more. Each Asana project syncs as a table.
- [Authorize Asana](https://docs.whalesync.com/connectors/asana/authorize-asana.md): Connect Asana to Whalesync by signing in or with a personal access token, and what to do about each Asana connection error.
- [Attio](https://docs.whalesync.com/connectors/attio.md): Two-way sync Attio people, companies, deals, custom objects, lists, tasks, and notes with Airtable, Google Sheets, Notion, and more.
- [Attio lists](https://docs.whalesync.com/connectors/attio/attio-lists.md): Sync each Attio list as its own table, with list attributes two-way and parent record fields read-only, without also syncing People or Companies.
- [Attio custom objects](https://docs.whalesync.com/connectors/attio/attio-custom-objects.md): Sync Attio custom objects such as Projects or Invoices just like People and Companies, including foreign keys in both directions and lists built on them.
- [Attio tasks](https://docs.whalesync.com/connectors/attio/attio-tasks.md): Two-way sync every Attio task in one Tasks table with deadlines, completion, assignees, and linked people and companies. Task text can't be edited later.
- [Attio notes](https://docs.whalesync.com/connectors/attio/attio-notes.md): Two-way sync all Attio notes as one Notes table with Markdown content and a parent record. Notes can't move to another record, and images don't sync.
- [Close](https://docs.whalesync.com/connectors/close.md): Two-way sync Close leads, contacts, opportunities, tasks, and notes with Airtable, Notion, Google Sheets, and more.
- [Authorize Close](https://docs.whalesync.com/connectors/close/authorize-close.md): Create a Close API key to connect your Close organization to Whalesync, and what to do about each Close connection error.
- [Copper](https://docs.whalesync.com/connectors/copper.md): Two-way sync Copper people, companies, opportunities, leads, tasks, and projects with Airtable, Notion, Google Sheets, and more.
- [Authorize Copper](https://docs.whalesync.com/connectors/copper/authorize-copper.md): Create a Copper API key to connect your Copper account to Whalesync, and what to do about each Copper connection error.
- [Framer](https://docs.whalesync.com/connectors/framer.md): Two-way sync Framer CMS collections with Airtable, Notion, Google Sheets, and more. Covers the project URL, Server API keys, supported fields, and slugs.
- [Authorize Framer](https://docs.whalesync.com/connectors/framer/authorize-framer.md): Connect a Framer project to Whalesync with its project URL and a Server API key, and what to do about each Framer connection error.
- [Google Sheets](https://docs.whalesync.com/connectors/google-sheets.md): Two-way sync Google Sheets with Airtable, Notion, HubSpot, Postgres, and more. Covers connecting, header row rules, formatting, and supported fields.
- [Formatting columns](https://docs.whalesync.com/connectors/google-sheets/formatting-columns.md): Format Google Sheets columns as numbers, percentages, or dates so they match field types in other apps and two-way sync. Text columns need no formatting.
- [Foreign keys](https://docs.whalesync.com/connectors/google-sheets/foreign-keys.md): Set up foreign keys in Google Sheets with a Related_[Table Name] column holding Whalesync IDs, mapped to linked records or reference fields in other apps.
- [Multi-select fields](https://docs.whalesync.com/connectors/google-sheets/multi-select-fields.md): Sync multi-select fields in Google Sheets by naming the column multi_[column name] and, optionally, setting data validation to allow multiple selections.
- [Avoid sort range](https://docs.whalesync.com/connectors/google-sheets/avoid-sort-range.md): Using sort range in Google Sheets can scramble the Whalesync ID column and change your data. Include the Whalesync ID column in any sort range you use.
- [Whalesync ID column](https://docs.whalesync.com/connectors/google-sheets/whalesync-id-column.md): Google Sheets doesn't give rows a unique ID, so Whalesync adds a Whalesync ID column to each synced sheet. Avoid editing it, since it identifies each row.
- [HubSpot](https://docs.whalesync.com/connectors/hubspot.md): Two-way sync HubSpot contacts, companies, deals, tickets, custom objects, and more with Airtable, Notion, Google Sheets, and other apps.
- [Associations](https://docs.whalesync.com/connectors/hubspot/associations.md): Two-way sync HubSpot associations by mapping them to Airtable linked records, Notion relations, Postgres foreign keys, or Webflow reference fields.
- [Webhooks](https://docs.whalesync.com/connectors/hubspot/webhooks.md): Which HubSpot contact, company, deal, and ticket properties sync within seconds via webhooks, and which, like custom properties, are polled every 3 hours.
- [Merging records](https://docs.whalesync.com/connectors/hubspot/merging-records.md): Merging HubSpot records deletes both originals and creates a new one, so Whalesync does the same in your synced Airtable, Google Sheets, or Notion table.
- [Klaviyo](https://docs.whalesync.com/connectors/klaviyo.md): Two-way sync Klaviyo profiles, custom properties, and list membership with Airtable, Notion, Google Sheets, and more. Segments sync as a read-only table.
- [Authorize Klaviyo](https://docs.whalesync.com/connectors/klaviyo/authorize-klaviyo.md): Connect Klaviyo to Whalesync by signing in or with a private API key, which permissions the key needs, and what to do about connection errors.
- [Mailchimp](https://docs.whalesync.com/connectors/mailchimp.md): Two-way sync Mailchimp contacts, tags, merge fields, and groups with Airtable, Notion, Google Sheets, and more, plus read-only campaigns and surveys.
- [Memberstack](https://docs.whalesync.com/connectors/memberstack.md): Two-way sync Memberstack members, plan IDs, permissions, custom fields, and metadata with Airtable, Webflow, Notion, Google Sheets, and more.
- [Authorize Memberstack](https://docs.whalesync.com/connectors/memberstack/authorize-memberstack.md): Find your Memberstack app's secret key to connect Memberstack to Whalesync, and pick the right key for your test or production data.
- [Memberstack custom fields](https://docs.whalesync.com/connectors/memberstack/memberstack-custom-fields.md): Sync Memberstack custom fields by creating a member with the email schema@whalesync.com and filling in a value for each custom field you want to sync.
- [Notion](https://docs.whalesync.com/connectors/notion.md): Two-way sync Notion databases and page content with Airtable, Google Sheets, HubSpot, Postgres, and more. Covers connecting, relations, and supported fields.
- [Notion page sync](https://docs.whalesync.com/connectors/notion/notion-page-sync.md): Map the Page Content field to sync Notion pages to rich text fields in Webflow and other apps. Covers supported blocks and limits when syncing into Notion.
- [Multiple data sources](https://docs.whalesync.com/connectors/notion/multiple-data-sources.md): Fix the Notion error "Databases with multiple data sources are not supported" by creating a new sync or moving extra data sources out of the database.
- [Connect with an internal integration](https://docs.whalesync.com/connectors/notion/internal-integrations.md): Connect Notion with an internal integration secret instead of signing in. The five capabilities it needs, sharing pages with it, and how to fix errors.
- [Pipedrive](https://docs.whalesync.com/connectors/pipedrive.md): Two-way sync Pipedrive deals, persons, organizations, activities, leads, and pipelines with Airtable, Notion, Google Sheets, and more.
- [Pipelines](https://docs.whalesync.com/connectors/pipedrive/pipelines.md): Video walkthrough of how to sync specific Pipedrive pipelines with Whalesync, rather than every pipeline in your Pipedrive account.
- [Postgres](https://docs.whalesync.com/connectors/postgres.md): Two-way sync Postgres tables with Airtable, Notion, Google Sheets, and more. Covers setup requirements, primary keys, supported field types, and tips.
- [Authorize Postgres](https://docs.whalesync.com/connectors/postgres/authorize-postgres.md): Connect Whalesync to Postgres with a connection URI, add SSL and other query parameters, and find guides for popular Postgres hosts.
- [AWS (RDS)](https://docs.whalesync.com/connectors/postgres/authorize-postgres/aws-rds.md): Find your Amazon RDS endpoint, port, and username, build the Postgres connection URI for Whalesync, and allowlist Whalesync's IP in your security group.
- [Basedash](https://docs.whalesync.com/connectors/postgres/authorize-postgres/basedash.md): Find your database credentials under Manage credentials in Basedash and build the Postgres connection URI to paste into the Whalesync connection dialog.
- [DigitalOcean](https://docs.whalesync.com/connectors/postgres/authorize-postgres/digitalocean.md): Connect a DigitalOcean managed Postgres database to Whalesync by setting sslmode=no-verify in your connection string in place of sslmode=require.
- [Heroku](https://docs.whalesync.com/connectors/postgres/authorize-postgres/heroku.md): Connect a Heroku Postgres database to Whalesync by adding sslmode=no-verify to the end of your connection string.
- [Neon](https://docs.whalesync.com/connectors/postgres/authorize-postgres/neon.md): Get the Postgres connection string for your Neon project to connect it to Whalesync. Open the project in your Neon dashboard, click Connect, and copy it.
- [Render](https://docs.whalesync.com/connectors/postgres/authorize-postgres/render.md): Copy the External Database URL from your Render Postgres database's Info page and paste it into Whalesync as your Postgres connection URI.
- [Supabase](https://docs.whalesync.com/connectors/postgres/authorize-postgres/supabase.md): Connect a Supabase database to Whalesync in two steps. Pick Supabase when you add the connection, then authorize Whalesync's access with Supabase OAuth.
- [SQL scripts](https://docs.whalesync.com/connectors/postgres/sql-scripts.md): CREATE TABLE scripts for Postgres tables that match HubSpot contacts, Shopify products, and WordPress posts and pages, ready to sync with Whalesync.
- [Primary key snippets](https://docs.whalesync.com/connectors/postgres/primary-key-snippets.md): SQL snippets to create, change, and auto-generate Postgres primary keys with gen_random_uuid() or serial. Whalesync requires a generated primary key.
- [Foreign key snippets](https://docs.whalesync.com/connectors/postgres/foreign-key-snippets.md): SQL snippets to add Postgres foreign keys for Whalesync, plus the _fk naming workaround that lets a uuid[] array column sync Airtable linked records.
- [Terminology](https://docs.whalesync.com/connectors/postgres/terminology.md): What primary key, foreign key, and generated column mean in Whalesync's Postgres errors, and why each mapped table needs one generated primary key.
- [Multiple foreign keys in a single field](https://docs.whalesync.com/connectors/postgres/multiple-foreign-keys-in-a-single-field.md): Sync an Airtable linked record field to Postgres or Supabase using a uuid[] array column named as a foreign key array, such as People_fk_Contacts.
- [How to sync Postgres views](https://docs.whalesync.com/connectors/postgres/how-to-sync-postgres-views.md): Sync a Postgres or Supabase view with Whalesync by adding a unique, non-null, stable whalesync_postgres_id column, with SQL examples and an AI prompt.
- [Sanity](https://docs.whalesync.com/connectors/sanity.md): Two-way sync Sanity documents with Airtable, Notion, Google Sheets, and more. Covers Studio schema deployment, API tokens, supported fields, and publishing.
- [Authorize Sanity](https://docs.whalesync.com/connectors/sanity/authorize-sanity.md): Create a Sanity API token with the Editor role to connect your Sanity project to Whalesync, and deploy your Studio schema so document types appear.
- [Salesforce](https://docs.whalesync.com/connectors/salesforce.md): Two-way sync Salesforce accounts, contacts, leads, opportunities, cases, and custom objects with Airtable, Notion, Google Sheets, and more.
- [Salesforce view sync](https://docs.whalesync.com/connectors/salesforce/salesforce-view-sync.md): Sync a Salesforce view, a filtered subset of an object's records, instead of the entire object by picking that view when you map tables in Whalesync.
- [Stripe](https://docs.whalesync.com/connectors/stripe.md): Sync Stripe customers, subscriptions, invoices, products, prices, and more one way into Airtable, Notion, Google Sheets, and other apps.
- [Authorize Stripe](https://docs.whalesync.com/connectors/stripe/authorize-stripe.md): Create a Stripe secret API key and paste it into Whalesync to connect your Stripe account. Use the secret key, not the publishable key.
- [Supabase](https://docs.whalesync.com/connectors/supabase.md): Two-way sync Supabase tables with Airtable, Notion, Google Sheets, and more. Covers connecting, primary keys, supported schemas, and field types.
- [Getting your connection string](https://docs.whalesync.com/connectors/supabase/getting-your-connection-string.md): To connect Supabase with a connection string instead of OAuth, copy the Direct connection string from Supabase and paste it into a Postgres connection.
- [Adding default values to primary keys](https://docs.whalesync.com/connectors/supabase/adding-default-values-to-primary-keys.md): Make a Supabase primary key auto-generate values. Edit the column, set its type to uuid and its default value to gen_random_uuid(), and turn on Is Unique.
- [Airtable linked records and Supabase foreign keys](https://docs.whalesync.com/connectors/supabase/how-to-sync-airtable-linked-records-with-supabase-foreign-keys.md): Video walkthrough of syncing Airtable linked record fields with Supabase foreign keys in Whalesync, so record links in Airtable carry over to Supabase.
- [Why does Whalesync create a database user?](https://docs.whalesync.com/connectors/supabase/why-does-whalesync-create-a-database-user.md): Whalesync creates a whalesync_service_account_[ID] role in your Supabase project so you can revoke its access without rotating your postgres password.
- [Removing the Whalesync database user](https://docs.whalesync.com/connectors/supabase/service-account-cleanup.md): Remove Whalesync from a Supabase or Postgres project. Delete your syncs, revoke the OAuth app, and drop the whalesync_service_account_[ID] database user.
- [Why do I need an ID column?](https://docs.whalesync.com/connectors/supabase/why-do-i-need-an-id-column.md): Two-way sync needs a unique ID for every Supabase record. Whalesync uses your primary key, or adds a whalesync_postgres_id column if the table has none.
- [SQL scripts](https://docs.whalesync.com/connectors/supabase/sql-scripts.md): Code to help you quickly create Supabase tables to sync with other apps. Supabase runs on Postgres, so the scripts live in the Postgres section.
- [Primary key snippets](https://docs.whalesync.com/connectors/supabase/primary-key-snippets.md): SQL snippets for setting up Supabase primary keys so Whalesync can sync your tables. Supabase runs on Postgres, so they live in the Postgres section.
- [Foreign key snippets](https://docs.whalesync.com/connectors/supabase/foreign-key-snippets.md): SQL snippets for setting up Supabase foreign keys so Whalesync can sync linked records. Supabase runs on Postgres, so they live in the Postgres section.
- [Terminology](https://docs.whalesync.com/connectors/supabase/terminology.md): Definitions of the Postgres terms Whalesync uses in errors and messages for Supabase syncs. The full list lives in the Postgres section.
- [Multiple foreign keys in a single field](https://docs.whalesync.com/connectors/supabase/multiple-foreign-keys-in-a-single-field.md): How to sync a field that links to many records, such as an Airtable linked record field, to Supabase. The guide lives in the Postgres section.
- [How to sync Postgres views](https://docs.whalesync.com/connectors/supabase/how-to-sync-postgres-views.md): How to sync a Supabase view with Whalesync. Supabase runs on Postgres, so the step-by-step tutorial lives in the Postgres section.
- [Webflow](https://docs.whalesync.com/connectors/webflow.md): Two-way sync Webflow CMS collections with Airtable, Notion, Google Sheets, and more. Covers connecting, the Webflow status field, and supported fields.
- [Supported fields (Airtable and Webflow)](https://docs.whalesync.com/connectors/webflow/supported-fields-at-x-wf.md): How Airtable field types map to Webflow in Whalesync, such as linked records to Reference, and which aren't supported yet, like Multi-select.
- [Webflow Memberships sync](https://docs.whalesync.com/connectors/webflow/webflow-memberships-sync.md): Webflow discontinued Memberships, later called User Accounts, on January 29, 2026, so Whalesync can no longer sync Webflow users. What it means for you.
- [Webflow status field](https://docs.whalesync.com/connectors/webflow/webflow-status-field.md): Set a Webflow item to Active, Draft, or Archived from Airtable or Notion by mapping a single-select Webflow Status field. Covers valid values and limits.
- [Webflow localization](https://docs.whalesync.com/connectors/webflow/webflow-localization.md): Sync localized Webflow CMS content in every locale. Each secondary locale is its own table, such as Blog Posts (FR-FR), and syncs independently.
- [Connect with a site API token](https://docs.whalesync.com/connectors/webflow/site-api-tokens.md): Connect Webflow with a site API token instead of signing in. The six permissions the token needs, why it reaches one site, and how to fix token errors.
- [Wix CMS](https://docs.whalesync.com/connectors/wix-cms.md): Two-way sync Wix CMS collections with Airtable, Notion, Google Sheets, and more. Covers connecting your Wix site and which field types sync.
- [WordPress.org](https://docs.whalesync.com/connectors/wordpress.org.md): Two-way sync WordPress posts, pages, custom posts, categories, and tags with Airtable, Notion, Google Sheets, and more. Covers versions, hosts, and fields.
- [Quick Start Guide: WordPress.org](https://docs.whalesync.com/connectors/wordpress.org/quick-start-guide-wordpress.org.md): Tips for your first WordPress.org sync, from your application password and the Airtable template to Categories and Tags tables, ACF, and host usage limits.
- [Authorize WordPress.org](https://docs.whalesync.com/connectors/wordpress.org/authorize-wordpress.org.md): Connect WordPress to Whalesync with your user email and an application password, and which WordPress user role the connection needs.
- [Whalesync Status plugin](https://docs.whalesync.com/connectors/wordpress.org/whalesync-status-plugin.md): Whalesync Status is an optional WordPress plugin that shows each post's sync status in the posts list and the editor.
- [Advanced Custom Fields (ACF)](https://docs.whalesync.com/connectors/wordpress.org/advanced-custom-fields-acf.md): Sync WordPress custom post types and ACF custom fields with Whalesync. Turn on show in REST API, add a Post Type location rule, and check field support.
- [How to sync images](https://docs.whalesync.com/connectors/wordpress.org/how-to-sync-images.md): Map an Airtable attachment field to Featured Media or an ACF image field, and Whalesync uploads each image to your WordPress Media Library as it syncs.
- [Supporting tables](https://docs.whalesync.com/connectors/wordpress.org/supporting-tables.md): Set up Categories and Tags as linked supporting tables for WordPress Pages and Posts, and how Whalesync handles the Users and Media tables it can't map.
- [Syncing custom taxonomies](https://docs.whalesync.com/connectors/wordpress.org/syncing-custom-taxonomies.md): Sync WordPress custom taxonomies, which Whalesync doesn't list as tables, by mapping term IDs to the native taxonomy field or an ACF Taxonomy field.
- [WordPress status field](https://docs.whalesync.com/connectors/wordpress.org/wordpress-status-field.md): Set a WordPress post to publish, draft, or pending from Airtable or Notion by mapping a single-select Status field with exactly those three options.
- [REST API endpoints](https://docs.whalesync.com/connectors/wordpress.org/rest-api-endpoints.md): The WordPress REST API (wp-json) endpoints Whalesync calls to list post types, read and write records, and upload media, for network-level debugging.
- [Zoho CRM](https://docs.whalesync.com/connectors/zoho-crm.md): Two-way sync Zoho CRM leads, contacts, accounts, deals, and custom modules with Airtable, Notion, Google Sheets, and more.
- [Previous connectors](https://docs.whalesync.com/previous-connectors.md): Why Whalesync retired Bubble, Outreach, Shopify, and other connectors. Existing syncs keep running, and yearly plans may qualify for a refund.
- [Bubble](https://docs.whalesync.com/previous-connectors/bubble.md): Whalesync no longer offers the Bubble connector, but existing syncs keep running. Notes on Bubble's API pricing, supported fields, and sync behavior.
- [Authorize Bubble](https://docs.whalesync.com/previous-connectors/bubble/authorize-bubble.md): Enable the Bubble Data API and find your app's API key and URL to connect Bubble to Whalesync. The Bubble connector is no longer offered.
- [MS Dynamics CRM](https://docs.whalesync.com/previous-connectors/ms-dynamics-crm.md): Whalesync no longer offers the MS Dynamics CRM connector, but existing syncs keep running. Supported objects, and why deletes are best done in Dynamics.
- [Outreach](https://docs.whalesync.com/previous-connectors/outreach.md): Whalesync no longer offers the Outreach connector, but existing syncs keep running. Supported objects, the default owner filter, and read-only fields.
- [Shopify](https://docs.whalesync.com/previous-connectors/shopify.md): Whalesync no longer offers the Shopify connector, but existing syncs keep running. Supported tables, backups, and syncing images and variants.
- [Authorize Shopify](https://docs.whalesync.com/previous-connectors/shopify/authorize-shopify.md): Create a Shopify custom app and Admin API access token to connect Shopify to Whalesync. The Shopify connector is no longer offered.
- [Syncing images](https://docs.whalesync.com/previous-connectors/shopify/syncing-images.md): Whalesync no longer offers Shopify, but existing syncs keep running. Sync Shopify product images through a separate Media table linked to Products.
- [Syncing variants](https://docs.whalesync.com/previous-connectors/shopify/syncing-variants.md): Whalesync no longer offers Shopify, but existing syncs keep running. Sync product variants with separate Variants and Options tables, up to 100 variants.
- [Tutorial videos](https://docs.whalesync.com/previous-connectors/shopify/tutorial-videos.md): Whalesync no longer offers the Shopify connector, but existing syncs keep running. Watch a video tutorial on two-way syncing Shopify with Airtable.
- [Theme Template field](https://docs.whalesync.com/previous-connectors/shopify/theme-template-field.md): Whalesync no longer offers Shopify, but existing syncs keep running. Theme Template syncs two-way if your value exactly matches a Shopify theme.
- [Webflow E-Commerce](https://docs.whalesync.com/previous-connectors/webflow-e-commerce.md): Whalesync no longer offers the Webflow E-Commerce connector, but existing syncs keep running. Supported collections and e-commerce sync notes.
- [Quick Start Guide: WF E-Comm](https://docs.whalesync.com/previous-connectors/webflow-e-commerce/quick-start-guide-wf-e-comm.md): Whalesync no longer offers Webflow E-Commerce, but existing syncs keep running. Setup tips, like the required Variants table and Initial Variant - Price.
- [How to Create Products & Variants](https://docs.whalesync.com/previous-connectors/webflow-e-commerce/how-to-create-products-and-variants.md): Whalesync no longer offers Webflow E-Commerce, but existing syncs keep running. Create products from Airtable by mapping an Initial Variant - Price field.

## Features

- [Two-way sync](https://docs.whalesync.com/features/two-way-sync.md): Sync data in both directions between apps in real time. How to turn on two-way sync and how read-only fields like formulas and lookups behave.
- [Issues](https://docs.whalesync.com/features/issues.md): The Whalesync Issues page lists errors affecting your sync, with the record impacted, the full error message, an AI fix suggestion, and a retry button.
- [Operations](https://docs.whalesync.com/features/operations.md): The Operations page shows a live history of every create, update, and delete Whalesync made, with the app, table, record, and each changed value.
- [Record matching](https://docs.whalesync.com/features/record-matching.md): Link records that already exist in both apps so the initial sync joins them instead of creating duplicates. Choose a match field and check the results.
- [Store record IDs on both sides](https://docs.whalesync.com/features/store-record-ids-on-both-sides.md): Recommended best practice: map each app's built-in Record ID field into a text field on the other side, for stable matching and faster debugging.
- [Filters](https://docs.whalesync.com/features/filters.md): Set filters on a table mapping to control which records sync. Change filters later by pausing the sync, and see how case sensitivity and percentages work.
- [Auto-create tables](https://docs.whalesync.com/features/auto-create-tables.md): Auto-create tables and fields in Airtable, Notion, or Google Sheets from a table in your other connected app, like a Webflow Blog Posts collection.
- [Additional features](https://docs.whalesync.com/features/additional-features.md): Whalesync features beyond core two-way sync, including automapping, reference fields, HTML and Markdown fields, delete protection, and sync webhooks.
- [Automapping](https://docs.whalesync.com/features/additional-features/automapping.md): Whalesync automaps fields with exactly the same name in both apps and suggests table mappings when table names match. You can still map fields by hand.
- [Creating users via Whalesync](https://docs.whalesync.com/features/additional-features/creating-users-via-whalesync.md): Create Memberstack members through a sync from Airtable or another app. Covers write-once email fields and why these tables default to a 10-second sync delay.
- [Delete approval queue](https://docs.whalesync.com/features/additional-features/delete-approval-queue.md): Hold deletes in a Pending deletes queue so you can approve or ignore them before Whalesync syncs them to your destination, or auto-approve all deletes.
- [Delete protection](https://docs.whalesync.com/features/additional-features/delete-protection.md): Turn on Delete Protection in a table's Advanced settings to stop Whalesync from deleting records there while every other change keeps syncing two-way.
- [File hosting](https://docs.whalesync.com/features/additional-features/file-hosting.md): Whalesync temporarily hosts the files and attachments it syncs. Hosted files are capped at 20 MB, and image formats like WebP are not converted for you.
- [HTML and Markdown field extensions](https://docs.whalesync.com/features/additional-features/html-and-markdown-field-extensions.md): Add _html or _md to an Airtable or Postgres field name to sync HTML or Markdown into a rich text field like Webflow's. Google Sheets supports only _html.
- [Reference fields](https://docs.whalesync.com/features/additional-features/reference-fields.md): Sync reference fields like Airtable linked records, Notion relations, HubSpot associations, and Webflow references, plus best practices for using them.
- [References to records outside the sync](https://docs.whalesync.com/features/additional-features/references-to-records-outside-the-sync.md): What happens when a reference field points to a record that isn't part of the sync, such as one filtered out of a synced view, and how to set up foreign keys.
- [Sync preview](https://docs.whalesync.com/features/additional-features/sync-preview.md): Sync Preview shows the changes Whalesync will make in an initial sync, which runs when you set up a sync, add a table mapping, or change filters.
- [Delay before syncing](https://docs.whalesync.com/features/additional-features/delay-before-syncing.md): Set Delay Before Syncing (0-300 seconds) in a table's Advanced settings to combine rapid edits to a record into one sync operation and cut extra updates.
- [Selective row-level sync](https://docs.whalesync.com/features/additional-features/selective-sync.md): Pause syncing for individual records with a checkbox or boolean control field, using the Selective row-level sync setting in a table's Advanced settings.
- [Sync frequency](https://docs.whalesync.com/features/additional-features/sync-frequency.md): Control how often Whalesync scans each connection for changes. Turn off real-time webhooks and set an interval or cron schedule to cut API calls.
- [Sync webhooks](https://docs.whalesync.com/features/additional-features/sync-webhooks.md): Get an HTTP POST to your endpoint each time Whalesync creates, updates, or deletes a record, with the payload format, signature verification, and retries.

## Live Export

- [Live Export](https://docs.whalesync.com/live-export/live-export.md): Live Export keeps a read-only copy of your data in Airtable, Notion, or Supabase, refreshed on demand or on a schedule, and creates the tables for you.
- [Live Export vs. sync](https://docs.whalesync.com/live-export/live-export/live-export-vs-sync.md): When to use Live Export and when to use a standard Whalesync sync. Compare direction, editing, update timing, destination tables, and supported apps.
- [Using Supabase or Postgres views as a source](https://docs.whalesync.com/live-export/live-export/postgres-views.md): Using a Supabase or Postgres view as a Live Export source? Choose an ID column that is unique and never empty, since views have no primary key.

## API

- [MCP server](https://docs.whalesync.com/api/mcp.md): Remote MCP server that lets AI agents create, configure, and monitor Whalesync syncs and Live Exports. Browser sign-in, no API keys.
- [Client setup](https://docs.whalesync.com/api/mcp/setup.md): Add the Whalesync MCP server to Claude, Claude Code, ChatGPT, Codex, Cursor, VS Code, or any other MCP client.
- [Agent quickstart](https://docs.whalesync.com/api/agent-quickstart.md): Guide for AI agents building syncs and Live Exports with the Whalesync API: get a key, relay human steps, write mappings, and monitor the result.
- [API reference](https://docs.whalesync.com/api/reference.md): Whalesync API base URL, authentication, pagination, and endpoints for syncs, mappings, schema, records, and monitoring. Live Export has its own page.
- [Live Export API reference](https://docs.whalesync.com/api/live-export.md): Whalesync API reference for Live Export: create exports, map source tables, save, schedule, trigger runs, and monitor them.
- [Error reference](https://docs.whalesync.com/api/errors.md): Every error code the Whalesync API returns, with its HTTP status, error type, and how to handle it, plus the issue codes returned when validating mappings.

## Resources

- [Support](https://docs.whalesync.com/resources/support.md): Email support@whalesync.com or chat with us in Intercom (Operator plans and above), and find guides to common errors, sync behavior, and your account.
- [Sync behavior questions](https://docs.whalesync.com/resources/support/sync-behavior-questions.md): What happens when you add, remove, or re-add a field mapping on an existing sync, and how to keep records paired when you rebuild or recreate a sync.
- [Common errors - Airtable](https://docs.whalesync.com/resources/support/common-errors-airtable.md): Fix Airtable errors in Whalesync, including maximum access authorizations, duplicate slug values, Airtable synced tables, and invalid user permissions.
- [The sharing link for this base is too large](https://docs.whalesync.com/resources/support/sharing-link-for-this-base-is-too-large.md): What to do when saving an Airtable connection fails with "The sharing link for this base is too large." Move the first table so another table comes first.
- [Common errors - Notion](https://docs.whalesync.com/resources/support/common-errors-notion.md): Fix Notion errors in Whalesync: no databases shared via the integration token, no page authorized for auto-created tables, and Notion's field option limit.
- [Common errors - Postgres](https://docs.whalesync.com/resources/support/common-errors-postgres.md): Fix SSL and self-signed certificate errors when connecting Postgres to Whalesync by adding sslmode=no-verify to your connection string.
- [Common errors - Webflow](https://docs.whalesync.com/resources/support/common-errors-webflow.md): Fix Webflow errors in Whalesync, including name and slug ValidationErrors, duplicate slugs, InconsistentPublicationsError, and unpublished CMS changes.
- [Reconnecting a sync](https://docs.whalesync.com/resources/support/reconnecting-a-sync.md): Fix a Broken connection in Whalesync by reconnecting the app from the sync's Settings tab, plus common causes and what to try if reconnecting doesn't work.
- [FAQ](https://docs.whalesync.com/resources/support/faq.md): Answers to common Whalesync questions: how it differs from Zapier, how records are counted, what data Whalesync stores, and pausing your subscription.
- [How record limits work](https://docs.whalesync.com/resources/support/how-record-limits-work.md): How Whalesync counts records against your record limit, how to manage your usage, and what happens if you go over.
- [Field compatibility](https://docs.whalesync.com/resources/support/field-compatibility.md): Which field types can sync to each other in Whalesync, with a compatibility table for text, URL, number, currency, checkbox, date, JSON, and relation.
- [How to get record IDs](https://docs.whalesync.com/resources/support/how-to-get-record-ids.md): Find a record's ID in Airtable, Webflow, Postgres, and Notion, and map each app's built-in Record ID field to a text field on the other side of a sync.
- [How to change your sign-in](https://docs.whalesync.com/resources/support/how-to-change-your-sign-in.md): Switch your Whalesync login from Google sign-in to email and password by setting a password under Settings > Security, then confirming it and saving.
- [How to change your email](https://docs.whalesync.com/resources/support/how-to-change-your-email.md): Change your Whalesync account email in Settings: add and verify a new address, set it as your primary email, then optionally remove the old one.
- [How to add additional email addresses](https://docs.whalesync.com/resources/support/how-to-add-additional-email-addresses.md): Add another email address to your Whalesync account from Settings so you can sign in with it, and confirm it with the verification code we send.
- [How to delete your account](https://docs.whalesync.com/resources/support/how-to-delete-your-account.md): Delete your Whalesync account in Settings after canceling any renewing plan. Data is permanently deleted 30 days later; you can cancel before then.
- [How to update your tax ID number](https://docs.whalesync.com/resources/support/how-to-update-your-tax-id-number.md): Add or update your business tax ID number, such as a VAT ID, from the Manage subscription page in the Whalesync billing portal.
- [How to create a slug field in Airtable](https://docs.whalesync.com/resources/support/how-to-create-a-slug-field-in-airtable.md): Create a unique slug field in Airtable for Webflow and other CMS syncs, typed by hand or generated with a recommended formula. Includes a Notion version.
- [Known issues](https://docs.whalesync.com/resources/support/known-issues.md): 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.
- [Multi-select to multi-reference](https://docs.whalesync.com/resources/support/multi-select-to-multi-reference.md): Video walkthrough for turning an Airtable multi-select field into a multi-reference field, so those values can sync to a Webflow multi-reference field.
- [Transfer Webflow site to another account](https://docs.whalesync.com/resources/support/transfer-webflow-site-to-another-account.md): Keep your Whalesync sync running after moving your Webflow site to another Webflow account by reauthorizing Webflow in Sync Settings and retrying the sync.
- [Troubleshooting attachment fields](https://docs.whalesync.com/resources/support/troubleshooting-attachment-fields.md): Fix Airtable images that don't sync to Webflow and show no issue: check for images over 4MB, duplicate the record to test, and isolate problem images.
- [Webflow deprecating v1 APIs](https://docs.whalesync.com/resources/support/webflow-deprecating-v1-apis.md): Webflow deprecated its v1 API on March 31, 2025. Reauthorize Webflow in any older sync whose connection says Expiring soon to move it to the v2 API.
- [Allowlisting Whalesync IP addresses](https://docs.whalesync.com/resources/support/allowlist-ip.md): Allowlist Whalesync's static outbound IP, 34.66.3.22, in your AWS or GCP security group, Supabase network restrictions, or on-premise firewall.