Edit documentation Edit document


Avatar is a gh-element that allows you to create a header image with a person's name for your items. It is most often used in conjunction with the Conversation element. In this case, the avatar is a classic chat avatar.

Using the avatar

It has no special purpose other than to summarize information about the user. If you use it with Conversation, it can also be filled in automatically if you make the source fields for the avatar image and name the destination fields for Conversation.

Functional Characteristics

As mentioned above, this element is mostly used to create full-fledged chats with Conversation and Cards.

Using avatar with conversation

But it can also be used to represent the content of items. Namely, since an avatar is the most useful for people's information, it can display a photo and a person's name at the top of the item.

Using the avatar in items

Element Options

The settings for the current element consist of only one set of settings.

Field Settings

This is a set of settings that provides all the necessary settings for configuring the element.

Settings of avatar field

Name Description
Application allows you to select the source application for the element; details..
Images Field allows you to select field that stores required images; details..
User Name Field allows you to select the source field for the user name; details..
Show User Name allows you to set whether the user name will displayed or not; details..


This is the setting where you have to select the application for the following element settings. The source fields for an image and a user name will be taken from the current app.

Images Field

The next setting allows you to select the multiple fields from which the images for the avatar will be taken. This is the image that will be displayed inside in the circle. Here you can select several fields, and the image will be taken from one of them.

Note that all these fields must be Image elements.

Of all the fields, priority is given to the first selected one. That is, if three fields are connected here and all of them have images, the image will be taken from the field that was selected first in this setting.

Image priorities

If all fields are empty, an abbreviation of the User Name will be displayed in the circle.

User Name Field

Here you have to select the field that contains the name of the user. The value of the selected field will be displayed below the avatar circle if the Show User Name setting is enabled. But the main role it plays is in abbreviation. When there is no photo in the avatar circle, two capital letters taken from the value of the current field will be displayed there:

  • the first letter of the first word;
  • the first letter of the last word.

Show User Name

The last setting of this element allows you to show or hide the User Name. If the current setting is enabled, the user name is displayed below the avatar circle. This text can be customized with some style settings. If the setting is disabled, the user name will not be displayed at all.

Element Style

This element has a full set of style settings. That is, there are no additional settings that would greatly affect the appearance of the element. The only customization to which the current element is subject is to change the interpretation types and Show User Name setting.

Settings of avatar style


The Avatar is not available for filtering.


Interpretations of this element are only responsible for the size of the avatar. There are three sizes in total and, accordingly, three types of interpretation.

Types of avatar interpretation


The first type of interpretation is the default type. It makes the avatar the largest of all interpretations. That is 64 pixels in diameter.


The next type allows you to create a medium-sized avatar. The diameter is 32 pixels.


The last interpretation makes the element the smallest in size, namely 24 pixels in diameter.

Value Format

This element does not store any value.

Data Model

The current gh-element has a rather small data model:

    "data_model": {
        "images_app_id": "34166",
        "images_field_id": "810583, 810456",
        "interpretation": [],
        "show_name": 1,
        "user_name_field_id": "810519"
Name Type Description
images_app_id string contains the ID of the application from which the photo and name for the element are taken
images_field_id string contains the ID of the field in which the image is stored
interpretation array contains all element interpretations
show_name boolean shows whether the required name will be displayed or not
user_name_field_id string contains the ID of the field in which the name for element is stored