---
title: "push · RUAL Documentation"
description: "prepend one element to a list"
canonical: https://docs.rual.nl/block-types/redis/redis_list_push
language: en
---

# push

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.

prepend one element to a list

- flow `flow`

- element required `value` the element to push.

- flow `flow`

- success `condition`

- error `value`

- length `number`

- key `v13.0.7` `value`

| `redis lpush` |
| --- |
| `lpush` |

A typical wiring for [push](https://docs.rual.nl/block-types/redis/redis_list_push): [create document](https://docs.rual.nl/block-types/storage/function_create_document_from_mutations) feeds the `list` pin; [get document](https://docs.rual.nl/block-types/storage/function_get_document) feeds the `element` pin; the `flow` out pin feeds [create document](https://docs.rual.nl/block-types/storage/function_create_document_from_mutations); the `error` out pin feeds [trim](https://docs.rual.nl/block-types/redis/redis_list_trim).

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

### Commonly used with

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

- [create document](https://docs.rual.nl/block-types/storage/function_create_document_from_mutations): wired in both directions with this block. Creates a document in the given storage.

- [create](https://docs.rual.nl/block-types/globals/trigger_custom_function): feeds into this block. Creates a new function that can be executed using the given name.

- [get document](https://docs.rual.nl/block-types/storage/function_get_document): feeds into this block. get a specific document based on the given GUID.

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

- [trim](https://docs.rual.nl/block-types/redis/redis_list_trim): this block feeds into it. trim a list to the specified range.

- [concatenate values](https://docs.rual.nl/block-types/value/value_concatenate): feeds into this block.

### Version history

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

### Service documentation