Teable Integration

Connect your Teable bases to create beautiful, embeddable widgets. Teable is an open-source Airtable alternative built on Postgres — use Teable Cloud or your own self-hosted instance.

Connecting Teable

Click Connect Teable

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

Enter your details

You’ll need two things:

Instance URL — The URL of your Teable instance (e.g., https://app.teable.io for Teable Cloud, or your self-hosted URL)
Personal Access Token — Your Teable API token

Your access token is stored securely and is only used to read data from your Teable instance.

Choose your setup method

You have two options:

Start Fresh — Create a new base with sample data in your space. Perfect for trying out templates.
Use existing data — Connect to a base and table you’ve already set up in Teable.

Select your data

If using existing data:

Select a Base
Select a Table
Select a View (optional)

Done!

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

Finding your Personal Access Token

Log in to your Teable instance
Click your avatar in the bottom-left corner
Go to Settings
Navigate to Personal Access Tokens
Click Create new token, give it a name, and copy the token

Keep your access token private. Never share it publicly or commit it to version control.

Self-Hosted Instances

Teable supports self-hosting. When connecting a self-hosted instance:

Enter your instance URL (e.g., https://teable.yourcompany.com)
Make sure your instance is accessible from the internet (Shareables needs to reach it to fetch data)
The rest of the setup is the same as Teable Cloud

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 base in your selected space
Add a table with 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 Connections

You can add multiple Teable connections (different instances or tokens):

Switch connections — Use the dropdown to select a different connected account
Add new connection — Click “Connect new account” to add another token

How Data Refreshes

Your published widget uses smart caching to balance performance with data freshness. You can choose between On widget load (default) or Real-time refresh modes.

For full details on how caching works and how to configure refresh modes, see Data Refresh.

Troubleshooting

Invalid access token

Double-check that you’ve copied the full Personal Access Token from your Teable settings. Make sure there are no extra spaces before or after the token.

Connection failed (self-hosted)

Make sure your Teable instance is reachable from the internet. If it’s behind a firewall or VPN, Shareables won’t be able to connect. Check that the instance URL is correct and includes https://.

No bases found

Make sure your access token has access to at least one space with bases. If you recently created your Teable account, try creating a base first.

Table or view not appearing

Check that your base contains tables. If you just created a new base, you may need to add a table in Teable before it appears.

Failed to fetch data

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