---
name: "createMarkerLocal"
type: command
status: ok
groups: ["Markers"]
arma3_since: "0.50"
locality: {"argument": null, "effect": "local", "server_exec": false}
source: https://community.bistudio.com/wiki/createMarkerLocal
revid: 378419
updated: 2026-04-05T12:27:41Z
---

# createMarkerLocal

*Command · Markers · Arma 3 v0.50 · introduced in Armed Assault v1.04*

Locality: effect **local**

## Description

Creates a [local](../topics/Multiplayer_Scripting.md#locality) marker at the given position - the marker only exists on the machine that created it. The marker name has to be unique, if a marker with the given name exists, the command will be ignored. Use [deleteMarkerLocal](../commands/deleteMarkerLocal.md) to delete a local marker.

If the position is given in 3D format, `z` coordinate is stored with the marker and will be used when marker is passed to commands like [createVehicle](../commands/createVehicle.md), [createUnit](../commands/createUnit.md), [createAgent](../commands/createAgent.md), [createMine](../commands/createMine.md), [setVehiclePosition](../commands/setVehiclePosition.md) for example. However [getMarkerPos](../commands/getMarkerPos.md) and [markerPos](../commands/markerPos.md) will always return 0 for `z`.

> [!IMPORTANT]
> Local markers have their own set of local commands "xxMarkerxxLocal" to work with. If you use global marker commands on a local marker, the local marker will become **global**.

## Syntax

```sqf
createMarkerLocal [name, position, channel, creator]
```

**Parameters:**

- `name`: [String](../topics/String.md)
- `position`: [Position2D](../topics/Position.md#introduction), [PositionAGL](../topics/Position.md#positionagl) or [Object](../topics/Object.md) - object's model centre is used (see [getPosWorld](../commands/getPosWorld.md))
- `channel`: [Number](../topics/Number.md) - (Optional)The marker side for multiplayer *(since arma3 2.02)*
- `creator`: [Object](../topics/Object.md) - (Optional) The marker creator for multiplayer *(since arma3 2.02)*

**Returns:** [String](../topics/String.md) - the marker's name, or an empty string if the marker name is not unique

## Examples

### Example 1

```sqf
_marker = createMarkerLocal ["Marker1", position player];
```

## Multiplayer

[createMarkerLocal](../commands/createMarkerLocal.md) is local, so it should be used along with the other local commands. For global equivalent use [createMarker](../commands/createMarker.md).

## Problems

[setMarkerDrawPriority](../commands/setMarkerDrawPriority.md) sorts [allMapMarkers](../commands/allMapMarkers.md) from least to most priority. Before Arma 3 v2.18 [createMarker](../commands/createMarker.md)/[createMarkerLocal](../commands/createMarkerLocal.md) did **not** care about drawing priority and added the created marker to the end of the array, making it top priority. Running [setMarkerDrawPriority](../commands/setMarkerDrawPriority.md) again sorted this issue.

## See also

[allMapMarkers](../commands/allMapMarkers.md) · [deleteMarkerLocal](../commands/deleteMarkerLocal.md) · [createMarker](../commands/createMarker.md) · [setMarkerBrushLocal](../commands/setMarkerBrushLocal.md) · [setMarkerColorLocal](../commands/setMarkerColorLocal.md) · [setMarkerDirLocal](../commands/setMarkerDirLocal.md) · [setMarkerPosLocal](../commands/setMarkerPosLocal.md) · [setMarkerShapeLocal](../commands/setMarkerShapeLocal.md) · [setMarkerSizeLocal](../commands/setMarkerSizeLocal.md) · [setMarkerTextLocal](../commands/setMarkerTextLocal.md) · [setMarkerTypeLocal](../commands/setMarkerTypeLocal.md) · [setMarkerAlphaLocal](../commands/setMarkerAlphaLocal.md) · [BIS_fnc_markerToString](../functions/BIS_fnc_markerToString.md) · [BIS_fnc_stringToMarkerLocal](../functions/BIS_fnc_stringToMarkerLocal.md)

## Community notes

**Hoz** — 2007-01-06

To create a marker which is visible on the map you need to define *at least* the following three settings:

```sqf
_markerstr = createMarkerLocal ["markername",[_Xpos,_Ypos]];
_markerstr setMarkerShapeLocal "ICON";
_markerstr setMarkerTypeLocal "DOT";
```

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