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

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

<Tip>In order for the URL filter to work, you need to have an [Inline Filter](/building-blocks/vikC2AWEpQGkZd4jGyoVxo/list-block/pQhPYuA28VXr5tLLFBcbCU) set up for the same field in your list.</Tip>

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

<Frame caption="List of employee profiles">
  <img src="https://mintcdn.com/softr-2b8a27e1/0TOUhZGdnWj5pNUQ/how-to-guides/images/how-to-filter-list-data-from-the-url/image1.png?fit=max&auto=format&n=0TOUhZGdnWj5pNUQ&q=85&s=5cd57d333321cfb9792f870709666a73" alt="List of employee profiles" width="2520" height="1200" data-path="how-to-guides/images/how-to-filter-list-data-from-the-url/image1.png" />
</Frame>

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

<Frame caption="Adding an inline filter">
  <img src="https://mintcdn.com/softr-2b8a27e1/0TOUhZGdnWj5pNUQ/how-to-guides/images/how-to-filter-list-data-from-the-url/image2.png?fit=max&auto=format&n=0TOUhZGdnWj5pNUQ&q=85&s=3be44b4ebad5004faa64ad6f4d289882" alt="Adding an inline filter" width="2272" height="972" data-path="how-to-guides/images/how-to-filter-list-data-from-the-url/image2.png" />
</Frame>

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

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

<Tip>Note that both **fieldName** and **fieldValue** are case sensitive. For instance, in the current example, the field name should be **"Position"** and not **"position"** or **"POSITION."**</Tip>

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

<Frame>
  <img src="https://mintcdn.com/softr-2b8a27e1/0TOUhZGdnWj5pNUQ/how-to-guides/images/how-to-filter-list-data-from-the-url/image3.gif?s=e30bdd42c7fe8fc4353f2b8a0618ab28" alt="Image" width="2880" height="1494" data-path="how-to-guides/images/how-to-filter-list-data-from-the-url/image3.gif" />
</Frame>

Testing the filtering

<Tip>If you have a space inside your field name or value, you can replace it with **"%20"**
inside the URL.</Tip>

## Filtering the list through search

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

<Tip>In order for the URL parameter to work, you need to have a search bar set up for your list with **Search by** field(s) selected.</Tip>

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.

<Frame caption="A list of tasks">
  <img src="https://mintcdn.com/softr-2b8a27e1/0TOUhZGdnWj5pNUQ/how-to-guides/images/how-to-filter-list-data-from-the-url/image4.png?fit=max&auto=format&n=0TOUhZGdnWj5pNUQ&q=85&s=dd44f2a2477bd88e1470c6675692c71a" alt="A list of tasks" width="2420" height="820" data-path="how-to-guides/images/how-to-filter-list-data-from-the-url/image4.png" />
</Frame>

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**

<Frame caption="Testing the URL">
  <img src="https://mintcdn.com/softr-2b8a27e1/0TOUhZGdnWj5pNUQ/how-to-guides/images/how-to-filter-list-data-from-the-url/image5.gif?s=f76a01914a212affb0c0387af39502dd" alt="Testing the URL" width="2876" height="1486" data-path="how-to-guides/images/how-to-filter-list-data-from-the-url/image5.gif" />
</Frame>

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