> ## Documentation Index
> Fetch the complete documentation index at: https://docs.headlesslabs.xyz/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Roblox Avatar

> Roblox Avatar looks up a public Roblox user and returns their avatar, display name, ID, and profile link. It does not link an account or save server data.

## Input

Accepts a 3–20 character username (letters, digits, and underscores) or a positive numeric ID. The bot queries Roblox's public user and thumbnail APIs.

### `.robloxavatar [username]`

```headless-command Syntax theme={null}
.robloxavatar [username]
```

```headless-command Example theme={null}
.robloxavatar Roblox
```

Also works: `.robloxavatar 1`

### `/robloxavatar username`

```headless-command Syntax theme={null}
/robloxavatar username:<username>
```

```headless-command Example theme={null}
/robloxavatar username:Roblox
```

> [!WARNING]
>
> No API key or account access is requested. Avoid any site that asks for your password to perform this lookup.

## Limits

The command allows one lookup every five seconds per user and uses a temporary five-minute cache. A missing account, provider rate limit, or timeout is reported as a recoverable error.

## Privacy

The lookup is read-only; its response links to the public profile. The embed's fixed labels are in English, while the displayed profile name comes from Roblox. Never send Roblox credentials or passwords.

## Steps

**1. Copy a username or ID**

Use the exact public profile name or numeric ID.

**2. Look up the avatar**

Run the command and open the profile button if you need to verify the result.

**3. Retry after limits**

If Roblox returns a rate limit or timeout, wait before trying again.

## Related pages

* [Social tools](/docs/en/community/social.md)
* [TikTok](/docs/en/integrations/tiktok.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.