# Nametag Settings

## Settings found in the nametag section

<figure><img src="https://2994430787-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYvA0UlM6GCcOd8hKhafT%2Fuploads%2FFRJQCVMO8iPZJblMd5Jo%2FlKMutW9ISu.png?alt=media&#x26;token=9702904e-33fd-47bc-b65e-30429a2c4a61" alt=""><figcaption></figcaption></figure>

1. Creating custom nametags. Visit the [Content Creation documentation for nametags](https://docs.streamavatars.com/stream-avatars/content-creating/creating-nametags).
2. The group of settings related to nametags.
3. Hide on stack height - if nametags collide with each other, one will be chosen to rise up. This setting determines how high the nametags can stack up before they go invisible / disappear. [Look at the image below for a visualize of this setting](#nametag-stack-height).
4. Set the percentage of the distance between each row. 0% makes all nametags overlap. 100% is the default spacing between nametag rows.
5. Fade out on hide - determines whether the nametag disappears over time or instantly turns invisible.
6. Hide on inactivity - if a user has not typed into chat for a while, their nametag will hide.
7. Inactivity timeout - how many seconds before a user's nametag becomes "inactive" and goes invisible.
8. Collides with avatars - nametags normally only collide with each other, but when this is enabled, nametags will also collide with the hitboxes of the avatars, causing them to stack higher.
9. Nametag Sorting - determines the graphical sorting order of nametags. Behind avatars, After avatars, or Foreground.
10. Maximum name length - determines the maximum length a user's name can display on a nametag. example: "clonzeh" is 7 characters long.

If you are interested in customizing your own nametags, please visit [this article](https://docs.streamavatars.com/stream-avatars/content-creating/creating-nametags) instead.

{% content-ref url="../content-creating/creating-nametags" %}
[creating-nametags](https://docs.streamavatars.com/stream-avatars/content-creating/creating-nametags)
{% endcontent-ref %}

## Nametag stack height

In the image below, the nametag stack height is set to: 2. This means any nametags that rise to row #3 will become invisible / disappear until they move to a space where it can fall back to the stack height limit.

<figure><img src="https://2994430787-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYvA0UlM6GCcOd8hKhafT%2Fuploads%2FevDOeKDXXrHsXhNMHbVq%2FLeFb6HHSjB.png?alt=media&#x26;token=6229ddef-4421-4a35-a281-53fd272f84a0" alt=""><figcaption></figcaption></figure>

## Adjusting Nametag height position on an avatar

If your avatar has a nametag in an undesirable position, you can adjust the avatar's collision box by doing the following:

Navigate to Avatar and Gear > select your avatar > click "Collision Box"

<div><figure><img src="https://2994430787-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYvA0UlM6GCcOd8hKhafT%2Fuploads%2FGdDSXHw5Eme0pZnKygpA%2F4CGqof6Zfn.png?alt=media&#x26;token=75bad009-6570-4d6f-bbf6-305fe4505644" alt=""><figcaption></figcaption></figure> <figure><img src="https://2994430787-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYvA0UlM6GCcOd8hKhafT%2Fuploads%2Fs6uJrGE4xdmb8TaKr40J%2FVw0ZPtjHGT.png?alt=media&#x26;token=4962f863-7cb4-480c-b905-e8dc1533da09" alt=""><figcaption></figcaption></figure></div>

Here you can adjust the horizontal and vertical position of the nametag by click-dragging the handles on the red box outline.

<div><figure><img src="https://2994430787-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYvA0UlM6GCcOd8hKhafT%2Fuploads%2FrR3j88ia4makPIMvV0bl%2FX05SPBKTUV.png?alt=media&#x26;token=b53fd5e6-9e41-4300-96e9-2175d034e21e" alt=""><figcaption></figcaption></figure> <figure><img src="https://2994430787-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYvA0UlM6GCcOd8hKhafT%2Fuploads%2FP63TPYjH2z1KyOLaHtbi%2FWEDcwfuXr2.png?alt=media&#x26;token=6ef3946d-e25a-42df-8b16-a15eb0571b78" alt=""><figcaption></figcaption></figure></div>

<figure><img src="https://2994430787-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYvA0UlM6GCcOd8hKhafT%2Fuploads%2FzYm0AB0pMpJ9oc0CdKU9%2Fw4NxZhy7a8.png?alt=media&#x26;token=b4db01ae-22aa-427d-a5fe-2dabb74a1598" alt=""><figcaption><p>fixed</p></figcaption></figure>


---

# 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.streamavatars.com/stream-avatars/application-settings/nametag-settings.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.
