---
title: "max on field · RUAL Documentation"
description: "Returns the highest number for the given field in the given array of objects."
canonical: https://docs.rual.nl/block-types/array/array_max_on_bp_field
language: en
---

# max on field

This block is part of the [`array`](https://docs.rual.nl/block-types/array) group and was last modified in core [`v10.4.28`](https://docs.rual.nl/core-versions/100428).

### Field Selection Required

This block relies on a field that you select to perform its data actions. You must manually select the field you want to use in your flow using the field selector modal. To access the modal, click the white button on the block.

Returns the highest number for the given field in the given array of objects.

- Array required `array` The array of objects to find the maximum value within.

- Number `number` The highest number for the given field.

Returns the highest numeric value of the selected field (dot path) across the object items. Non-object items, items missing the field, and non-numeric values are skipped; numeric strings coerce. Outputs 0 when no field is selected, the selected field type is not number or date, or no item yields a usable value - indistinguishable from a real maximum of 0.

| `highest` |
| --- |

A typical wiring for [max on field](https://docs.rual.nl/block-types/array/array_max_on_bp_field): [search](https://docs.rual.nl/block-types/storage/function_search) feeds the `array` pin; the `number` out pin feeds [cast to value](https://docs.rual.nl/block-types/type%20casting/number_convert_to_value).

![Studio canvas example for the max on field block: typical wiring for max on field.](https://docs.rual.nl/canvas-examples/array_max_on_bp_field.png)

### Commonly used with

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

- [search](https://docs.rual.nl/block-types/storage/function_search): feeds into this block. searches in the given storage based on a query.

- [execute](https://docs.rual.nl/block-types/function%20execution/function_custom_execute_from_trigger): this block feeds into it. Executes the given funcion and waits for it to be executed.

- [return](https://docs.rual.nl/block-types/function%20execution/function_return): this block feeds into it. Returns the added custom pins as data-pins on the function execute.

### Version history

Introduced in [`v10.4.28`](https://docs.rual.nl/core-versions/100428).