Google Sheets
Using Google Sheets as a data source for your Softr app.
Google Sheets is a cloud-based spreadsheet solution used by millions worldwide. While it may not be as powerful as Airtable in terms of data management, it is a popular and free tool that many users already rely on. In this guide, we'll walk you through connecting Google Sheets as a data source for your Softr app and discuss some of its advantages and limitations.
1. Connecting your Google Sheets account
To start using Google Sheets in Softr, you must first connect your account.
- Open Softr’s Data Sources settings.
- Click the Connect data source.
- Select Google Sheets and log in to your account.
- Check all required permission boxes.
2. Connect your Google Sheet data to your Softr app
Once your Google Sheets account is connected, you can use it in any Softr application.
Step 1: Connect your data to a dynamic block
To display your data in the app, connect a dynamic block to your Google Sheet.
- Go to the Block Source tab and select your GSheet integration.
- Select the document you want to connect.
- Pick the sheet you want to use.
Step 2. Mapping Google Sheets columns to Softr field
Google Sheets stores data in a table format, where each column represents a field, and each row is a record. To ensure smooth integration, structure your sheet with:
- The first row as field names (e.g., "Assignee," "Status," "Description").
- Data stored in rows under the appropriate column headers.
When you connect your board to a block, you can choose which Sheet columns to display and map it to a Softr field. This lets you control how your GSheet data appears in Softr.
Record ID Column
Once you connect a sheet to Softr, a Softr Record ID column is automatically added. This unique ID helps Softr reference records (e.g., linking a List block to a List Details block).
Ensure you have edit permissions for your Google Sheet so Softr can add and update this column. Do not delete it.
Tip: Use Softr Record IDs to link related records across sheets (e.g., setting a "Manager ID" as another user's Softr ID).
Supported Field Types in Softr
Google Sheets doesn’t have built-in field types like Airtable, but you can organize data to match Softr’s supported formats.
Supported Field Types & Workarounds
- Text – Standard text fields.
- Number – Whole numbers, decimals, currency.
- Date & Time – Standard date formats.
- Checkbox – Use "true" (checked) or "false" (unchecked).
- Image, File, Video/Audio – Store file URLs.
- Tag Field – Separate multiple values with commas.
- Rating – Use integer values from 1 to 5.
- File Uploads: Google Sheets doesn’t support direct file uploads. Use URLs instead.
Last updated on March 3, 2025