> For the complete documentation index, see [llms.txt](https://docs.streamavatars.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.streamavatars.com/stream-avatars/application-settings/nametag-settings.md).

# Nametag Settings

Section - Nametags - explanation of various 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&amp;token=9702904e-33fd-47bc-b65e-30429a2c4a61" alt=""><figcaption></figcaption></figure>

1. Creating custom nametags. Visit the [Content Creation documentation for nametags](/stream-avatars/content-creating/creating-nametags.md).
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](/stream-avatars/content-creating/creating-nametags.md) instead.

{% content-ref url="/pages/KaXlylIu0JpGKMGKsQhO" %}
[Creating Nametags](/stream-avatars/content-creating/creating-nametags.md)
{% 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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;token=b4db01ae-22aa-427d-a5fe-2dabb74a1598" alt=""><figcaption><p>fixed</p></figcaption></figure>
