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…

What you can edit¶
| Field | Notes |
|---|---|
| First name / Last name | Shows as your display name on the Team tab and in messages. |
| 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.