CommunityHire an ExpertSign Up
Item DetailsLinked List
Item Details

Linked List

How to configure linked lists through a List Details block.

Video

Overview

Before reading this article, we highly recommend watching the above video and checking out our Item Details help article. It will really help you understand how this should all work.

One of the most powerful parts of Softr is being able to display not only individual details about a specific record, but also any other records that may be related to that specific record. For example, you may want to display a list of files, team members, or invoices related to a specific project. This is where Linked Lists come in.

Below we’ll look at a quick example using Projects and Tasks related to projects, but you can do this with any data type you can imagine.

Example Setup

  1. Create a “Projects” table

    Projects table

    Projects table
  2. Create “Tasks” table to hold task-related data, including a field referencing the associated Project. It can be a Lookup field that looks up the Name field from the Projects table, but it can also be a regular field that contains the names of the projects, as in the example below.

    Table with tasks

    Table with tasks

Implementation

  1. On e.g. “Projects” page, add a List block linked to the Project Airtable table as shown below.

List block with projects

List block with projects
  1. On e.g. “Project details” page, add a List Details block, again linked to the Projects Airtable table.

  2. On this detail page, add also a List block, linked to the Tasks Airtable table

Task list added to the Project details page

Task list added to the Project details page

Configuration

As soon as you add the Tasks list to the project’s details page, you’ll see that the Projects table’s fields will start appearing inside Conditional Filters of the Tasks list block.

Projects table inside Task List's conditional filters

Projects table inside Task List's conditional filters

Using this, we can now set a condition to filter the Tasks list to show only the tasks that are associated with the project that’s currently opened in the page. The condition will be set as shown below.

Setting the filtering condition

So, only the tasks for which the value in the Project column corresponds to the current project’s Name will be shown.

Result

Let’s check how that works for the Ad Campaign project that includes two tasks (assigned to steven@softr.io and joanne@softr.io).

Testing the result

Testing the result

That’s it. Now, each project details page will also show all the tasks associated to it.

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.