# 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.).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.boii.dev/fivem-free-resources/bduk/components/namecard.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.