Using Lists in Redis

A list in Redis refers to a collection of string values that are sorted by insert order. In Redis, a list can hold up to 4 billion elements. Redis uses the concept of head and tail to manage a list, as we will cover in this guide.

Using this guide, you will learn how to work with lists in Redis, including creating, inserting, and deleting values.

In this guide, we have tested all the commands on the latest version of Redis. We recommend you do the same and use the native Redis CLI. Doing so will ensure maximum compatibility and allow you to see similar outputs to the ones in this guide.

Basics – Creating a List in Redis

Creating a list in Redis is a little more than creating a simple key and value pair. It is good to note that a key can hold a single list only.

As mentioned, Redis uses the concept of head and tail or left and right to manage a list.

There are two ways you can add items to a list:

  1. LPUSH
  2. RPUSH

The LPUSH commands add the specified new element to the list’s head (or left). The RPUSH command, on the other hand, will add the new list element to the tail (or right) of the specified list.

You use two main commands to create a new list or add items to an existing list.

Let us take a few examples.

To create a simple list called databases, we can use the command:> LPUSH databases mongodb

(integer) 1

NOTE: You can also use RPUSH to perform the same operation.

Both LPUSH and RPUSH commands will return an integer value indicating the number of elements in the list.

Take the following examples to add more elements to the list.> LPUSH databases mongodb> LPUSH databases Redis> RPUSH databases PostgreSQL> RPUSH databases MySQL> LPUSH databases CockroachDB

(integer) 5

You can add multiple items to a list in a single command. For example, we can substitute the above commands for one as:> LPUSH databases MongoDB Redis PostgreSQL MySQL CockroachDB

(integer) 5

The same case applies to the RPUSH command.

Redis also provides the LPUSHX and RPUSHX commands. They are used similar to the LPUSH and RPUSH commands; however, they cannot create a list. The key must exist before inserting elements with LPUSHX and RPUSHX commands.> RPUSHX databases Firestore> LPUSHX databases MariaDB

Update a List item

To modify a value of an item in a Redis list, use the LSET command. The command takes the list, index of the old element to update, and the new value.

For example, to change the value of the item at index 0, we can do:> LSET databases 0 SQLite


The command returns the string “OK” if the command executes successfully.

Fetch Elements from a List

To fetch items from a list, use the LRANGE command. The command takes a start and stop index and returns the values within the specified range.

For example:> LRANGE databases 0 5

1) "SQLite"

2) "CockroachDB"

3) "MySQL"

4) "PostgreSQL"

5) "Redis"

6) "MongoDB"

You can use a negative range. For example, -1 represents the last element in the list, and -4 represents the fourth to last element.

Example:> LRANGE databases -4 -1

1) "PostgreSQL"

2) "Redis"

3) "MongoDB"

4) "Firestore

If you want to get a single element in the list, use the LINDEX command followed by the target index of the item to get.

For example:> LINDEX databases 2


Keep in mind that indexing starts at 0.

If you want to know the number of items in a list, use the LLEN command.> LLEN databases

(integer) 7

The command returns an integer representing the number of items in the list.

Deleting Items from a List

If you want to remove an item from a list, use the LREM command. The command takes the count and a value to remove.

The command will remove the first occurrence matching a specific pattern by default.> LREM databases 1 MySQL

You can also use the LPOP and RPOP commands to remove items from a list. The commands remove the leftmost and rightmost elements in the list, respectively.> LPOP databases

"SQLite"> RPOP databases


Both commands remove and return the value of the removed item.


Using this guide, you learned how to work with List in Redis. You can check the documentation to learn more about List commands and how they work.

Thank you for reading 🙂

About the author

John Otieno

My name is John and am a fellow geek like you. I am passionate about all things computers from Hardware, Operating systems to Programming. My dream is to share my knowledge with the world and help out fellow geeks. Follow my content by subscribing to LinuxHint mailing list