> ## Documentation Index
> Fetch the complete documentation index at: https://docs.softr.io/llms.txt
> Use this file to discover all available pages before exploring further.

# SmartSuite

> Using SmartSuite as a data source for your Softr app.

SmartSuite is a spreadsheet-based database and work management system that can also function as a relational database.

This integration allows you to:

* Connect your SmartSuite data to Softr effortlessly

* Display and manage SmartSuite records within your Softr apps

* Utilize relational data for enhanced workflows

<Info>Smartsuite is available on **Professional** and higher plans.</Info>

<iframe src="https://www.youtube.com/embed/MTUHApAIzeE?rel=0" width="100%" height="500px" title="YouTube video" />

## **1. Connect your SmartSuite account**

To use SmartSuite in Softr, you must first **connect your SmartSuite account**. Any SmartSuite data source you add to Softr can be used across all apps within your Softr workspace.

<Steps>
  <Step title="Add SmartSuite as a data source in Softr">
    1. Open [**Softr’s Data Sources**](https://studio.softr.io/dashboard/data-sources) settings.

    2. Click **Connect data source**.

    3. Select **SmartSuite** from the list.

    4. Log in to your **SmartSuite** account (if not already).

    5. Authorize Softr to access your SmartSuite data.

    Once connected, your SmartSuite data will be available to use in Softr.

    <Frame>
      <img src="https://mintcdn.com/softr-2b8a27e1/8k0pouYNy4US7Xu9/data-sources/images/smartsuite-/image1.png?fit=max&auto=format&n=8k0pouYNy4US7Xu9&q=85&s=8b5def9f42cc16cfad1554ecd931aaa1" alt="Notion image" width="3024" height="1318" data-path="data-sources/images/smartsuite-/image1.png" />
    </Frame>
  </Step>
</Steps>

## **2. Connect your SmartSuite data to your Softr app**

After connecting SmartSuite, you can use its data in any Softr app.

<Steps>
  <Step title="Connect your data to a dynamic block">
    To display your data in the app, connect a [dynamic block](/core-concepts-overview/c5VwEbsWtTfPyUZjmEKvfx/visualize-data-with-building-blocks/41p6U2eZs7zgY8zWmFV4eH#1859a723d691803d9551ecd7b3b0c043) (e.g., [List](/building-blocks/vikC2AWEpQGkZd4jGyoVxo/list-block/pQhPYuA28VXr5tLLFBcbCU), [Grid](/building-blocks/vikC2AWEpQGkZd4jGyoVxo/grid-block/42JZoeYwMsogZcveqh74QH), [Table](/building-blocks/vikC2AWEpQGkZd4jGyoVxo/table-block-/j7rGwu7J7zuU69h3bZ7HFe)) to your SmartSuite table:

    1. Go to the Block **source** **tab** and select your SmartSuite integration.

    2. Select the **workspace** and **solution** you want to connect.

    3. Pick the **table** you want to use.

    <Warning>
      **Important**: Each **block can connect to only one SmartSuite table**. If you need to display data from multiple tables, use separate blocks.
    </Warning>

    <Frame>
      <img src="https://mintcdn.com/softr-2b8a27e1/8k0pouYNy4US7Xu9/data-sources/images/smartsuite-/image2.png?fit=max&auto=format&n=8k0pouYNy4US7Xu9&q=85&s=f2ad0053269ae119d9eb321fd194c268" alt="Notion image" width="2866" height="1454" data-path="data-sources/images/smartsuite-/image2.png" />
    </Frame>
  </Step>

  <Step title="Map SmartSuite fields to item fields in softr">
    Each SmartSuite table has multiple fields (columns) with predefined types (e.g., File, Yes/No, Formula). Connecting your table to a block lets you choose which SmartSuite **fields** to display and map it to a Softr field. This lets you control how your Smartusuite data appears in Softr.

    **Example:** If your SmartSuite table has a **Photos (Files & Images field)**, map it to an **Image field** in Softr to display it correctly.

    <Frame caption="SmartSuite fields">
      <img src="https://mintcdn.com/softr-2b8a27e1/8k0pouYNy4US7Xu9/data-sources/images/smartsuite-/image3.png?fit=max&auto=format&n=8k0pouYNy4US7Xu9&q=85&s=b136395a2549493edde8dbc9634579d6" alt="SmartSuite fields" width="3022" height="662" data-path="data-sources/images/smartsuite-/image3.png" />
    </Frame>

    <Frame caption="Mapping an image field">
      <img src="https://mintcdn.com/softr-2b8a27e1/8k0pouYNy4US7Xu9/data-sources/images/smartsuite-/image4.png?fit=max&auto=format&n=8k0pouYNy4US7Xu9&q=85&s=7d787be4bf09d19f31ca05184009d2b8" alt="Mapping an image field" width="2626" height="824" data-path="data-sources/images/smartsuite-/image4.png" />
    </Frame>

    <Info>
      Learn more about Softr field types in the [List Block Overview](/building-blocks/vikC2AWEpQGkZd4jGyoVxo/list-block/pQhPYuA28VXr5tLLFBcbCU).
    </Info>
  </Step>
</Steps>

### **Supported Fields**

Most editable SmartSuite fields can be modified in Softr, but some computed fields are **read-only**, including:

* **Formula fields**

* **Rollup fields**

* **Lookup fields**

### **Linked Records**

One of SmartSuite’s key features is **Linked Records**, which allows you to create relationships between tables. This makes SmartSuite a **relational database**.

For example, if you have two SmartSuite tables:

* **Tasks**

* **Projects**

You can link the **Tasks table** to the **Projects table** to show which project each task belongs to.

Below, you can see the **Tasks table**, where the **Project field** is a linked record showing data from the **Projects table**.

<Frame caption="SmartSuite table with projects">
  <img src="https://mintcdn.com/softr-2b8a27e1/8k0pouYNy4US7Xu9/data-sources/images/smartsuite-/image5.png?fit=max&auto=format&n=8k0pouYNy4US7Xu9&q=85&s=212975978c86d6226327e7595354259e" alt="SmartSuite table with projects" width="3024" height="1186" data-path="data-sources/images/smartsuite-/image5.png" />
</Frame>

<Frame caption="Project linked records">
  <img src="https://mintcdn.com/softr-2b8a27e1/8k0pouYNy4US7Xu9/data-sources/images/smartsuite-/image6.png?fit=max&auto=format&n=8k0pouYNy4US7Xu9&q=85&s=2975704efe1a3ca94d2dff4c9e0c6a8f" alt="Project linked records" width="2698" height="1292" data-path="data-sources/images/smartsuite-/image6.png" />
</Frame>
