| 1 | --- |
| 2 | title: Chat |
| 3 | description: Talk to your team in channels, direct messages and threads, live. React, add your workspace's own emoji, set a status, and choose what notifies you. |
| 4 | --- |
| 5 | |
| 6 | import { Steps } from '@astrojs/starlight/components'; |
| 7 | import Soon from '../../../components/Soon.astro'; |
| 8 | import Conversation from '../../../components/Conversation.astro'; |
| 9 | import Message from '../../../components/Message.astro'; |
| 10 | import Aside from '../../../components/Aside.astro'; |
| 11 | import Card from '../../../components/Card.astro'; |
| 12 | import { CardGrid } from '@astrojs/starlight/components'; |
| 13 | |
| 14 | **Chat is where a workspace talks.** Everyone in a workspace can find its |
| 15 | channels, write in the same threads and message each other directly. You |
| 16 | can ask a teammate a question in a channel or a direct message, and the |
| 17 | answer arrives in the place you asked. |
| 18 | |
| 19 | Chat is open to every member of a workspace, on every plan, the free one |
| 20 | too. People outside it can talk in its [public channels](#public-channels) |
| 21 | and in the channels they are [asked into as guests](#guests). Chat is never |
| 22 | charged: no seats, no per-message price and no history cutoff. |
| 23 | |
| 24 | Open **Chat** in the rail on the left, or go to |
| 25 | `g1t.sh/<workspace>/-/chat`. |
| 26 | |
| 27 | ## A conversation |
| 28 | |
| 29 | Here is a morning in `#web`, a channel for the web app, its releases and |
| 30 | its bugs: |
| 31 | |
| 32 | <Conversation title="# web" topic="The web app, its releases and its bugs"> |
| 33 | <Message name="Priya Shah" time="10:42"> |
| 34 | |
| 35 | Thursday's release is #412, #415 and #417. @dana can you check the invite emails in #412 before then? They change what customers receive. |
| 36 | |
| 37 | </Message> |
| 38 | <Message name="Dana Brooks" time="10:43"> |
| 39 | |
| 40 | On it. I'll reply in a thread here with anything I find. |
| 41 | |
| 42 | </Message> |
| 43 | <Message name="Ana Ruiz" time="10:45"> |
| 44 | |
| 45 | #417 is merged. Charts read correctly in dark mode now. |
| 46 | |
| 47 | </Message> |
| 48 | </Conversation> |
| 49 | |
| 50 | Priya **mentioned** `@dana`, so the message is counted as a mention in |
| 51 | Dana's sidebar and, with the default settings, notifies her. |
| 52 | |
| 53 | Everyone is shown by name. A person is their display name, or their |
| 54 | username as they wrote it when they have none. Their username is on their |
| 55 | card: select a name or avatar to see it. Messages someone sends within |
| 56 | five minutes of each other sit under one name, and each new day starts with a divider. |
| 57 | The sidebar, the people typing, notifications and phone alerts all name |
| 58 | people the same way. |
| 59 | |
| 60 | Messages that agents wrote in a workspace's chat in the past still show |
| 61 | where they were posted, under the name the agent had, or as a deleted |
| 62 | agent. |
| 63 | |
| 64 | ## Channels |
| 65 | |
| 66 | A channel is a named conversation, such as `#web`, `#releases` or |
| 67 | `#support`. Every workspace starts with `#general`, and everyone new is put |
| 68 | in it the first time they open Chat (owners can choose other |
| 69 | [default channels](#workspace-chat-settings)). |
| 70 | |
| 71 | Each channel is one of three kinds, and its mark says which, in the |
| 72 | sidebar, in Browse channels and at the top of the channel: |
| 73 | |
| 74 | | | Workspace `#` | Private 🔒 | Public 🌐 | |
| 75 | | --- | --- | --- | --- | |
| 76 | | Who can find it | Every member, under **Browse channels** | Only the people in it | Every member, and anyone on g1t with its link | |
| 77 | | Who can join | Any member | Only people someone in it adds, or lets in on a [request](#ask-to-join) | Anyone signed in to g1t with a confirmed email address, except someone outside the workspace who was [taken out of it](#public-channels) | |
| 78 | | Who can read it | Every member | Only the people in it | Every member, and anyone signed in to g1t with a confirmed email address | |
| 79 | | Who can make one | Members, unless owners keep it to themselves | Members, unless owners keep it to themselves | Workspace owners | |
| 80 | |
| 81 | Anyone in a channel who is not a member of the workspace shows as a |
| 82 | **Guest**, beside their name on every message, in the channel's people and |
| 83 | in its details, so who is in the workspace is never in doubt. |
| 84 | |
| 85 | ### Create a channel |
| 86 | |
| 87 | <Steps> |
| 88 | |
| 89 | 1. In Chat's sidebar, choose **Create a channel**. |
| 90 | 2. Give it a **name**. Names are what people type after `#`: up to 80 |
| 91 | lowercase letters, digits, dashes and underscores. `Web Team` becomes |
| 92 | `web-team`. |
| 93 | 3. Optionally, say what the channel is for. That line shows under its name. |
| 94 | 4. Under **Who can open it**, choose **Workspace**, **Private**, or (for |
| 95 | workspace owners) **Public**. |
| 96 | 5. Choose **Create channel**. You are its owner and first member. Invite |
| 97 | people once it is made. |
| 98 | |
| 99 | </Steps> |
| 100 | |
| 101 | A workspace's owners can keep creating workspace channels, private channels |
| 102 | or both to themselves ([chat settings](#workspace-chat-settings)). When they |
| 103 | have, **Create a channel** is turned off for everyone else and says why, and |
| 104 | a kind someone may not create is shown turned off, with why. Only owners |
| 105 | make a channel public. |
| 106 | |
| 107 | ### Public channels |
| 108 | |
| 109 | A public channel is open to anyone signed in to g1t with a confirmed email |
| 110 | address: a community, a support desk, an open project's chat. Share its |
| 111 | link, `g1t.sh/<workspace>/-/chat/<channel>`; anyone who opens it reads it, |
| 112 | and **Join** (or simply writing in it) puts it in their sidebar. |
| 113 | |
| 114 | - People outside the workspace talk there as **guests**. They see that |
| 115 | channel and the workspace's other public ones, and nothing else of the |
| 116 | workspace: no other channels, no direct messages, no people directory. |
| 117 | - Only people come into another workspace's channels: not a workspace's |
| 118 | tokens, and not agents. Someone whose email address isn't |
| 119 | confirmed yet is asked to confirm it first, and someone signed out is |
| 120 | asked to sign in. |
| 121 | - **@g1t works for the workspace's members only.** Guests never start a |
| 122 | conversation with g1t, in a public channel or anywhere else, so nobody |
| 123 | outside the workspace spends its AI. |
| 124 | - Only a workspace owner makes a channel public, when creating it or later |
| 125 | from its details: under **Visibility**, turn on **Open to anyone on g1t**. |
| 126 | The switch is there for workspace and public channels that aren't |
| 127 | archived; a private channel stays private. Turning it off keeps the channel to the workspace again: guests |
| 128 | who joined on their own leave it, and guests someone asked in stay. |
| 129 | - A channel's owners and the workspace's owners can take anyone out of it |
| 130 | from its details. Someone outside the workspace taken out of a public |
| 131 | channel cannot join it again on their own; asking them in again lifts |
| 132 | that. |
| 133 | |
| 134 | ### Guests |
| 135 | |
| 136 | A guest is someone outside the workspace in one of its channels. Besides |
| 137 | joining a public channel, someone can be asked into any channel, private |
| 138 | ones too, without joining the workspace: a contractor, a customer, a |
| 139 | friend from another team. |
| 140 | |
| 141 | <Steps> |
| 142 | |
| 143 | 1. Open the channel's details and choose **Add**. |
| 144 | 2. Type their g1t username and choose **Invite @username as a guest**. |
| 145 | 3. They see the invitation in their own Chat sidebar, under |
| 146 | **Invitations**, and choose **Join** or **Decline**. |
| 147 | |
| 148 | </Steps> |
| 149 | |
| 150 | A guest's channels show in their own sidebar under **Other workspaces**, |
| 151 | with their unread counts. Opening one shows that workspace's chat as a |
| 152 | guest sees it, with a **Guest** mark at the top and a way back to their |
| 153 | own. |
| 154 | |
| 155 | Owners can always ask guests in. Members can too, unless owners turned off |
| 156 | **Members can invite outside collaborators** in the workspace's |
| 157 | [permissions](/guides/workspaces/#member-privileges), the same setting as |
| 158 | for repositories. Guests themselves add no one. Pending invitations show in |
| 159 | the channel's details, where whoever may take people out can take one |
| 160 | back. |
| 161 | |
| 162 | ### Ask to join |
| 163 | |
| 164 | Opening the link of a channel you cannot open (a private one, or a |
| 165 | workspace one when you are not in the workspace) shows **You can't open |
| 166 | #channel** and a way to **Ask to join**, with an optional note of up to |
| 167 | 300 characters. The page is |
| 168 | the same whether or not the channel exists, so asking never tells anyone |
| 169 | about a channel they may not see. |
| 170 | |
| 171 | The people who could add you see your request in the channel's details, |
| 172 | with a count on its members button, and choose **Let in** or **Decline**. |
| 173 | Anyone in the channel can let in a member of the workspace; someone outside |
| 174 | it is let in, as a guest, by those who may invite guests. |
| 175 | |
| 176 | ### Join, leave and browse |
| 177 | |
| 178 | - **Browse channels** lists every workspace and public channel, and the |
| 179 | private ones you're in, at `g1t.sh/<workspace>/-/chat/browse`, and at the |
| 180 | end of the sidebar's **Channels**. A guest sees only the public ones, |
| 181 | from **Browse public channels** at the end of the sidebar's **Public |
| 182 | channels**. Choose a channel anywhere on its row to read it, |
| 183 | and choose **Join** to post in it and see it in your sidebar. A private channel |
| 184 | you're not in never appears. |
| 185 | - **Archived**, on the same page, lists archived channels. |
| 186 | - You can leave a channel, and join a workspace or public one again at any time. |
| 187 | - When you join, everything already said counts as read, so a busy channel |
| 188 | doesn't greet you with its whole history as unread. |
| 189 | |
| 190 | ### Rename, archive and change the topic |
| 191 | |
| 192 | Open a channel's details (the members button at the top right) to change |
| 193 | it. |
| 194 | |
| 195 | | Change | Who can | |
| 196 | | --- | --- | |
| 197 | | **Topic** | Any member of the channel. | |
| 198 | | **Rename** | The channel's owners and the workspace's owners, or only the workspace's owners if they chose so in [chat settings](#workspace-chat-settings). The address follows the new name for everyone who has it open. | |
| 199 | | **Archive** | The same people as rename. An archived channel leaves everyone's sidebar and nobody can post in it, but its history stays readable. | |
| 200 | | **Unarchive** | The same people, from the archived channel itself or **Browse channels → Archived**. | |
| 201 | |
| 202 | `#general` is never renamed or archived. Everyone looking at a channel sees |
| 203 | a change to it the moment it is made. |
| 204 | |
| 205 | ### Star and mute |
| 206 | |
| 207 | - **Star** a channel to keep it at the top of your sidebar. |
| 208 | - **Mute** a channel to stop its unread count from drawing your eye. You |
| 209 | still see mentions of you. |
| 210 | |
| 211 | Both are yours alone; nobody else's sidebar changes. |
| 212 | |
| 213 | ## The sidebar |
| 214 | |
| 215 | Chat's sidebar lists, from the top: |
| 216 | |
| 217 | | Section | What's in it | |
| 218 | | --- | --- | |
| 219 | | **Pinned** | Conversations you pinned (hover over one and choose the pin, or right-click it). Only when you have some. | |
| 220 | | **Channels** | The workspace's own channels you're in, workspace and private, by name, then **Browse channels** with how many more you could join. **+** creates one. | |
| 221 | | **Public channels** | The [public channels](#public-channels) you're in, by name, kept apart because anyone on g1t can be in them. Only when you're in some. | |
| 222 | | **Direct messages** | [g1t](#talk-with-g1t) first, then your direct messages, the latest first. The pencil starts a new message. Empty, it says **Message a teammate.** | |
| 223 | |
| 224 | Unread conversations are in bold with a count; mentions of you are counted |
| 225 | in lavender. **All**, **Unread** and **Mentions** filter every section, and |
| 226 | **Jump to channel or person** finds any of them by name. |
| 227 | |
| 228 | Choose a section's name to fold it. A folded section still shows what's |
| 229 | unread and the conversation you have open, and it stays folded on that |
| 230 | device until you open it again. |
| 231 | |
| 232 | ## Direct messages |
| 233 | |
| 234 | A direct message is a private conversation between you and up to eight |
| 235 | other members. Start one with **New message** in Chat's sidebar and pick |
| 236 | who to message. |
| 237 | |
| 238 | - The same group of members always gets the same conversation, whatever |
| 239 | order you pick them in. |
| 240 | - A DM with only yourself is a place for notes. |
| 241 | |
| 242 | ## Talk with g1t |
| 243 | |
| 244 | **g1t** is at the top of your direct messages, with its mark for a face. |
| 245 | Write to it like anyone else and it answers, with your workspace's own AI |
| 246 | provider and the model an owner chose: see [Ask g1t](/guides/ask/) for |
| 247 | setting it up and what it knows. |
| 248 | |
| 249 | - It is the same conversation as **Ask** in the top bar: a question asked |
| 250 | there is posted here with the page it was asked from, and the answer |
| 251 | shows in both places as it is written. |
| 252 | - The answer streams in as g1t writes it. **Stop answering**, over the box |
| 253 | you write in, ends it; what came stays. Writing again while it answers |
| 254 | does the same, and g1t answers your newest words. |
| 255 | - **New conversation**, at the top, leaves a mark: g1t reads only what is |
| 256 | said after it. Everything before stays to read. |
| 257 | - **⋯ → Clear conversation…**, at the top, or `/clear` typed in the box, |
| 258 | deletes everything in it for good, after asking: see |
| 259 | [Clear the conversation](/guides/ask/#clear-the-conversation). |
| 260 | - Under its latest answer, **Answer again** has it answer anew, and |
| 261 | **Copy** copies an answer. Each answer says which provider and model |
| 262 | wrote it. |
| 263 | - Until an owner chooses a provider, g1t replies with where to choose one. |
| 264 | - Only you and g1t are in it: g1t can't be added to a group message or a |
| 265 | channel, and mentioning `@g1t` in a channel doesn't ask it anything. |
| 266 | You can delete g1t's messages in it, as well as your own. |
| 267 | - It notifies you of an answer the way any direct message does, once the |
| 268 | answer is done. |
| 269 | |
| 270 | ## Threads |
| 271 | |
| 272 | Reply to any message to start a thread under it. The thread keeps a side |
| 273 | conversation out of the channel, and the message shows how many replies it |
| 274 | has and when the last one came. |
| 275 | |
| 276 | The **⋯** on a message (hover over it; on a phone, press and hold it) and |
| 277 | the **⋯** at the top of an open thread have **Copy link to thread**: a link |
| 278 | that opens the conversation with the thread beside it, to paste anywhere in |
| 279 | g1t. |
| 280 | |
| 281 | ## Mentions |
| 282 | |
| 283 | Type `@` and a name to mention a person by username: `@priya`, `@dana`. |
| 284 | Suggestions match display names too, so `@Pri` finds Priya Nair. In the |
| 285 | conversation the mention reads as the name people know, `@Priya Nair`, and |
| 286 | opens their card; the message itself keeps `@priya`. A mention is counted |
| 287 | in that person's sidebar separately from other unread messages, so it |
| 288 | stands out. |
| 289 | |
| 290 | An address such as `me@example.com` is never read as a mention. |
| 291 | |
| 292 | ## Format a message |
| 293 | |
| 294 | Messages can have bold, italic and struck-through words, links, inline |
| 295 | code, code blocks, lists and quotes. Format as you write, three ways: |
| 296 | |
| 297 | - **The formatting bar** above the text. **T** at the bottom left of the |
| 298 | composer shows or hides it, and your choice is kept on that device. On a |
| 299 | phone it starts hidden; when it is shown, swipe it sideways for the rest. |
| 300 | - **Shortcuts.** Select words, or start typing after one. The keyboard |
| 301 | button at the end of the bar lists them too. |
| 302 | - **Markdown, typed inline.** It turns into its formatting as you type: |
| 303 | `*bold*` becomes **bold** when you type the closing `*`. |
| 304 | |
| 305 | | Formatting | Shortcut (⌘ on a Mac) | Or type | |
| 306 | | --- | --- | --- | |
| 307 | | Bold | Ctrl+B | `*bold*` or `**bold**` | |
| 308 | | Italic | Ctrl+I | `_italic_` | |
| 309 | | Strikethrough | Ctrl+Shift+X | `~struck~` or `~~struck~~` | |
| 310 | | Link | Ctrl+K | Select words and paste an address over them | |
| 311 | | Inline code | Ctrl+Shift+C or Ctrl+E | `` `code` `` | |
| 312 | | Code block | Ctrl+Alt+Shift+C | ` ``` ` then Enter, or ` ```ts ` to name the language | |
| 313 | | Bulleted list | Ctrl+Shift+8 | `- ` at the start of a line | |
| 314 | | Numbered list | Ctrl+Shift+7 | `1. ` at the start of a line | |
| 315 | | Quote | Ctrl+Shift+9 | `> ` at the start of a line | |
| 316 | |
| 317 | **Ctrl+K** asks where the link goes, and for its text when nothing is |
| 318 | selected. On a link already, it changes the address or removes the link. |
| 319 | A link goes to a web address, an email address or a page on g1t; anything |
| 320 | else is refused. Undo (**Ctrl+Z**) takes formatting back off. |
| 321 | |
| 322 | ### Enter and new lines |
| 323 | |
| 324 | | Key | In a line of text | In a list | In a code block | |
| 325 | | --- | --- | --- | --- | |
| 326 | | **Enter** | Sends | Adds an item; on an empty item, leaves the list | Adds a line; three in a row leave the block | |
| 327 | | **Shift+Enter** | Starts a new line | Adds an item | Adds a line | |
| 328 | | **Ctrl+Enter** | Sends | Sends | Sends | |
| 329 | |
| 330 | In a quote, Enter sends and Shift+Enter starts the next line of the quote. |
| 331 | |
| 332 | ### What a message shows |
| 333 | |
| 334 | Every message is shown with its formatting. |
| 335 | Code blocks with a language g1t knows (`ts`, `rust`, `python`, `sh`, |
| 336 | `sql`, `json` and others) are coloured, and have a copy button. A web |
| 337 | address on its own becomes a link, and links open in a new tab. A heading |
| 338 | shows as a bold line, and a rule as a line across. |
| 339 | |
| 340 | A table written in Markdown shows as a table: a header row, a row of |
| 341 | `---` under it (`:--`, `:-:` or `--:` to line a column up left, centre |
| 342 | or right), then a row per line. A wide table scrolls sideways inside the |
| 343 | message. The composer has no table to edit, so editing a message with |
| 344 | one shows its rows as the lines they were written as. |
| 345 | |
| 346 | ```md |
| 347 | | Session | Length | Who | |
| 348 | | --- | --: | --- | |
| 349 | | Welcome and tour | 45 min | Ana | |
| 350 | | Your first issue | 60 min | Margo | |
| 351 | ``` |
| 352 | |
| 353 | Chat never shows HTML: `<b>` reads as typed. An image written in Markdown |
| 354 | shows as a link to it, not the image. |
| 355 | |
| 356 | ### Messages are Markdown |
| 357 | |
| 358 | What you send is kept as Markdown, the formatting written as `**bold**`, |
| 359 | `_italic_`, `~~struck~~` and so on. That is what you edit when you change |
| 360 | a message, so formatting survives the round trip. Text you paste without formatting, such as from a terminal, is |
| 361 | read as Markdown too; paste with **Ctrl+Shift+V** to keep it exactly as it |
| 362 | is. Notifications, pop-ups and browser notifications show a message's |
| 363 | words without the marks: `**Release** is _done_` reads *Release is done*. |
| 364 | |
| 365 | To show a character that would format, put a backslash before it: `\*` |
| 366 | shows `*`. |
| 367 | |
| 368 | ## Live |
| 369 | |
| 370 | Chat is live. Messages, edits and deletions appear for everyone in the |
| 371 | channel the moment they happen, without reloading. You also see: |
| 372 | |
| 373 | - **Typing.** Who is writing right now, in the channel or in a thread. |
| 374 | - **Channel changes.** A new name, topic, or archiving. |
| 375 | - **Read state.** Your sidebar shows unread counts per channel, and the |
| 376 | channel scrolls to the first message you haven't read. |
| 377 | |
| 378 | If your connection drops, Chat reconnects on its own and fills in what you |
| 379 | missed. |
| 380 | |
| 381 | ## Edit and delete |
| 382 | |
| 383 | You can edit or delete your own messages. On a computer, hover your message, |
| 384 | open its **⋯** and choose **Edit message**: it opens in the composer, in |
| 385 | place, with its formatting. Enter or **Save** keeps the change, Esc or |
| 386 | **Cancel** leaves it as it was. On a phone, press and hold the message and |
| 387 | choose **Edit**. An edited message says so. A deleted message is removed |
| 388 | for everyone; replies under it stay. |
| 389 | |
| 390 | A message can be up to 40,000 characters, and is written in Markdown (see |
| 391 | [format a message](#format-a-message)). |
| 392 | |
| 393 | ## Reactions |
| 394 | |
| 395 | A reaction says *seen*, *agreed* or *done* without another message. |
| 396 | |
| 397 | | Where you are | How to react | |
| 398 | | --- | --- | |
| 399 | | On a computer | Hover a message and choose **React** in the toolbar that appears, then pick an emoji. | |
| 400 | | On a phone | Long-press a message, then pick one of the quick reactions in the sheet, or open the picker. | |
| 401 | | On an existing reaction | Click its pill to add yours. Click it again to take yours back. | |
| 402 | |
| 403 | The picker has a search box, **Recently used**, the standard emoji by group, |
| 404 | a skin tone, and a **This workspace** tab for your |
| 405 | [custom emoji](#custom-emoji). Arrow keys move through it and Enter picks. |
| 406 | |
| 407 | Hover a reaction's pill to see who reacted, such as *Priya, Dana and 3 |
| 408 | more*. Your own reactions are highlighted. |
| 409 | |
| 410 | | Limit | | |
| 411 | | --- | --- | |
| 412 | | Different emoji on one message | 50. More of an emoji already there always fits. | |
| 413 | | What you can react with | One emoji: a standard one, or one of the workspace's own, written `:name:`. | |
| 414 | |
| 415 | ## Custom emoji |
| 416 | |
| 417 | A workspace can add its own emoji: the team's logo, a mascot, an inside |
| 418 | joke. Everyone in the workspace can use them in messages and reactions. |
| 419 | |
| 420 | ### Add an emoji |
| 421 | |
| 422 | <Steps> |
| 423 | |
| 424 | 1. Open the workspace's **Emoji** page: `g1t.sh/<workspace>/-/emoji`. |
| 425 | 2. Under **Add an emoji**, choose an image. It shows in a preview at the |
| 426 | size it appears in messages. |
| 427 | 3. Give it a **name**, such as `shipit`. People type it as `:shipit:`. |
| 428 | 4. Choose **Add emoji**. |
| 429 | |
| 430 | </Steps> |
| 431 | |
| 432 | | | Rules | |
| 433 | | --- | --- | |
| 434 | | File | A PNG, GIF or WebP, up to 256 KB and 512×512 pixels. Animated GIFs and WebPs stay animated. The file's type is read from its contents, not its name. | |
| 435 | | Name | 2 to 32 characters: lowercase letters, digits, `-`, `_` and `+`. Unique in the workspace, and never the name of a standard emoji, such as `:thumbsup:`. | |
| 436 | |
| 437 | Custom emoji images are served from `g1tusercontent.com`, apart from the |
| 438 | site, like avatars. |
| 439 | |
| 440 | ### Aliases |
| 441 | |
| 442 | An **alias** is another name for an emoji you already have: both show the |
| 443 | same image. Under **Add an alias**, pick the emoji and type the new name. |
| 444 | Aliases follow the same name rules. |
| 445 | |
| 446 | ### Who can add emoji |
| 447 | |
| 448 | Owners choose in the workspace's [chat settings](#workspace-chat-settings): |
| 449 | |
| 450 | | Setting | Means | |
| 451 | | --- | --- | |
| 452 | | **Any member** (the default) | Anyone in the workspace can add emoji and aliases. | |
| 453 | | **Owners only** | Members use the workspace's emoji; only owners add them. | |
| 454 | |
| 455 | ### Remove an emoji |
| 456 | |
| 457 | Whoever added an emoji, and the workspace's owners, can remove it with |
| 458 | **Remove** beside it. Removing an emoji removes its aliases too. |
| 459 | |
| 460 | ### Use one |
| 461 | |
| 462 | Type `:` and a couple of letters in the composer, and a list of matching |
| 463 | emoji appears, the workspace's own marked **This workspace**. Up and Down |
| 464 | move through it, Enter or Tab puts the emoji in, and Escape closes it. A whole |
| 465 | `:shortcode:` you type yourself works too. |
| 466 | |
| 467 | ## Workspace chat settings |
| 468 | |
| 469 | A workspace's owners decide what members can do in its chat, under |
| 470 | **Workspace → Chat → Chat settings** (`g1t.sh/<workspace>/-/settings/chat`). |
| 471 | Every member can open the page to see what is allowed; only owners can |
| 472 | change it. g1t enforces each setting, whichever app or API the request |
| 473 | comes from. |
| 474 | |
| 475 | | Setting | Choices | |
| 476 | | --- | --- | |
| 477 | | **Creating channels** | Who can create workspace and private channels (**Any member**, the default, or **Owners only**) is set with the workspace's other permissions, under [Permissions → Chat](/guides/permissions/#chat); this page says what is allowed today and leads there. | |
| 478 | | **Renaming and archiving** | **Channel owners and workspace owners** (the default) or **Workspace owners only**. Any member of a channel can still change its topic. | |
| 479 | | **Custom emoji** | Who can add them: **Any member** (the default) or **Owners only**. | |
| 480 | | **Default channels** | The workspace and public channels someone new is put in the first time they open Chat. `#general` unless owners choose others. People already in the workspace are not moved, and anyone can leave a default channel. | |
| 481 | |
| 482 | Changing a setting doesn't change what already exists: channels already |
| 483 | made stay, whoever made them. |
| 484 | |
| 485 | ## Presence and status |
| 486 | |
| 487 | Everyone you share a workspace with can see whether you're here, and what |
| 488 | you've said about yourself, wherever your name shows: beside a direct |
| 489 | message in the sidebar, on the card over your name, in a channel's member |
| 490 | list, in the workspace's [People directory](/guides/people-and-teams/#the-directory) and after your name on your messages. |
| 491 | It all moves live; nobody has to reload. |
| 492 | |
| 493 | | The dot on an avatar | It means | |
| 494 | | --- | --- | |
| 495 | | Green | **Active**: g1t is open and they've used it in the last 10 minutes. | |
| 496 | | A ring | **Away**: every tab they have open has sat untouched for 10 minutes, or they set themselves away. | |
| 497 | | Amber, with a bar | **Notifications paused**: they're here, but nothing pops up for them until the time they chose. | |
| 498 | | None | **Offline**: no tab of g1t is open. | |
| 499 | |
| 500 | ### Set a status |
| 501 | |
| 502 | Open the menu on your avatar at the foot of the rail (on a phone, **More**, |
| 503 | then **You and help**) and choose **Set a status**. Give it an |
| 504 | emoji and a few words, or pick one: |
| 505 | |
| 506 | | | Clears after | |
| 507 | | --- | --- | |
| 508 | | 🗓️ In a meeting | 1 hour | |
| 509 | | 🚌 Commuting | 30 minutes | |
| 510 | | 🎯 Focusing | 1 hour | |
| 511 | | 🤒 Out sick | Today | |
| 512 | | 🌴 On vacation | Never: it stays until you change it | |
| 513 | |
| 514 | **Clear after** can be 30 minutes, 1 hour, 4 hours, today (your midnight), |
| 515 | this week (the end of your Sunday), never, or a time you choose. When the |
| 516 | time comes your status goes, for everyone at once, whether or not you're |
| 517 | online. Clear it sooner with **Clear status** in the same menu. |
| 518 | |
| 519 | ### Away |
| 520 | |
| 521 | Your dot turns to a ring by itself after 10 minutes without using g1t, and |
| 522 | back to green as soon as you do. **Set yourself away** keeps you away |
| 523 | however much you use it, until you choose **Set yourself active**. |
| 524 | |
| 525 | ### Statuses from other apps |
| 526 | |
| 527 | A status has a source: you, a calendar, or another integration. Calendar |
| 528 | and integration statuses (such as "In a meeting" while one is on your |
| 529 | calendar) are coming with those integrations, which you will connect under |
| 530 | [your integrations](/guides/integrations/#workspace-and-personal). One you set yourself always |
| 531 | wins: a calendar never replaces or clears it. <Soon /> |
| 532 | |
| 533 | ## Notifications |
| 534 | |
| 535 | g1t tells you when something is for you, wherever you are in the app. |
| 536 | |
| 537 | | | | |
| 538 | | --- | --- | |
| 539 | | **Pop-ups** | While g1t is open in any tab, a message for you pops up in the corner, whichever page you are on: a DM, a mention, a reply in your thread, a review requested. Reply from the pop-up without leaving the page, or open the conversation. | |
| 540 | | **Sounds** | A short sound when something is for you: a message in a conversation you have open but are not looking at, a direct message, a mention. Which, and how loud, is yours to set; see [Sounds and do not disturb](#sounds-and-do-not-disturb). | |
| 541 | | **Counts** | The rail's Chat badge and each conversation's unread and mention counts update live, in every open tab. | |
| 542 | | **Browser notifications** | Turn them on, and this browser shows a notification when you're away from g1t, even with every tab closed. g1t never pushes to a browser where you're already looking at g1t. | |
| 543 | |
| 544 | ### Choose what you hear about |
| 545 | |
| 546 | Open **Settings → Notifications** (`g1t.sh/settings/notifications`): |
| 547 | |
| 548 | | Notify me about | You hear about | |
| 549 | | --- | --- | |
| 550 | | **DMs and mentions** (the default) | Direct messages, mentions and replies in your threads. | |
| 551 | | **Everything** | Every message in conversations you're in, and everything in your notifications. | |
| 552 | | **Nothing** | No pop-ups or browser notifications. Counts still update. | |
| 553 | |
| 554 | Under **For a workspace**, you can give one workspace a different level, |
| 555 | such as **Everything** for a small team and **DMs and mentions** for a big |
| 556 | one. **Send a test notification** shows you what one looks like. |
| 557 | |
| 558 | ### Sounds and do not disturb |
| 559 | |
| 560 | Chat makes a sound when something is for you, and only then. Each sound is |
| 561 | short (under a quarter of a second), warm and two-toned, made by g1t |
| 562 | itself: nothing is downloaded. What plays when: |
| 563 | |
| 564 | | Sound | When | |
| 565 | | --- | --- | |
| 566 | | **New message** | A message in a conversation you have open, while the window is behind another or you are in another conversation. | |
| 567 | | **Direct message** | A direct message from someone else. | |
| 568 | | **Mention** | A message that @mentions you. It wins over the other two. | |
| 569 | | **Sent** | A soft tick as your message goes. Off until you turn it on. | |
| 570 | |
| 571 | The rules behind them: |
| 572 | |
| 573 | - Nothing sounds for the conversation you are looking at in a window that |
| 574 | is in front: what is on screen is silent. |
| 575 | - Nothing sounds for your own messages, in a conversation you |
| 576 | [muted](#star-and-mute), or while Do not disturb is on. |
| 577 | - At most one sound every 1.5 seconds: a burst of messages is one sound, |
| 578 | and the same message never sounds twice. |
| 579 | - Browsers allow sound only after you have clicked or typed on the page, |
| 580 | so the first message after a page opens may be silent. |
| 581 | |
| 582 | Open **Settings → Notifications** (`g1t.sh/settings/notifications`), |
| 583 | under **Sounds & notifications**, to change them. The settings are kept |
| 584 | with your account, so every device you sign in on sounds the same: |
| 585 | |
| 586 | | Setting | What it does | Default | |
| 587 | | --- | --- | --- | |
| 588 | | **Sounds** | Whether anything plays at all. Counts and pop-ups still show. | On | |
| 589 | | **Sound set** | **Soft** (warm and low) or **Bright** (higher and shorter). Press play by any sound to hear it. | Soft | |
| 590 | | **Volume** | From 0 to 100. | 60 | |
| 591 | | **New message**, **Direct message**, **Mention**, **Sent** | Each sound on or off. | All on but Sent | |
| 592 | | **Do not disturb** | Off, or for 30 minutes, an hour, two hours, or until tomorrow at 9:00 your time. | Off | |
| 593 | | **Desktop notifications** | While this window is behind another, a message to you shows as a system notification from the open tab. Turning it on asks the browser's permission once, from this switch and never when a page loads. Not offered where browser notifications above are on: those already show it. In [the desktop app](/guides/desktop/) it is on, and the app shows them itself. | Off | |
| 594 | |
| 595 | **Do not disturb** is one thing everywhere: the bell-off button at the top |
| 596 | of the chat sidebar, **Pause notifications** on the menu on your avatar, |
| 597 | and the setting above all set it. While it holds, nothing sounds, nothing |
| 598 | pops up and no browser notification is sent, whatever your settings; |
| 599 | counts and your notifications still update, the bell in the top bar shows |
| 600 | a small amber dot, and everyone sees your amber dot. It ends on its own at |
| 601 | the time you chose; **Resume notifications**, or **Off**, ends it early. |
| 602 | |
| 603 | At most three pop-ups show at once. Each stays six seconds, and stays while your pointer or keyboard is on |
| 604 | it. Nothing pops up for the conversation you have open. |
| 605 | |
| 606 | g1t never asks to show browser notifications when a page loads. After |
| 607 | your first pop-up for a DM or a mention, it offers once: **Get notified |
| 608 | when someone messages you**. If you say no, it doesn't ask again; turn |
| 609 | them on later under **Settings → Notifications**. |
| 610 | |
| 611 | [Notifications](/guides/notifications/) are separate: they keep every item until you |
| 612 | deal with it, whatever these settings say. |
| 613 | |
| 614 | ## Coming soon |
| 615 | |
| 616 | These are planned and not built yet: |
| 617 | |
| 618 | <CardGrid> |
| 619 | <Card title="Cards for everything" icon="layout-list"> |
| 620 | Pull requests, checks, deploys and approvals as cards in the channels |
| 621 | linked to a project, with their buttons working in place. <Soon /> |
| 622 | </Card> |
| 623 | <Card title="Mentions in Notifications" icon="bell"> |
| 624 | Mentions as items in [Notifications](/guides/notifications/), so |
| 625 | acting in either place settles both. <Soon /> |
| 626 | </Card> |
| 627 | <Card title="Files" icon="paperclip"> |
| 628 | Files uploaded to a conversation, under the workspace's file rules. |
| 629 | <Soon /> |
| 630 | </Card> |
| 631 | <Card title="Search" icon="search"> |
| 632 | Messages in [site-wide search](/guides/search/), with only what you can |
| 633 | read. <Soon /> |
| 634 | </Card> |
| 635 | <Card title="Desktop app" icon="monitor"> |
| 636 | g1t in a window of its own, with notifications from your system and a |
| 637 | badge on the icon: [the desktop app](/guides/desktop/). On a phone, |
| 638 | [the phone app](/guides/mobile/) has Chat in full, with notifications. |
| 639 | </Card> |
| 640 | </CardGrid> |
| 641 | |
| 642 | ## Next |
| 643 | |
| 644 | - [Notifications](/guides/notifications/): everything waiting for you, in |
| 645 | one place, until you deal with it. |
| 646 | - [People and teams](/guides/people-and-teams/): the workspace's |
| 647 | directory, profiles and teams. |