Airtable Integration

Connect your Airtable bases to create powerful, embeddable widgets.

Connecting Airtable

Click Connect Airtable

From the connection modal, click Connect Airtable. If you’ve connected before, you can select a previous account from the dropdown.

Authorize with Airtable

You’ll be redirected to Airtable’s authorization page. Sign in and grant Shareables access to your workspace.

Choose your setup method

You have two options:

Start Fresh - Create a new table with sample data in one of your bases. Perfect for trying out templates.
Use existing data - Connect to a table you’ve already set up in Airtable.

Select your data

If using existing data:

Select an Airtable Base
Select a Table
Select a View

Done!

Your Airtable data is now connected and ready to display in your widget.

Views in Airtable control which records and fields are visible. Choose a view that shows exactly the data you want in your widget.

Start Fresh vs Use Existing Data

Start Fresh

Best for:

Trying out a template quickly
Learning how Shareables works
Creating a demo widget

When you choose “Start Fresh”, we’ll:

Create a new table in your selected base
Add the fields needed for the template
Populate it with sample records you can customise

Use Existing Data

Best for:

Displaying your real data
Connecting to an established workflow
Production widgets

Managing Multiple Accounts

You can connect multiple Airtable accounts:

Switch accounts - Use the dropdown to select a different connected account
Add new account - Click “Connect new account” to add another Airtable account
Reconnect - If your connection expires, click the “Reconnect” badge

How Data Refreshes

Your published widget uses smart caching to balance performance with data freshness.

How it works

When a visitor loads your widget, they see the cached version for fast loading
In the background, a request checks for updated data from your data source
If new data is found, the cache is refreshed
The next visitor (or page refresh) will see the updated data

Cache refresh rate

The cache refreshes at most once per minute, even if multiple visitors are loading your widget. This prevents excessive requests to your data source while ensuring updates appear quickly.

Forcing a refresh

Republishing your widget will immediately clear the cache, so the next visitor sees the latest data.

Troubleshooting

No bases found

Make sure you have at least one base in your Airtable account. Create a base in Airtable first, then try connecting again.

Table or view not appearing

Check that your Airtable account has access to the base. If you’re part of a workspace, ensure you have the correct permissions.

Connection expired

Airtable tokens expire periodically. If you see a “Reconnect” badge, click it to re-authorize your account.

Failed to fetch data

Check your internet connection and try again. If the issue persists, get in touch.