> ## Documentation Index
> Fetch the complete documentation index at: https://docs.elementlabs.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Install the map

> Add Element 3D Map to your FiveM server and open it in game.

## Outcome

The map opens in game on the toggle key and shows the markers your other resources create.

## Prerequisites

* `element_sdk` installed and starting before this resource. See [Install a
  product](/getting-started/installation).
* The `element_map` archive from the CFX portal.

The map stores nothing, so no database resource is required. A framework is optional: with
`es_extended`, `qb-core` or `qbx_core` running, the player card shows the framework's character
name; without one, the map shows the FiveM account name and reads whether the player is alive from
the game itself.

## Steps

### 1. Extract the archive

```text theme={null}
resources/[element]/element_map/
```

`fxmanifest.lua` must be directly inside that directory.

### 2. Add it to `server.cfg`, after the SDK

```cfg theme={null}
ensure element_sdk
ensure element_map
```

### 3. Restart the server

### 4. Install the integration

The map shows markers created by your other resources, and reaching them needs one script, shipped
with the release, to be installed into those resources:

```text theme={null}
resources\[element]\element_map\windows-install-hooks-element_map.bat
```

```bash theme={null}
cd resources/\[element\]/element_map
./linux-install-hooks-element_map.sh
```

What it changes, and when to run it again, is described in [Product
integrations](/concepts/integrations). Restart the server afterwards.

This step can wait: the map opens without it and shows the markers it can see on its own. Markers
created by other resources before the integration is installed stay invisible.

### 5. Open the map in game

The map is bound to `ESCAPE` by default. Players rebind it for themselves in the FiveM key-mapping
menu, under the label **Toggle 3D Map**.

To change the default for players who have not chosen their own, see
[Controls](/products/map/configuration/controls).

## Verification

Three checks:

1. The console reports a clean start for `element_map`, with no `[ERROR]` or `[WARN ]` line naming
   it. If it does not start at all, see [A product does not
   start](/support/product-will-not-start).
2. The key opens the map, the camera rises above your character, and the interface appears.
3. Markers created by your other resources are visible and listed in the legend. If they are not,
   the integration is missing. See [Markers do not
   appear](/products/map/troubleshooting/blips-missing).

If the key does nothing, see [The map does not
open](/products/map/troubleshooting/map-will-not-open).

## Next steps

* [How players use the map](/products/map/using-the-map): every control, worth sharing with your
  players.
* [Configuration](/products/map/configuration/index): the eight groups of settings.
* [Exports](/products/map/reference/exports): driving the map from your own resources.