Skip to main content
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
AI agent avatars are unaffected by your profile settings — only human user avatars use your photo and color choices.

​
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)