---
title: "remove · RUAL Documentation"
description: "removes the first count occurrences of elements equal to element"
canonical: https://docs.rual.nl/block-types/redis/redis_list_remove
language: en
---

# remove

This block is part of the [`redis`](https://docs.rual.nl/block-types/redis) group and was last modified in core [`v13.0.7`](https://docs.rual.nl/core-versions/130007).

### Redis Key Selection Required

This block relies on a Redis key to perform its redis releated actions. You must manually select the Redis key you want to use in the flow in the blueprint using the Redis key selector modal. To access the modal, click the white button on the block.

removes the first count occurrences of elements equal to element

- flow `flow`

- count required `number` number of elements to remove if found.

Default `0`

- element required `value` matching element to remove

- flow `flow`

- result `number`

- success `condition`

- error `value`

- key `v13.0.7` `value`

| `redis lrem` |
| --- |
| `lrem` |

A typical wiring for [remove](https://docs.rual.nl/block-types/redis/redis_list_remove): [remove document](https://docs.rual.nl/block-types/storage/function_remove_document) feeds the `flow` pin; [number](https://docs.rual.nl/block-types/number/number_default) feeds the `count` pin; [value](https://docs.rual.nl/block-types/value/value_default) feeds the `list` pin; [value](https://docs.rual.nl/block-types/value/value_default) feeds the `element` pin; the `flow` out pin feeds [funnel](https://docs.rual.nl/block-types/funnels/funnel); the `result` out pin feeds [reply in JSON](https://docs.rual.nl/block-types/json/httpconnection_set_json).

![Studio canvas example for the remove block: typical wiring for remove.](https://docs.rual.nl/canvas-examples/redis_list_remove.png)

### Commonly used with

In production blueprints, this block is most often wired together with:

- [remove document](https://docs.rual.nl/block-types/storage/function_remove_document): feeds into this block. Removes the given document from the given storage.

- [number](https://docs.rual.nl/block-types/number/number_default): feeds into this block. Generates a valid number from the filled custom value in the blueprint.

- [get fields](https://docs.rual.nl/block-types/object/object_field_getter_multiple): feeds into this block. Gets the selected fields from the given object.

- [funnel](https://docs.rual.nl/block-types/funnels/funnel): this block feeds into it.

- [reply in JSON](https://docs.rual.nl/block-types/json/httpconnection_set_json): this block feeds into it. Reply to any httpconnection as JSON body.

### Version history

Introduced in [`v13.0.7`](https://docs.rual.nl/core-versions/130007).

### Service documentation