Connect your Airtable account to import table data into Atlas. Browse all bases and tables you have access to and sync data automatically when changes occur.
Connect to Airtable
- Click Add data in the Layers panel
- Go to the Connections tab
- Select Airtable
- Click Connect with Airtable
- Sign in to your Airtable account and authorize Atlas
After authorization, Atlas creates a connection to your Airtable account.
Working with Data
Once connected, Atlas fetches all bases your token can access and displays them as a selectable list. Pick a base, then choose a table to import as a dataset. Atlas preserves field types including dates, attachments, and linked records.
Supported Field Types
| Airtable Type | Atlas Type |
|---|---|
| Single line | Text |
| Long text | Text |
| Number | Number |
| Currency | Number |
| Percent | Number |
| Date | Date |
| Checkbox | Boolean |
| Single select | Single Select |
| Multiple select | Multi Select |
| Link to record | Text |
| Attachment | Attachment |
Sync Settings
Connected tables sync automatically. Atlas detects changes and updates your data when the source changes. Configure sync intervals in Layer Settings.
Smart Sync (merge on key)
By default, each sync replaces all rows in the dataset. Smart Sync instead merges incoming rows onto a unique key column, so manual edits, geocoding, and geometry you have added in Atlas are preserved between syncs.
To enable Smart Sync when importing a table:
- In the import dialog, open Data sync settings.
- Select a Unique key column — the column whose values identify each row.
- Complete the import. Future syncs will merge rows on that key rather than replacing the dataset.
Rows deleted in Airtable are removed from the map on the next sync. Rows that no longer geocode are skipped with a warning rather than failing the sync.
Note: If your Airtable table has more than 500,000 rows, syncs may be treated as partial snapshots and will not delete rows — only add or update them. This protects against accidental data loss if the fetch is cut off.
Troubleshooting
| Issue | Solution |
|---|---|
| Authorization Failed | Ensure you're signing in with the correct Airtable account. |
| Base Not Found | Check that the base still exists and you have access to it. |
| Sync Failed | Verify your Airtable authorization is still valid. Re-authorize if needed. |
| No Tables Listed | Confirm your account has bases with tables. Check access permissions. |