Show Airtable records in a widget
Connect an Airtable base so your widget shows its records, like a menu, a price list or a team directory, and updates when the table changes.
Connect Airtable when you keep information in an Airtable table, like a menu, a price list or a list of events, and want your widget to show it. When you change a record in Airtable, the widget shows the change the next time the page loads.
The connection only reads from Airtable. Your widget can't add or change records.
Before you start
You need an Airtable personal access token, plus the IDs of the base and table you want to show.
- In Airtable, go to Builder hub, then Personal access tokens, and click Create token. You can also go straight to airtable.com/create/tokens.
- Give the token a name, like "Embeddable".
- Under Scopes, add data.records:read.
- Under Access, add the base your widget should read.
- Create the token and copy it. Airtable shows it only once, so keep it somewhere safe.
- Open your table in Airtable and look at the page address. The base ID is the part that starts with
app, and the table ID is the part that starts withtbl.
Connect it
- Open your widget in the editor.
- In the AI chat, ask for it, for example "Show the records from my Airtable table".
- A connection card for Airtable appears in the chat. Paste your token into the Airtable personal access token field and click Save.
The card shows Connected. For the general steps, see Connect an app to your widget.
Choose the base and table
The card saves your token, but the widget also needs to know which table to read.
- In the editor, click More, then Connect apps.
- Find Airtable and click Edit.
- Open Fetch dynamic data from Airtable. Paste the base ID into Base Id and the table ID into Table Id.
- Click Update.
What happens next
Tell the AI chat what to show and how, for example "Show each record as a card with the Name, Price and Photo columns." Check the preview, then publish your changes.
The widget reads up to 100 records from the table. Column names that say what they hold, like "Question" and "Answer", make it easier for the AI to match them to the right parts of your widget.
Remove it
- On the connection card in the chat, click the trash icon. Or click More, then Connect apps, open Airtable and click Disconnect.
- Your token stays saved in your workspace so you can use it again. To stop all access, delete the token in Airtable under Personal access tokens.
If your records don't show up, email us through the contact page with the widget name.
Did this answer your question?
Your feedback helps us improve.
