How to create a Filter/Search List in React (2023)

Last updated on January 3, 2023 A Goodman Loading... 17 comments

This article walks you through a complete example of making a filter (searchable) list in React. We’ll use the most recent stable version of React (18.3) as well as use functional components and hooks.

The Example

Let’s say we have a list of users. Our job is to filter (search) some users by their names.

We’ll use the filter() and startsWith() methods (just two Javascript methods) to find out users whose names match the text entered in the search box. We also use the toLowerCase() method to make it case-insensitive.

When the search box is empty, all users will be displayed.


Javascript code

To make sure we start at the same place, you should create a brand new React project:

npx create-react-app kindacode-example

Here’s the full source code in src/App.js:

import React, { useState } from 'react';

import './App.css';

// This holds a list of some fiction people
// Some  have the same name but different age and id
const USERS = [
  { id: 1, name: 'Andy', age: 32 },
  { id: 2, name: 'Bob', age: 30 },
  { id: 3, name: 'Tom Hulk', age: 40 },
  { id: 4, name: 'Tom Hank', age: 50 },
  { id: 5, name: 'Audra', age: 30 },
  { id: 6, name: 'Anna', age: 68 },
  { id: 7, name: 'Tom', age: 34 },
  { id: 8, name: 'Tom Riddle', age: 28 },
  { id: 9, name: 'Bolo', age: 23 },

function App() {
  // the value of the search field 
  const [name, setName] = useState('');

  // the search result
  const [foundUsers, setFoundUsers] = useState(USERS);

  const filter = (e) => {
    const keyword =;

    if (keyword !== '') {
      const results = USERS.filter((user) => {
        // Use the toLowerCase() method to make it case-insensitive
    } else {
      // If the text field is empty, show all users


  return (
    <div className="container">

      <div className="user-list">
        {foundUsers && foundUsers.length > 0 ? (
 => (
            <li key={} className="user">
              <span className="user-id">{}</span>
              <span className="user-name">{}</span>
              <span className="user-age">{user.age} year old</span>
        ) : (
          <h1>No results found!</h1>

export default App;

CSS code

Below’s the full source code in src/App.css:

.container {
  padding-top: 30px;
  width: 300px;
  margin: auto;

.input {
  padding: 5px 15px;
  width: 300px;

.user-list {
  margin-top: 30px;

.user {
  list-style: none;
  margin: 10px 0;
  padding: 10px;
  background: #eee;
  display: flex;
  justify-content: space-between;

.user-id {
  color: red;
  margin-right: 20px;

.user-name {
  color: blue;

.user-age {
  margin-left: auto;


Congratulation! At this point, you should get a better understanding and feel more comfortable when working with a filter/search list in React. Continue learning and pushing forward by taking a look at the following articles:

You can also check our React topic page and React Native topic page for the latest tutorials and examples.

Notify of
Inline Feedbacks
View all comments
4 months ago

Thanks for the article! Using Array.prototype.includes() is much more concise, if the query string is empty (“”) then it matches all records in the array. Else it matches partial strings. Less logic to worry about.

8 months ago

I tried applying this to my code but when it first renders the list is empty instead of showing everything. My code base takes the filteredNames and passes them into another component that renders them in a table. They only appear once I start using the search bar. What am… Read more »

7 months ago
Reply to  Zane

I have the same problem too, nothing shows unless I start typing something in the search bar

7 months ago
Reply to  A Goodman

Nothing seems to be wrong with the code, I used a conditional operator to display all the contents and if that’s false, then just display filtered ones if true… Solved my problem…

8 months ago

Thank you, man 🙏

9 months ago

we can compress this code like this import React, { useState } from “react“; import { render } from “react-dom“; const cities = [“agra“, “kanpur“, “Ahamdabad“, “noida“]; const App = () => { const [filterData, setFilterData] = useState(cities); // const [name, setName] = useState(“”); const handleChange = (e) => {… Read more »

11 months ago

this code is so simple and it works in a stable!

1 year ago

Thank you so much for the example. It helped me solve the filter search challenge I was having.

1 year ago

i want to change the code to search for streetname. However, seems the code is not working. Can you have a look ?

1 year ago

I think we should improve this by using useEffect so it can search from any alphabet that those names have and render the names from the array objects

Gerald Hyuha
Gerald Hyuha
1 year ago

where is the index html file?????

Related Articles