<!-- Source: https://docs.fmrte.com/26/graphics-and-files/facepacks | FMRTE official documentation -->

# Installing newgen and staff facepacks

> Documentation release: **FMRTE 26** (published release).

Facepack Installer links images to people in your savegame through a `config.xml` file. It is free, but you must supply the facepack; it does not generate images.

## Before installing

[Load your savegame](https://docs.fmrte.com/26/getting-started/load-game.md), then download and extract a compatible facepack. Choose its image folder, not the archive.

![Facepack Installer with folder, person and mode choices](https://docs.fmrte.com/img/fmrte26/live/facepack-installer.jpg)

## Install a small test set

1. Open **Facepack Installer** from the toolbar.
2. Choose **Facepack Folder** and check the detected pack type and face count. If it says **No facepack found**, check the extracted folder.
3. Check **Game graphics Folder**. Use **Open** to inspect it.
4. Select **Copy to game graphics folder**, or copy the finished pack and `config.xml` there yourself.
5. Choose **Target Persons**. Use **Custom → Customize** for a few people, or a group such as newgens, players or staff.
6. Choose the mode below and whether to **Allow Duplicates**.
7. Select **Install** and check the installed, preserved and missing-person totals.
8. Confirm the images and `config.xml` are in the graphics folder.

| Mode | Effect |
| --- | --- |
| **Preserve** | Keep existing mappings |
| **Override but preserve missing persons** | Replace selected mappings; keep those outside the selection |
| **Override** | Replace existing mappings in scope |

**Allow Duplicates** lets more than one person use the same image. Leave it off if every person should have a different face.

## Make FM26 load the new mapping

Reopen the same person's profile in Football Manager to check the face. If your game offers graphics-cache or skin-reload controls, use them. Otherwise, restarting the game is a diagnostic step; a universal refresh sequence is not yet confirmed.

If the face remains missing, check the files below before reinstalling with Override.

## Add more faces later

Use **Preserve** to keep current faces, or **Override but preserve missing persons** to replace selected ones. Compare installed, preserved and missing totals after each update.

## Game graphics Folder is blank, missing or wrong

The destination comes from the running game's user-data folder plus `graphics`. It is read-only. **Facepack Folder** is the source pack, not the destination.

1. Load the correct savegame in both apps and reopen the installer.
2. Use **Open** to check the destination, especially with redirected Documents or a custom user-data location.
3. Create a `graphics` subfolder there if it is missing.
4. Keep the extracted images and completed `config.xml` together inside it.

If the destination is blank or points to another installation, report both paths. Changing the install mode does not fix a wrong folder.

## Italmed, SAMed or a dictionary-key error

Update FMRTE and check that the pack is supported and fully extracted. If the error remains, report its exact text, pack name, detection result and install mode. Deleting `config.xml` is not a general fix.

## Installation succeeded, but the face is still missing

Check one person from start to finish:

| Check | What must match |
| --- | --- |
| Person | The unique ID in the loaded savegame |
| Mapping | That ID in `config.xml` |
| Image | The mapped file exists relative to the config file |
| Destination | The pack is inside this game's graphics folder |
| Display | Football Manager has refreshed the graphics |

Installation totals describe the files processed, not whether Football Manager displayed them.
