# Avatar

Create and group avatars of different sizes and shapes with a single component.

### Avatar Sizes&#x20;

<div align="left"><img src="/files/-LUFmdsDAUB6tesc3s-e" alt=""></div>

```markup
<div class="avatar avatar-xxl">
    <img src="assets/img/users/user-1.jpg" alt="..." class="avatar-img rounded-circle">
</div>

<div class="avatar avatar-xl">
    <img src="assets/img/users/user-2.jpg" alt="..." class="avatar-img rounded-circle">
</div>

<div class="avatar avatar-lg">
    <img src="assets/img/users/user-3.jpg" alt="..." class="avatar-img rounded-circle">
</div>

<div class="avatar">
    <img src="assets/img/users/user-4.jpg" alt="..." class="avatar-img rounded-circle">
</div>

<div class="avatar avatar-sm">
    <img src="assets/img/users/user-5.jpg" alt="..." class="avatar-img rounded-circle">
</div>

<div class="avatar avatar-xs">
    <img src="assets/img/users/user-6.jpg" alt="..." class="avatar-img rounded-circle">
</div>
```

### Avatar with text placeholders

<div align="left"><img src="/files/-LUFnBZo8gEx4m2yayus" alt=""></div>

```markup
<div class="avatar avatar-xxl">
    <span class="avatar-title rounded-circle ">AR</span>
</div>

<div class="avatar avatar-xl">
    <span class="avatar-title rounded-circle ">EQ</span>
</div>

<div class="avatar avatar-lg">
    <span class="avatar-title rounded-circle ">VV</span>
</div>

<div class="avatar">
    <span class="avatar-title rounded-circle ">SM</span>
</div>

<div class="avatar avatar-sm">
    <span class="avatar-title rounded-circle ">XS</span>
</div>

<div class="avatar avatar-xs">
    <span class="avatar-title rounded-circle ">SS</span>
</div>
```

### Avatar Status

<div align="left"><img src="/files/-LUFnupkYgRVBu8YsKy8" alt=""></div>

```markup
<div class="avatar avatar-online">
    <img src="assets/img/users/user-4.jpg" alt="..." class="avatar-img rounded-circle">
</div>
<div class="avatar avatar-away">
    <img src="assets/img/users/user-4.jpg" alt="..." class="avatar-img rounded-circle">
</div>
<div class="avatar avatar-dnd">
    <img src="assets/img/users/user-4.jpg" alt="..." class="avatar-img rounded-circle">
</div>
<div class="avatar avatar-offline">
    <img src="assets/img/users/user-4.jpg" alt="..." class="avatar-img rounded-circle">
</div>
```

### Avatar Group

<div align="left"><img src="/files/-LUFoTYVI2b5TFp5HIVx" alt=""></div>

```markup
<div class="avatar-group">
    <div class="avatar ">
        <img src="assets/img/users/user-2.jpg" alt="..."
             class="avatar-img rounded-circle">
    </div>

    <div class="avatar ">
        <img src="assets/img/users/user-3.jpg" alt="..."
             class="avatar-img rounded-circle">
    </div>

    <div class="avatar">
        <img src="assets/img/users/user-4.jpg" alt="..."
             class="avatar-img rounded-circle">
    </div>

    <div class="avatar ">
        <img src="assets/img/users/user-5.jpg" alt="..."
             class="avatar-img rounded-circle">
    </div>

    <div class="avatar ">
        <span class="avatar-title rounded-circle">AB</span>
    </div>
</div>
```

### Avatar Shape

<div align="left"><img src="/files/-LUForuKltc3mNPINxdG" alt=""></div>

```markup
<div class="avatar avatar-xl">
    <img src="assets/img/users/user-2.jpg" alt="..." class="avatar-img ">
</div>

<div class="avatar avatar-xl">
    <img src="assets/img/users/user-3.jpg" alt="..." class="avatar-img rounded">
</div>

<div class="avatar avatar-xl">
    <img src="assets/img/users/user-3.jpg" alt="..." class="avatar-img rounded-circle">
</div>
```

### Avatar as file picker in forms

You can avatar file picker, this comes handy when you want to create profile picture updating scenarios<br>

<div align="left"><img src="/files/-LZxxGZRcAdVopEEQTKN" alt=""></div>

#### Markup

```markup
<label class="avatar-input">
    <span class="avatar avatar-lg">
        <img src="assets/img/users/user-9.jpg" alt="..."
             class="avatar-img rounded-circle">
         <span class="avatar-input-icon rounded-circle">
        <i class="mdi mdi-upload mdi-24px"></i>
    </span>
    </span>
    <input type="file" class="avatar-file-picker" >
</label>
```

#### JS Code for picker

```javascript
 function readFile(input) {
        if (input.files && input.files[0]) {
            var reader = new FileReader();

            reader.onload = function (e) {
                $(input).parents('.avatar-input').find('.avatar-img').attr('src', e.target.result);
            };

            reader.readAsDataURL(input.files[0]);
        }
    }
    $('.avatar-file-picker').on('change', function () {
         readFile(this);
    });

```

{% hint style="info" %}
Please note file picker does not upload image on selection
{% endhint %}


---

# 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.atomui.com/ui-elements/avatar.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.
