Profile Customization

Manage your display name, avatar, and password from the Accounts portal at accounts.studiobrain.ai.

Accessing Profile Settings

1. Navigate to accounts.studiobrain.ai
2. Sign in if prompted
3. Click Settings in the left sidebar
4. Select Profile

Display Name

Your display name appears in shared workspaces, AI-generated credits, and team collaboration panels.

Updating Your Display Name

1. In Profile Settings, find the Display Name field
2. Enter your preferred name (shown to teammates and in exported documents)
3. Click Save Changes

Changes take effect immediately. The display name is stored in the auth database and shown across all StudioBrain surfaces (web, desktop, mobile).

Avatar Upload

Your avatar appears next to your name in team workspaces and collaboration views.

Uploading an Avatar

1. In Profile Settings, locate the Avatar section at the top of the page
2. Click on your current avatar (or the placeholder if none is set)
3. Select an image file from your computer
4. The avatar uploads automatically

Supported formats: JPEG, PNG, WebP

File size limit: 5 MB

Display size: Images are automatically resized to a maximum of 512 x 512 pixels (maintaining aspect ratio) and stored as JPEG.

Where Avatars Are Stored

Uploaded avatars are stored server-side at CONTENT_BASE_PATH/avatars/{user_id}.jpg and served via:

GET /api/files/avatars/{user_id}.jpg

This means your avatar is accessible from any StudioBrain surface — web app, desktop, and mobile — without re-uploading.

Avatar from Google Sign-In

If you signed in with Google and have a Google profile picture, StudioBrain automatically uses it as your initial avatar. You can override it at any time by uploading a custom image in Profile Settings.

Removing or Changing an Avatar

To change your avatar, simply upload a new image — it replaces the existing one. There is no separate “remove avatar” button; uploading a new image is the replacement mechanism.

Password

Password changes apply only to accounts using email/password authentication. If you sign in exclusively with Google OAuth, this section is not available.

Changing Your Password

1. In Profile Settings, scroll to the Change Password section
2. Enter your current password
3. Enter your new password (minimum 8 characters)
4. Re-enter your new password to confirm
5. Click Update Password

If the current password is incorrect, an error is shown and the password is not changed. Passwords are hashed with bcrypt and never stored in plain text.

API Reference

The following backend endpoints back the Profile Settings UI.

PATCH /api/user/profile

Update display name or avatar URL.

Auth: Bearer JWT required

Request body:

{
  "display_name": "string (optional)",
  "avatar_url": "string (optional)"
}

Response:

{
  "user_id": "uuid",
  "email": "user@example.com",
  "display_name": "Updated Name",
  "avatar_url": "/api/files/avatars/{user_id}.jpg",
  "subscription_tier": "indie"
}

POST /api/users/me/avatar

Upload a new avatar image.

Auth: Bearer JWT required

Content-Type: multipart/form-data

Form field: avatar — the image file (JPEG, PNG, or WebP, max 5 MB)

Response on success:

{
  "avatar_url": "/api/files/avatars/{user_id}.jpg",
  "message": "Avatar updated successfully."
}

Error responses:

Troubleshooting

Avatar upload fails with “Invalid file type”

Only JPEG, PNG, and WebP are accepted. Convert your image to one of these formats before uploading.

Avatar upload fails with “File too large”

Compress or resize your image to under 5 MB before uploading. Most avatar images should be well under this limit at typical resolutions.

Display name change does not appear in the desktop app

The desktop app caches your profile locally. Sign out and sign back in to refresh the profile data.

Google profile picture is not showing

If you linked Google OAuth after creating your account, the avatar may not have been auto-populated. Upload a custom avatar through Profile Settings to override.