---
title: "sum on field · RUAL Documentation"
description: "Returns the total sum of the given field within the array of objects."
canonical: https://docs.rual.nl/block-types/array/array_sum_on_bp_field
language: en
---

# sum 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 total sum of the given field within the array of objects.

- Array required `array` The array of objects for which to calculate the sum.

- Number `number` Sum of the field chosen.

Returns the sum of the selected field (dot path) across the object items; a missing or non-numeric field value adds 0, numeric strings coerce, and non-object items are skipped. Outputs 0 when no field is selected or the input is not an array - indistinguishable from a real sum of 0.

| `total` |
| --- |

A typical wiring for [sum on field](https://docs.rual.nl/block-types/array/array_sum_on_bp_field): 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 sum on field block: typical wiring for sum on field.](https://docs.rual.nl/canvas-examples/array_sum_on_bp_field.png)

### Version history

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