User Widget

The User widget displays information about the signed-in user — avatar, name, and an optional subtitle. Use it to highlight who is signed in or to build a profile row in the app's layout.

When to use this

• You want a greeting row with the user's name on the home page
• You need a user row in the header or a side menu
• You want to build a profile card with an avatar and title

How it works

The widget has two sections: Avatar (the image) and Text (title and subtitle). In the text fields you can use $name (first name) or $fullname (first and last name) — the variables are replaced with the signed-in user's name when the widget renders.

Add a user widget

1. Open the Design editor for your applet.
2. Add the User widget to the page.
3. Open the widget settings.
4. Turn on Show avatar and pick position, size, and shape if the avatar should be shown.
5. Enter a title and optional subtitle — use $name or $fullname to display the user's name.

Widget settings

Avatar

Setting	Description
Show avatar	Toggles the user's avatar on or off. When off, all avatar settings are hidden.
Position	Pick Start (avatar shown before the text) or End (avatar shown after the text).
Size	Pick Default, Small, or Large.
Shape	Pick Default, Round, or Square.

Text

Setting	Description
Title	The text shown as the title. Supports $name (first name) and $fullname (first and last name). If left empty, the placeholder $name is used.
Subtitle	Optional text under the title. Supports the same variables as Title.

Example

Scenario: You want a greeting row at the top of the home page with the avatar, name, and a short subtitle.

1. Add a User widget at the top of the home page.
2. Turn on Show avatar with Position Start, Size Large, and Shape Round.
3. Set Title to Hi, $name!.
4. Set Subtitle to Welcome back.

The page now opens with a personal greeting row that adapts to the signed-in user.

Tips

TIP

Use $fullname when the widget should look like an identity card (for example in a side menu or profile page) and $name when the tone is more informal (a greeting on the home page).

TIP

The avatar is taken from the user's profile. If the user hasn't uploaded a picture, a default avatar is shown — check how it looks before you publish.

Common mistakes

WARNING

If the title shows $name as plain text — without being replaced — check that the variable is spelled exactly: $name, not $Name or ${name}. Only the exact spellings are recognized.