> ## Documentation Index
> Fetch the complete documentation index at: https://lightdash-mintlify-6c92035e.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Profile settings

> Customize your Lightdash profile with a photo or a custom avatar color.

Your profile controls how you appear to teammates across Lightdash — in the navbar, dashboard comments, space access lists, user pickers, the metrics catalog, and AI review assignments.

To open your profile, click your avatar in the top-right of Lightdash and choose **Settings → Profile**.

## Profile photo

Click the avatar preview at the top of the Profile panel to upload an image.

* **Supported formats**: PNG, JPEG, or WebP
* **Max size**: 5 MB
* The image is auto-oriented (respecting EXIF rotation), center-cropped to a square, and stored as a 256px WebP.
* To clear your photo, open the avatar preview again and choose **Remove photo**. Your avatar falls back to your initials on your chosen color (or the plain default if you haven't picked one).

## Avatar color

If you don't want to upload a photo, you can style your initials avatar with a color instead. Below the avatar preview, open the color picker to choose:

* One of five curated **Lightdash preset** gradients (lilac, blush, amethyst, sunrise, slate).
* Any custom hex color, in one of two modes:
  * **Gradient** — a mesh gradient generated from the color you pick, with a subtle film-grain finish. Click **Shuffle gradient style** to cycle through four different mesh recipes (paint splatter, soft bloom, corner spots, and duotone drift) until you find one you like.
  * **Solid** — a flat fill.

Changes preview live in the popover but only save when you click **Apply**. The color of your initials (black on light backgrounds, white on dark) is chosen automatically for readability.

If you have neither a photo nor a picked color, you keep the plain initials avatar.

## Where your avatar appears

Your profile photo or avatar color shows up in:

* The navbar avatar (with a subtle white ring on the dark header)
* Dashboard comments (as the author and when writing a new comment)
* Share-space access lists and the space access audit list
* User pickers across the product (for example, when adding a user to a space)
* The metrics catalog owner column
* The AI review assignee menu

<Info>
  AI *agent* avatars are unaffected by your profile settings — only human user avatars use your photo and color choices.
</Info>

## For API consumers

Uploaded avatars are served from a content-addressed URL with `Cache-Control: private, max-age=31536000, immutable`. Uploading a new photo produces a new URL, so caches invalidate automatically and each browser fetches a given avatar at most once.

The `avatarGradient` field on the user object accepts:

* A preset id (`lilac`, `blush`, `amethyst`, `sunrise`, `slate`)
* A raw hex string in gradient mode with the default mesh style (for example, `#5e4cff`)
* A `mesh:<vibe>:` prefixed hex string in gradient mode with an alternate mesh style, where `<vibe>` is `1`, `2`, or `3` (for example, `mesh:2:#5e4cff`). A bare hex is equivalent to `mesh:0:` and is preserved for backwards compatibility.
* A `solid:` prefixed hex string in solid mode (for example, `solid:#5e4cff`)