跳到主要内容

profile

sidebar_position: 22 title: "User Profile" description: "View and update your display name and account information from the Settings page."​

User Profile

Your ProBeya profile stores the personal information that other team members see when you create items, post comments, or are assigned to work. The Settings page lets you update your display name and view your account email address.

Overview​

Profile management in ProBeya is accessible at /settings. If you navigate to /profile — for example via the mobile bottom navigation — you are automatically redirected to /settings where the profile form is presented. The profile form is a client-rendered card that fetches your current user data on load and persists changes through the auth.updateProfile mutation.

Getting Started​

  1. Click your avatar or name in the sidebar to open the settings menu.
  2. Select Settings or navigate to /settings.
  3. The profile card displays your current avatar, name, and email.
  4. Update your display name in the Name field.
  5. Click Save to apply the change.

What You Can Edit​

Display Name​

Your display name is the name shown throughout ProBeya: on items you create, comments you post, assignments, mentions, and board member lists. Changes take effect immediately across the application after saving — the profile data is invalidated and refreshed on all open views.

Names are validated on the client side using the same updateProfileFormSchema schema enforced on the server, so validation errors are shown inline before the save request is sent.

Avatar​

The avatar card displays your current profile image. If no image is set, your initials are derived from your display name and shown as a colored fallback. The first letter of your first name and the first letter of your last name are used — for example, "Jean Dupont" shows "JD".

Avatar upload

Avatar image upload is planned. Currently, the avatar section shows your initials or an existing profile image. Use the Change Avatar button when it becomes available to upload a custom image.

Email Address​

Your email address is displayed in the profile form but cannot be changed from this page. It is the address used for authentication and notification delivery. Email changes require administrator action through the organization member management settings.

How It Works​

Data Flow​

When the settings page loads, the auth.me query fetches your current user profile. The form is pre-populated with your current display name. On save:

  1. The form validates the input using the updateProfileFormSchema.
  2. auth.updateProfile is called with the updated name.
  3. On success, the auth.me cache is invalidated so all components referencing your name (topbar, sidebar, mentions) refresh automatically.
  4. The form's dirty state resets, disabling the Save button until you make another change.

Save Button State​

The Save button is disabled when:

  • The form is in its initial state (no changes since last save or page load).
  • A save request is in progress.

This prevents accidental double-saves and makes the saved state clear without requiring a separate confirmation message.

Permissions​

  • View own profile: all authenticated users.
  • Edit own display name: all authenticated users.
  • Change email: not self-service; requires administrator action.
  • Change avatar: not currently available; planned for a future release.

Tips & Best Practices​

  • Use your real name: ProBeya is a collaboration tool. Using your real name makes it easier for teammates to identify who created an item, left a comment, or is responsible for an action.
  • Keep your name consistent across organizations: if you belong to multiple ProBeya organizations, your profile is shared across all of them. A change to your display name in one organization's settings updates it everywhere.
  • Check your name after first login: if you signed up via SSO, your display name may have been imported from your identity provider. Verify it looks correct before collaborating with teammates.
  • Notifications -- Configure how and when ProBeya contacts you by email or in-app alerts
  • Mentions -- How your display name is used in @mention autocomplete
  • Getting Started -- Initial setup steps for new ProBeya users
  • Workspaces -- Managing workspace membership and roles