Guessing burns time. If you use Integration for Airtable, open Airtable Sync → Sync Logs first and fix from the error text outward.
Fast triage checklist
If the builder has no entry, the problem is validation or the form itself, not Airtable.
No row means the connection never ran. A row means you can read success, warning, or error.
Use the exact text. Auth, field type, and missing required values show up here.
Map a single checkbox to an Airtable checkbox (true/false). Map multi-option checkboxes to a Multiple select column. A plain text “yes” belongs in a text column.
Check personal access token scopes, or reconnect OAuth if access was revoked.
No row in Sync History
| Likely cause | What to do |
|---|---|
| Connection inactive or the wrong form | Re-open the form connection and confirm the exact form name |
| Builder not supported or not active | Confirm WPForms, Gravity Forms, Contact Form 7, Ninja Forms, Fluent Forms, Formidable, or Elementor Pro Forms |
| Cache or optimization blocking hooks | Retest with cache bypass. Exclude form endpoints if you need to |
| Free plan connection limit | Free allows one form connection. Disable extras or upgrade |
History shows an error
Authentication and permissions
- Regenerate a personal access token with scopes that allow reading bases and writing records to the target base.
- Reconnect OAuth if the connection was revoked.
- Confirm the token can see the same base and table you mapped. Workspace permissions are a common miss.
Field type mismatches
| Form value | Column that often fails | Safer mapping |
|---|---|---|
| Free text “yes” | Checkbox | Single select, or convert on purpose |
| Multi-value checklist | Single select | Multi-select or long text |
| Locale-formatted date | Date | An ISO-friendly date field |
| Empty string | Number or required field | Make the Airtable field optional, or send a default |
| File upload | Attachment | Pro attachment mapping, or a URL field as an interim |
Table and view confusion
You don’t submit into a view. You write records, and views filter them afterward. If a view only shows Status = Qualified, the new row can exist and still be hidden from the screen you’re watching.
History shows success, and you still don’t see it
- Wrong base or table, often a duplicate staging base
- Personal workspace instead of the shared one
- Interface or view filters
- Sorted to old records: sort by created time
Delayed sync and intermittent gaps
Background delivery depends on WP-Cron, which on low-traffic sites often waits for a visitor.
- Submit a test, then trigger cron, visit the site, or run real cron.
- Check a host setting that disables WP-Cron without a system cron to replace it.
- For critical lead forms, prefer immediate delivery when it is available.
Builder-specific gotchas
Test a completed submission, not an abandoned Save & Continue draft.
Validation failures never fire downstream sync. Fix mail and validation first.
Use the Pro Form widget path the connector supports.
Each form submission creates a new Airtable record. Empty conditional fields stay blank on that new row.
A single checkbox maps as true or false. Multi-option selections map to an Airtable Multiple select column.
Duplicates in Airtable
Form sync typically creates a record per submission. Duplicates usually mean the form fired twice, a thank-you or webhook doubled, or an automation retried. Check whether the form itself submitted twice. Don’t CSV-import the same day you also sync live.
Still stuck
Include the form plugin name and version, the Integration for Airtable version, the Sync History error with tokens removed, and the Airtable field types. Email support@ripplestep.com.
Related reading
Fix from the latest test
Open Sync History on the last submission. Correct auth or the field type from the error line, then send one more test.
Install Integration for Airtable free