Team Chat workspace welcome — a hello for new members, a photo, and the history behind them
Three things make a workspace feel like a place rather than an empty room. - A line when someone joins. Their arrival appears in the workspace's default channel as "Ada joined the workspace — say hi", so the team knows to greet them. - A welcome message, once. If an owner or admin writes one in Workspace settings, each person sees it in a small window the first time they open the workspace. Dismissing it is permanent for that person. - A workspace photo. Uploaded in the same settings screen, it shows wherever the workspace appears in the workspace switcher.
On this page
Writing the welcome message
- Open the workspace you own or administer.
- Open Workspace settings (the gear in the Team Chat sidebar header's ⋯ menu).
- On the General tab, under Welcome message, type your greeting.
- Choose Save welcome message.
Rules that matter:
- 1,000 characters. The box counts as you type and will not accept more.
- Only owners and admins can write it. The server checks the role again when the save arrives, so a member cannot set it by any route.
- Empty means none. Clear the box and save, and nobody sees a welcome window.
- Whitespace is trimmed before it is stored, so a message that is only spaces counts as none.
What a new member sees is exactly your text, with its line breaks kept, under the title Welcome to <workspace> and a single Got it button.
When someone joins
The join happens through an invite code. Once the membership is committed, the workspace writes a greeting line into its default channel (#general):
Ada joined the workspace — say hi
That message is a membership divider, the same kind of line channel joins already produce, so it reads in the reader's language and names Ada from the live member directory rather than a frozen name string. It is written after the join, not as part of it: if writing it fails, the person is still a member and the only thing missing is the line.
The welcome message itself is not a channel message — it is a one-time window for the person who just joined, so a busy #general never fills with copies of it.
The workspace photo
Workspace settings → General → Workspace icon uploads, changes or removes the photo. It accepts PNG, JPEG, GIF and WebP up to 5 MB, is re-encoded down to 256 pixels on its longest edge for speed, and is stored per workspace the same way custom emoji images are, in the workspace's own storage folder. The switcher, the sidebar and the workspace header draw it wherever the workspace name appears; without one they fall back to the workspace's colour tile.
Recent history for a new channel member
Someone added to a channel can read what was said in it before they arrived. This is already true on the current server rules — reading a channel's messages requires workspace membership and channel visibility, with no "joined at" cutoff — so nothing had to change for it, and no setting turns it off. Private channels stay invisible to anyone who is not a member.
Where this lives
| Part | File |
|---|---|
| Join line (server) | firebase/functions/src/team-chat/chat-workspaces-join-welcome.ts |
| Welcome message save (server) | firebase/functions/src/team-chat/chat-workspaces-welcome.ts |
| Settings editor | src/renderer/src/features/team-chat/WorkspaceWelcomeSettings.tsx |
| Once-only window | src/renderer/src/features/team-chat/WorkspaceWelcomeGate.tsx |
| Length rule shared by both sides | src/shared/team-chat/workspace-welcome.ts |
The 1,000-character cap exists in two places by necessity — the renderer counts characters as you
type, and the server refuses anything longer — and a test pins them together
(workspace-welcome-rules.test.ts). The "shown once" marker is kept per person and per workspace
on the computer they read it on, so a second computer shows it once too.
Last verified 2026-11-20