# List filtering with URL

This is a handy feature if you want your users to be taken to a filtered version of your List via URL.&#x20;

Here's the format you need to use: **?filter-by-fieldName=fieldValue**

{% hint style="success" %}
In order for the URL filter to work you need to have an [Inline Filter](https://softr.gitbook.io/softr-documentation/building-blocks/listings/..#inline-filters) set up for the same field in your list.
{% endhint %}

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 (under **<https://ninfa906.softr.app/list>)** with a **Position** field and want to have a URL that filters the list, leaving only the profiles where the **Position** is **Engineer**.&#x20;

![List of Employee Profiles](https://3426011356-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0NiyhsmXAcV5u1c6XK%2Fuploads%2F914JZWgEpo13ak7kP7qG%2Fprofile-list-b.png?alt=media\&token=33727f44-bb38-4976-ac6d-c893be1e343b)

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

![Adding an inline filter](https://3426011356-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0NiyhsmXAcV5u1c6XK%2Fuploads%2FSBY2LlV0uPVSxvu7xrjd%2Flist-inline-filter-b.png?alt=media\&token=c3803969-571d-4e42-ae9c-c21bd9bc7f3a)

Next, let's configure the URL, which will look as follows:&#x20;

**<https://ninfa906.softr.app/list?filter-by-Position=Engineer>**

{% hint style="warning" %}
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."**
{% endhint %}

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

![Testing the filtering](https://3426011356-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0NiyhsmXAcV5u1c6XK%2Fuploads%2FW2SlIeBkJUkPQ66bvRRr%2FScreen%20Recording%202022-02-14%20at%2020.10.53.gif?alt=media\&token=51e6ba3b-2966-4807-a647-7e85477ba506)

{% hint style="success" %}
If you have a space inside your field name or value, you can replace it with **"%20"** inside the URL.&#x20;
{% endhint %}
