---
name: "unitsBelowHeight"
type: command
status: ok
groups: ["Object Detection", "Positions"]
arma3_since: "0.50"
locality: {"argument": "global", "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/unitsBelowHeight
revid: 325197
updated: 2022-07-01T14:53:08Z
---

# unitsBelowHeight

*Command · Object Detection, Positions · Arma 3 v0.50 · introduced in Arma 2 v1.04*

Locality: arguments **global**

## Description

Returns units in group/array below given Above Terrain Level (ATL) altitude.

> [!NOTE]
> an object's ATL altitude can be found with `_altitude = (getPosATL _obj) select 2;`.

## Syntax

### Syntax 1

```sqf
units unitsBelowHeight height
```

**Parameters:**

- `units`: [Array](../topics/Array.md) of [Object](../topics/Object.md)s
- `height`: [Number](../topics/Number.md) - height above terrain level ([PositionATL](../topics/Position.md#positionatl))

**Returns:** [Array](../topics/Array.md) of [Object](../topics/Object.md)s

### Syntax 2

```sqf
group unitsBelowHeight height
```

**Parameters:**

- `group`: [Group](../topics/Group.md) - AI group
- `height`: [Number](../topics/Number.md) - height above terrain level ([PositionATL](../topics/Position.md#positionatl))

**Returns:** [Array](../topics/Array.md) of [Object](../topics/Object.md)s

## Examples

### Example 1

```sqf
_allOnGroudUnits = group player unitsBelowHeight 10;
```

### Example 2

```sqf
_units = allUnits unitsBelowHeight 30;
```

## See also

[allUnits](../commands/allUnits.md) · [getPosATL](../commands/getPosATL.md) · [group](../commands/group.md)

<sub>Source: [BI Community Wiki — unitsBelowHeight](https://community.bistudio.com/wiki/unitsBelowHeight) (revision 325197).</sub>