Skip to content

Set up your profile

Your profile is an optional display layer on top of your GitHub identity. Your GitHub login and avatar are always visible to your team; a profile lets you add your real name, a contact email, and a custom photo so teammates can put a face to a login.

Profiles are global — set it once and it shows in every repository you access.


Open the Profile dialog

Two entry points:

  • Click your avatar in the top-right corner of the GitM task pane header.
  • Settings (⚙️) → Account → Edit Profile…

Profile dialog in the GitM task pane


What you can edit

Field Notes
First name / Last name Shows as your display name on the Team tab and in messages.
Email Optional. Hidden from teammates unless you tick Show my email to the team.
Show my email to the team When checked, your email appears on other people's Team tab. Off by default.
Avatar — Use my GitHub picture Default. No upload required.
Avatar — Use a custom picture Click Upload to choose a photo from disk. Resized to ~256 px.

The header preview updates live as you type or upload, so you can see the result before saving.

Read-only fields (🔒 padlock):

  • GitHub login — your canonical identity, not editable here.
  • Role — set by your CAD admin; managed on GitHub.

Click Save to write changes. Changes appear on your teammates' Team tab within a few seconds.


Where your profile shows

  • Team tab — your display name, optional email, and avatar replace the raw GitHub login. Other team members see the same enriched row.
  • Messaging — your display name and avatar appear in the people list and in DM threads.

Privacy notes

  • Email is never stored in a public location unless you tick "Show my email to the team".
  • Custom avatars are stored in the GitM backend, not in your GitHub repository.
  • Teammates can only read your email if you opt in.

Known limitations

  • Profile data does not load when the add-in is offline. GitM falls back to your GitHub login and GitHub avatar in that case — your profile is restored once connectivity returns.
  • Avatar upload is resized client-side to roughly 256 × 256 px to keep storage small.