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

# ClickUp

> Using ClickUp as a data source within your Softr app

ClickUp is a comprehensive project management and productivity tool that you can use to manage projects, clients, tasks, files, and more. Softr supports all Lists within ClickUp. This allows you to:

* Connect your ClickUp data to Softr for a branded app

* Read, write, update, and delete data in ClickUp from within your Softr app

* Share with external parties or larger groups without sacrificing privacy or paying for each access

<Tip>
  ClickUp as a data source is available on Softr’s **Professional** plan and above.
</Tip>

## Connect ClickUp Data to Softr

<Steps>
  <Step title="Add ClickUp as a data source">
    From your Softr workspace dashboard, click on the Data sources tab on the left menu.

    <Frame caption="Click on the Data sources tab in the left menu">
      <img src="https://mintcdn.com/softr-2b8a27e1/yHSeufze4B6VFRuy/data-sources/images/clickup/image1.png?fit=max&auto=format&n=yHSeufze4B6VFRuy&q=85&s=211814af8d0b3484d97138dce1101c7c" alt="Click on the Data sources tab in the left menu" width="1474" height="927" data-path="data-sources/images/clickup/image1.png" />
    </Frame>

    Click on “Connect to Data source” button in the upper right

    <Frame caption="Click on Connect to Data source in the upper right">
      <img src="https://mintcdn.com/softr-2b8a27e1/yHSeufze4B6VFRuy/data-sources/images/clickup/image2.png?fit=max&auto=format&n=yHSeufze4B6VFRuy&q=85&s=e8df13ed5e098bd02cfaedd279b04b38" alt="Click on Connect to Data source in the upper right" width="1471" height="929" data-path="data-sources/images/clickup/image2.png" />
    </Frame>

    Select ClickUp from the list and click the Continue button in the bottom right:

    <Frame caption="Select Clickup, then click Continue in the bottom right">
      <img src="https://mintcdn.com/softr-2b8a27e1/yHSeufze4B6VFRuy/data-sources/images/clickup/image3.png?fit=max&auto=format&n=yHSeufze4B6VFRuy&q=85&s=01b746e608957f29f4f0cbb972b56f80" alt="Select Clickup, then click Continue in the bottom right" width="1347" height="840" data-path="data-sources/images/clickup/image3.png" />
    </Frame>

    If you’re not logged in to ClickUp, you’ll be prompted to sign in first. Then you’ll see a screen that let’s you choose which Workspaces to connect to Softr. Select any or all of the workspace(s) you want to connect to and click “Connect Workspace(s)”:

    <Frame caption="Click on the workspace you want to connect, then click Connect Workspace">
      <img src="https://mintcdn.com/softr-2b8a27e1/yHSeufze4B6VFRuy/data-sources/images/clickup/image4.png?fit=max&auto=format&n=yHSeufze4B6VFRuy&q=85&s=b5db6142905c935836c013e08e7e514a" alt="Click on the workspace you want to connect, then click Connect Workspace" width="1469" height="928" data-path="data-sources/images/clickup/image4.png" />
    </Frame>

    You will be redirected back to your Softr browser tab and your new ClickUp connection will be available to use in any and all of your Softr apps. If you need to rename, delete or see which apps the data source is being used in, just click the three dots on the data source:

    <Frame caption="Click the three dots to edit, rename, delete, or see all apps the data source is being used in.">
      <img src="https://mintcdn.com/softr-2b8a27e1/yHSeufze4B6VFRuy/data-sources/images/clickup/image5.png?fit=max&auto=format&n=yHSeufze4B6VFRuy&q=85&s=c350422a1760d9a61ffa3f9f0cb0ca11" alt="Click the three dots to edit, rename, delete, or see all apps the data source is being used in." width="1471" height="808" data-path="data-sources/images/clickup/image5.png" />
    </Frame>
  </Step>

  <Step title="Connect a block to your new ClickUp datasource">
    In any of your Softr apps, you can select almost any dynamic block and choose ClickUp as the connected data source for the block. Just select the Data source, the Workspace, Space, and List for the block.

    <Tip>
      You can get any List from Clickup, whether it is in a folder or not. Softr ignores the heirarchy in ClickUp to show all List within a given Space.
    </Tip>

    <Frame caption="Use the settings for the block to connect ClickUp to dynamic blocks.">
      <img src="https://mintcdn.com/softr-2b8a27e1/yHSeufze4B6VFRuy/data-sources/images/clickup/image6.png?fit=max&auto=format&n=yHSeufze4B6VFRuy&q=85&s=4d4f62d1a9082552c99e90de40adce52" alt="Use the settings for the block to connect ClickUp to dynamic blocks." width="1468" height="925" data-path="data-sources/images/clickup/image6.png" />
    </Frame>

    You can tell which blocks support ClickUp as a datasource by hovering over the block you want to add.

    <Frame caption="Hover over a block to see what data sources it supports.">
      <img src="https://mintcdn.com/softr-2b8a27e1/yHSeufze4B6VFRuy/data-sources/images/clickup/image7.png?fit=max&auto=format&n=yHSeufze4B6VFRuy&q=85&s=8a667028e70a309009365a8854109dc2" alt="Hover over a block to see what data sources it supports." width="1057" height="758" data-path="data-sources/images/clickup/image7.png" />
    </Frame>
  </Step>

  <Step title="Map your ClickUp properties to the block elements">
    Click on the block and select the Content tab to edit the fields and map your columns/properties in ClickUp to the visual elements of the block.

    <Frame>
      <img src="https://mintcdn.com/softr-2b8a27e1/yHSeufze4B6VFRuy/data-sources/images/clickup/image8.png?fit=max&auto=format&n=yHSeufze4B6VFRuy&q=85&s=ad8165d9be2455c1e879a3d215492549" alt="Notion image" width="1466" height="926" data-path="data-sources/images/clickup/image8.png" />
    </Frame>

    You can add new fields, delete fields, duplicate fields or even change the styling of individual fields and elements. You can also change the field type if it doesn’t match how you want it to display. Read more about mapping data [here](/building-blocks/vikC2AWEpQGkZd4jGyoVxo/list-block/pQhPYuA28VXr5tLLFBcbCU#content).
  </Step>

  <Step title="Step 4 (optional): Create app users from ClickUp">
    You can sync a list of contacts or people in ClickUp so that they become Users of your Softr app. To learn more about users and how to sync them, check out [this article](/add-and-manage-users/pxnkp9H3qyEVMF6XUceqnj/syncing-users-with-a-data-source/hshRGygHr4T33EnaLntGf9).
  </Step>
</Steps>

## Supported ClickUp Fields

Not all fields are currently supported by Softr, but we’re adding more all the time. Some fields, such as Rollup are not exposed by the ClickUp API and are unretrievable by Softr.

|                              |                    |                   |
| ---------------------------- | ------------------ | ----------------- |
| **Supported**                | **Read-Only**      | **Not Supported** |
| Number                       | Formula            | Rollup            |
| Text                         | People             |                   |
| Long Text                    | Tasks              |                   |
| Dropdown                     | Voting             |                   |
| Date                         | Location           |                   |
| Text area (Long text)        | Users              |                   |
| Money                        | Date created       |                   |
| Website                      | Date updated       |                   |
| Email                        | Creator            |                   |
| Manual Progress              | Assignees          |                   |
| Phone                        | Signature          |                   |
| Relationship                 | Files              |                   |
| Location                     | Automatic Progress |                   |
| Rating                       |                    |                   |
| Translation                  |                    |                   |
| Status                       |                    |                   |
| Start Date                   |                    |                   |
| Due Date                     |                    |                   |
| Points                       |                    |                   |
| Description                  |                    |                   |
| Time Estimate                |                    |                   |
| Action Items                 |                    |                   |
| Summary                      |                    |                   |
| Progress Updates             |                    |                   |
| Custom Autofill with AI      |                    |                   |
| Categorize                   |                    |                   |
| T-Shirt Size                 |                    |                   |
| Sentiment                    |                    |                   |
| Labels                       |                    |                   |
| Name                         |                    |                   |
| Priority                     |                    |                   |
| Checkbox                     |                    |                   |
| Relationship (between lists) |                    |                   |

## Softr Support for Tasks in Multiple Lists

ClickUp allows you to show tasks from one list inside other lists. Accessing these multiple lists is also possible in Softr, regardless of which list a task is housed in. For more information about these fields in ClickUp, see [this article](/add-and-manage-users/pxnkp9H3qyEVMF6XUceqnj/syncing-users-with-a-data-source/hshRGygHr4T33EnaLntGf9).

## ClickUp API Rate Limits

ClickUp has Rate limits based on the subscription plan on each Workspace level. This means that the rate at which you can read and interact with data from ClickUp will depend on your ClickUp plan. For API calls to ClickUp these are the current rate limits for ClickUp plans:

* Free Forever, Unlimited, and Business: 100 requests per minute per token.

* Business Plus: 1,000 requests per minute per token.

* Enterprise: 10,000 requests per minute per token.

## FAQ

<AccordionGroup>
  <Accordion title="Can I use ClickUp data in Softr templates?">
    Yes. Each Softr template comes with a sample Airtable base, so you can see how data is structured for the use case (e.g. client portal, inventory management). But you can use templates with another Softr-supported data source (like ClickUp), by connecting your own data. We recommend you follow the data structure in the sample base.
  </Accordion>

  <Accordion title="Can I pull in sub-tasks from ClickUp?">
    Currently this is no supported, but we will be adding this soon! In the meantime, you can use our REST API datasource to pull in other resources from ClickUp like sub-tasks, built-in ClickUp comments, and more.
  </Accordion>

  <Accordion title="What is the heirarchy of supported ClickUp objects in Softr?">
    Softr can connect one list to one block at a time. The list can be within a folder as well.
  </Accordion>
</AccordionGroup>
