---
name: "setPosATL"
type: command
status: ok
groups: ["Positions"]
arma3_since: "0.50"
locality: {"argument": "global", "effect": "global", "server_exec": false}
source: https://community.bistudio.com/wiki/setPosATL
revid: 377533
updated: 2026-01-02T06:53:18Z
---

# setPosATL

*Command · Positions · Arma 3 v0.50 · introduced in Arma 2 v1.03*

Locality: arguments **global** · effect **global**

## Description

Sets the position of an object relative to the terrain.

## Syntax

```sqf
object setPosATL pos
```

**Parameters:**

- `object`: [Object](../topics/Object.md)
- `pos`: [PositionATL](../topics/Position.md#positionatl)

**Returns:** [Nothing](../topics/Nothing.md)

## Examples

### Example 1

```sqf
player setPosATL [getPosATL player select 0, (getPosATL player select 1) - 10, getPosATL player select 2];
```

## See also

[getPosATL](../commands/getPosATL.md) · [getPos](../commands/getPos.md) · [getPosASL](../commands/getPosASL.md) · [setPos](../commands/setPos.md) · [setPosASL](../commands/setPosASL.md)

## Community notes

**DreadedEntity** — 2014-11-11

If you plan on creating bases through script, [setPosATL](../commands/setPosATL.md) and [getPosATL](../commands/getPosATL.md) will be your friends. Other commands like [getPos](../commands/getPos.md) or [getPosASL](../commands/getPosASL.md) **will** return the position relative to any objects that are underneath / to the terrain.
I wrote a base building helper script and through multiple tests, I have found that [getPosATL](../commands/getPosATL.md) is the absolute best way to get position for objects that are over land.

---

**Hypoxic125** — 2022-09-30

As of **Verson 2.10**, if you use **setPosX** commands on a remote unit within a vehicle, the unit will remain in the vehicle. In order to avoid this, **remoteExec** the command to the remote client.

```sqf
if !(isNull objectParent _unit) then {
    [_unit, [0,0,0]] remoteExec ["setPosATL", _unit];
};
```

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