> For the complete documentation index, see [llms.txt](https://docs.boii.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.boii.dev/fivem-free-resources/bduk/components/namecard.md).

# Namecard

<figure><img src="/files/grXe663S89CUmq5xUteM" alt=""><figcaption></figcaption></figure>

Displays a clean, styled player profile — including avatar, name, title, level, and tier.\
Used in headers or footers to show who's logged in, their status, or game rank.

***

## Structure

```lua
{
    type = "namecard",
    avatar = "avatar_1.jpg",
    background = "namecard_bg_2.jpg",
    name = "Player Name",
    title = "Some Player Title",
    level = 99,
    tier = "silver"
}
```

***

## Where to Use

You can place a namecard in:

* `header.left`, or `header.right`
* `footer.left`, or `footer.right`

***

## Fields

* **`type`**: Always `"namecard"` to use this component.
* **`avatar`**: File name or path for the avatar image (stored in `/ui/assets/namecards/avatars/`). If a full URL or `nui://` path is provided, it will be used directly.
* **`background`** *(optional)*: Background image file (stored in `/ui/assets/namecards/backgrounds/`). Defaults to `"avatar_placeholder.png"`. Full links or `nui://` paths are supported.
* **`name`** *(optional)*: The player’s name. Defaults to `"Player Name"`.
* **`title`** *(optional)*: Role or description (e.g., "Founder", "Police Chief").
* **`level`** *(optional)*: Player level — displayed as `Lv. 99`.
* **`tier`** *(optional)*: Style pre-set (`"bronze"`, `"silver"`, `"gold"`, etc.) for colouring and badges.

***

## Notes

* `avatar` and `background` must match filenames in the asset folders.
* Tiers can be styled via CSS — each one has a visual style (`.bronze`, `.gold`, etc.).