---
name: "doMove"
type: command
status: ok
groups: ["Unit Control"]
arma3_since: "0.50"
locality: {"argument": "local", "effect": "global", "server_exec": false}
source: https://community.bistudio.com/wiki/doMove
revid: 377517
updated: 2026-01-02T06:52:02Z
---

# doMove

*Command · Unit Control · Arma 3 v0.50 · introduced in Operation Flashpoint v1.00*

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

## Description

Order the given unit(s) to move to the given position (without radio messages). Upon reaching its destination, if it is the group leader it will order the group to form around it's new position. If it is not the leader, it will immediately be ordered to return to formation by the group leader and begin moving back to the group. Use [doStop](../commands/doStop.md) to stop units returning to formation. [moveToCompleted](../commands/moveToCompleted.md) will return true when a unit issued this command reaches its destination.

## Syntax

```sqf
unit(s) doMove position
```

**Parameters:**

- `unit(s)`: [Object](../topics/Object.md) or [Array](../topics/Array.md) of [Object](../topics/Object.md)s
- `position`: [Position](../topics/Position.md)

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

## Examples

### Example 1

```sqf
_soldier1 doMove (position _officer);
```

### Example 2

```sqf
this doMove (getMarkerPos "Marker1");
```

## See also

[commandMove](../commands/commandMove.md) · [setDestination](../commands/setDestination.md) · [moveTo](../commands/moveTo.md) · [move](../commands/move.md) · [addWaypoint](../commands/addWaypoint.md)

## Community notes

**DreadedEntity** — 2022-04-02

The above note is only true of units which group leader is not the player. Player-squad will remain in position until given another order (A3 v2.08.149102)

---

**DreadedEntity** — 2022-04-02

If you need your script to halt until the unit has reached it's destination, [waitUntil](../commands/waitUntil.md) and [moveToCompleted](../commands/moveToCompleted.md) will come in handy:

```sqf
_unit doMove _pos;
waitUntil {moveToCompleted _unit};
```

This also works with [commandMove](../commands/commandMove.md)

---

**Waffle SS.** — 2022-07-25

Seems to use PositionATL, which may be important if the destination is above a building's 1st floor.

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