CommunityHire an ExpertSign Up
How to GuidesHow to filter list data from the URL?
How to Guides

How to filter list data from the URL?

Navigate your users to a filtered version of the list

This is a handy feature if you want your users to be taken to a filtered version of your List via URL. You can filter the list through an Inline Filter or Search. Let’s consider the Inline Filter case first.

Filtering the list through an inline filter

To filter the list by one of the Inline Filter values, you need to use the following format: ?filter-by-fieldName=fieldValue

You should add the filtering parameters at the end of your List URL, replacing fieldName with the name of the field you want to use for filtering and fieldValue with the value you want to filter by. Let’s consider a specific example to make it clear.

Example

Let’s say we have a list of employee profiles with a Position field and want to have a URL that filters the list, leaving only the profiles where the Position is Engineer.

List of employee profiles

List of employee profiles

First of all, let’s set up a corresponding Inline Filter.

Adding an inline filter

Adding an inline filter

Next, let’s configure the URL, which will look as follows:

  • https://{subdomain}.softr.app/list?filter-by-Position=Engineer

That’s it. Now, let’s check if everything is working correctly.

Image

Testing the filtering

To pre-filter the list through search, you need to use the following format: ?search-for=searchValue

You should add the parameter at the end of your List URL, replacing searchValue with the query you want to filter the list by. Let’s consider a specific example to make it clear.

Example

Let’s say we have a list of tasks for a software development team, where each task has a name.

A list of tasks

A list of tasks

So, if we add the following parameter at the end of our page URL, we will see a list that only contains entries with a value “merge”: ?search-for=merge

Testing the URL

Combining search and inline filters

It’s also possible to combine inline filter and search parameter formats by simply joining them with an “&”: ?filter-by-fieldName=fieldValue&search-for=searchValue

As a result, only the list records that match both of the conditions will be displayed.

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.