CommunityHire an ExpertSign Up
Data SourcesGoogle Sheets
Data Sources

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. Google Sheets is available on all plans, including Free.

1. Connecting your Google Sheets account

To start using Google Sheets in Softr, you must first connect your account.

  • Open the Integrations page in the Studio sidebar.

  • Click Connect new.

The Integrations page with the Connect new button

  • Select Google Sheets. The Connect to Google Sheets window opens.

  • Click Connect, then log in to your Google account.

  • Check all required permission boxes.

The Connect to Google Sheets window with the Connect button highlighted

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.

Connect your data to a dynamic block

To display your data in the app, connect a dynamic block to your Google Sheet.

  1. Go to the block Source tab and select your Google Sheets account.

  2. Select the Document you want to connect.

  3. Select the Sheet you want to use.

    The Source tab of a List block, with Document set to Help Desk by Softr and Sheet set to Teammates

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.

    Google Sheets sheet with the columns Assignee, Email, Description, Project and Status

    Field names and values on Google Sheets

When you connect a block to a sheet, you can choose which sheet columns to display and map each one to a Softr field. In the block’s Content tab, click an item field, such as Photo, to change how it displays. An image field needs a column that holds image URLs.

The Content tab of a List block, with the Photo item field set to the Image display type

Mapping an image column to an Image field

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).

Google Sheets with the Softr Record ID column in column F

The Record ID column created inside the sheet

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. See below for supported formats:

    Supported Date and Time Formats

    Date patterns with month as whole or 3 letter (August, Aug) - Currently only English language is supported.

    MMMM d, yyyy
    MMMM dd, yyyy
    yyyy MMM d
    yyyy MMM dd
    dd-MMM-yyy

    Date patterns with month as numberSupported separators: -, /, ., space

    yyyy MM dd
    yyyy MM d
    yyyy M dd
    yyyy M d
    MM dd yyyy
    MM d yyyy
    M dd yyyy
    M d yyyy
    dd yyyy MM
    d yyyy MM
    dd yyyy M
    d yyyy M

    Date timeDate part is same (both formats), times

    hh:mm a
    hh:mma
    hh:mm:ss a
    hh:mm:ssa
    hh:mm:ss.SSS a
    hh:mm:ss.SSSa
    h:mm a
    h:mma
    h:mm:ss a
    h:mm:ssa
    h:mm:ss.SSS a
    h:mm:ss.SSSa
    HH:mm
    HH:mm:ss
    HH:mm:ss.SSS
    H:mm
    H:mm:ss
    H:mm:ss.SSS
    HH:mmZ
    HH:mm:ssZ
    HH:mm:ss.SSSZ
    H:mmZ
    H:mm:ssZ
    H:mm:ss.SSSZ

    Here are few samples for time

    01:24:41 AM
    01:24:41AM
    23:24:41
    01:24 AM
    01:24AM
    16:24
    01:24:41Z
    01:24:41+03:00

    Date and time combined isDate formatTTime format  like

    1994-11-05T08:15:30-05:00
    1994-11-05T13:15:30Z
  • Checkbox: Use “true” (checked) or “false” (unchecked).

  • Image, File, Video/Audio: Store file URLs. If storing multiple image URLs in the same cell, separate them with a comma

  • 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.

Use these docs with your AI tools

An AI agent can read this documentation directly. You do not need an account or an API key. Everything here is public and read-only.

Query these docs via MCP

Recommended

Add this server to Claude, Claude Code, Cursor, Mistral, or any tool that supports MCP. Your agent can then search Softr Documentation documentation and read it in full, instead of answering from memory.

https://docs.softr.io/mcp
  • searchFind the passages that answer a question.
  • fetchRead one page in full, as Markdown.
  • list_pagesSee every page in this documentation.

Query these docs over HTTP

The same tools also work as plain web requests. Use this for scripts, or for any tool that does not support MCP. There is one endpoint per tool. Arguments go in the query string, and the answer comes back as JSON.

https://docs.softr.io/api/docs/search?query=custom+domain

Read the OpenAPI description. It is built from the same definitions as the tools, so it always matches what the endpoints do.

Read these docs as Markdown

Add .md to any page URL to get its Markdown source. You can also send the headerAccept: text/markdown to the page URL itself.

To read the whole documentation in one file, open llms-full.txt. For a short index of every page, open llms.txt.