Airtable
Using Airtable as a data source for your Softr app.
Airtable is a powerful tool that combines the flexibility of spreadsheets with the power of a database. It allows you to store and organize different types of data, making it a great choice for managing data in your Softr app.
With Airtable, you can:
- Store text, images, checkboxes, and more
- Create custom views to filter and sort your data
- Control who can view or edit information
- Use ready-made templates to speed up setup
- Integrate with third-party tools
In this article, weโll walk you through connecting your Airtable account to Softr and displaying your Airtable data in your app. For a quick overview, check out our video walkthrough. ๐
1. Connect your Airtable account
To use Airtable in Softr, you must first link your Airtable account. Hereโs how:
Step 1: Add an Airtable data source to your workspace
In your Softr Dashboard, navigate to Data Sources in the left menu and click Connect Data Source. Select Airtable and proceed to authenticate your account.

Step 2: Grant access to the Airtable bases you want to use in your workspace.
Select all the bases you want to access in Softr and click Authorize.
When granting access, we strongly recommend choosing โAll current and future bases in all current and future workspaces.โ
If you donโt, youโll need to manually reselect bases every time you reconnect, which could break your apps.

2. Connect your Airtable Base to the Softr app
Once your Airtable account is connected, you can use the authorized bases across one or multiple Softr applications.
Step 1: Connect your data to a dynamic block
To display your data in the app, connect a dynamic block (e.g. List, Grid, Table) to your Airtable base:
- Go to the Block source tab and select your Airtable integration.
- Pick the base you want to use.
- Choose the table with the records you want to show.
ย Important: Each Airtable table can only connect to one Softr block. For example, if you want to display Projects in a List block, youโll need to map it to the Projects table in your base. If you also want to show Tasks, youโll need to add a separate block and connect it to the Tasks table.
.png?table=block&id=1ac9a723-d691-806f-ab8d-fbcb4dd87a2c&cache=v2)
Tip: You can also select an Airtable View to display. If a view is selected, any filters and sorting applied in Airtable will be preserved for the records shown in the Softr block (e.g., showing only completed tasks).
Step 2: Map Airtable columns to item fields
When you connect your table to a block, you can choose which Airtable columns to display and map it to a Softr field. This lets you control how your Airtable data appears in Softr.
Example: If your Airtable base has a Profile Picture (Attachment field), map it to an Image field in Softr so it displays correctly.


Airtable fields work like spreadsheet columns, but each has a specific type (e.g., text, image, checkbox). To keep everything working smoothly, make sure to match field types correctly when setting up the connection.
3. Supported field types
Softr handles Airtable field types in three ways:
- Fully supported โ You can read and update these fields.
- Read-only โ You can see the data, but you canโt edit it.
- Not supported โ These fields wonโt sync with Softr.
Fully supported Airtable field types
- Text โ Single line, long text, and rich text
- Number โ Standard numbers, currency, and percentages
- Date & Time โ Date, date-time, and duration fields
- Attachments โ Images, multiple attachments, and files
- Checkbox โ Yes/No options
- Linked Records โ Connects one table to another
- Single & Multi-Select โ Dropdown lists
- Email & Phone โ Email addresses and phone numbers
- Rating โ Star or point-based ratings
- URL โ Website links
- User Fields โ Created by, last modified by, and collaborator fields
Fields that can be shown but not edited
Some fields are read-only in Softr because Airtable automatically generates them:
- Formula Fields โ Calculated values
- Rollup, Count, and Lookup Fields โ Pull data from other tables
- Created By & Created Date โ Who and when a record was created
- Last Modified By & Last Modified Date โ Who and when a record was updated
- Autonumber Fields โ Automatically assigned numbers
Not supported fields
These fields are not supported due to Airtable API limitations:
- Button Fields โ Trigger actions but donโt store data
- Barcode Fields โ Store scanned barcode data
- Sync Source โ Data synced from external sources
FAQs
What if I canโt see my Airtable bases in Softr?
Check that youโve granted Softr access to all current and future bases in Airtable. If not, go back to Data Sources and re-authenticate.
Why arenโt my mapped fields showing?
If some fields arenโt displaying data even though they are mapped correctly, check if their titles in Airtable contain any special characters. Removing special characters can help resolve the issue.
Why is my data not updating in Softr?
Try refreshing Softr or reloading your data source. If the issue persists, check if your Airtable permissions are correctly set.
Can I use multiple Airtable bases in one Softr app?
Yes! You can connect multiple Airtable bases to the same app, but you have to use a separate Dynamic Block for each table.
How can I improve my app's performance?
Using a Personal Access Token (PAT) instead of OAuth (default connection) can improve performance. PATs provide a more direct connection, reducing load times and making your Softr application run faster. In addition to improved performance, PATs allow you to limit what Softr can access, adding an extra layer of security. We recommend enabling all scopes to ensure everything works smoothly.
If you have already authenticated your Airtable account, click "Switch to personal access token" below the data source name and paste your Airtable PAT.

Follow this Airtable guide to generate a PAT.
Need more help?
- โถ๏ธย Watch a tutorial on how to structure your Airtable database for Client Portal
- ๐ Learn more in our Airtable Learning Hub
- ๐ Troubleshooting? Check out Troubleshooting Airtable errors
Last updated on March 3, 2025