Use Google Chat with a screen reader

Introduction

This article is divided into sections with headings. Use the links below to jump to a specific section of the article.

• Quick start
• Getting started
• About the Chat interface
• Navigate around Main Chat content
• Complete common tasks in Chat with a screen reader

Quick start

This article is for the chat.google.com page and has lots of great information to help you use Chat. It can take time to read the entire article. If you want to get started fast, use these quick tips to read and send messages in direct messages and Spaces.

• For JAWS: Turn off Virtual cursor.
• For NVDA: Switch to focus mode.
• For ChromeOS: Turn off sticky mode.
• For MacOS: Turn off quick nav.

To read chats you receive:

1. Press the h key, then c to move focus to the list of chats.
   • If focus does not move:
     1. Press ? to open the keyboard shortcuts dialog,
     2. Press Tab to the Enable link,
     3. Press Enter,
     4. Press Escape to try again.
2. Press the Up or Down arrow until focus is on the desired chat.
3. Press Enter to open the chat and move focus to the reply box to type messages.
4. Press Escape to exit the reply box and move focus to the list of messages.
5. Press the Up or Down arrow to review the messages.
6. Press the r key to move focus to the reply box.

To start a chat with someone:

1. To start a direct message, search your contacts.
   • For Chrome OS and Windows: Press Ctrl + Shift + k.
   • For macOS: Press Command + Shift + k.
2. Enter the name or email address of the person you want to chat with.
   • If you hear an exact match, press Ctrl + Enter.
   • To explore close matches, press the Down arrow.
3. Focus moves to the reply box.

Tip: If you’re not in Edit mode, the q shortcut works the same as Ctrl + Shift + k (Command + Shift + k on macOS).

To read Spaces:

1. Press h, then r to move focus to the list of Spaces.
   • If focus does not move:
     1. Press ? to open the keyboard shortcuts dialog,
     2. Press Tab to the Enable link,
     3. Press Enter,
     4. Press Escape to try again.
2. Press the Up or Down arrow to find the desired Space.
3. Press Enter to move focus to the Space:
   • If focus lands on an edit field: The Space can also have threads.
   • If focus lands on a message: The legacy Space has topics.

Tip: New spaces can’t include topics.

To read Spaces with threads:

1. To focus on the most recent message in the main conversation, press Escape.
2. To read messages in the main conversation, press the Up or Down arrow.
   • If the message is a thread, then “<nn> replies�� is after the message text.
   • If the message is a thread with unread replies, the beginning of the output is “<nn> unread” followed by the sender and message.
   • If the message isn’t a thread, then “<nn> replies” or “<nn> unread” isn’t part of the output.
   • Every message in the main thread can be the beginning of a thread.

To read a thread:

1. Press the Right arrow to open the thread and move focus to the most recent unread message.
2. Press the Up arrow to read older messages and the Down arrow to read newer messages.
3. Press r to move focus to the Reply edit field. Type a message and press Enter to add a message to the thread.
4. Press Escape to move focus from the reply edit field to the messages in the thread.
5. Press the Left arrow to return to the messages in the main thread.
6. To add a message to the main thread, press Ctrl + s (Command + s on Mac) with focus anywhere in the Space.

To find recently updated threads:

1. With focus in a Space, but not in an edit field, press h then t.
   • Focus moves to the thread with the most recent reply in a list of threads for that Space.
2. Press the down arrow to move to threads with older replies.
3. To read the recent replies, press the right arrow to open the thread.
4. To reply to the thread, press r or Enter in the threadlist to move focus to the reply edit field.

To read Spaces with topics:

1. To focus on different topics, press the Up or Down arrow.
2. To open the desired topic, press the Right arrow.
3. To read the messages in the topic, press the Up or Down arrow.
4. To return to the list of topics, press the Left arrow.
5. To reply to the messages in the topic, press r.
6. To start a new topic, with focus anywhere in a Space, press Ctrl + s (Command + s on Mac).

Getting started

Recommended browser and screen readers

Google Chat recommends Chrome and:

• NVDA or JAWS on Windows
• ChromeVox on ChromeOS
• VoiceOver on MacOS

Use Chat as a web application

You can use chat.google.com as a web application rather than a webpage. When you use chat.google.com as a web application:

• Turn off the screen reader web browsing shortcuts. For details, go to Set up your screen reader below.
• Use Chat’s keyboard shortcuts to navigate and read instead of your screen reader’s commands. For details, go to Navigate around Chat below.

Tip: There are times when you should use chat.google.com as a web page and use screen reader browser commands. We point out these times as they occur.

Set up your screen reader

Some screen reader setup is required to use Chat as a web application:

• JAWS: Turn off the Virtual cursor. Press Insert + z until you hear "off."
• NVDA: Turn on focus mode. Press Insert + Spacebar until you hear a click sound like typing on a keyboard.
• ChromeVox: Turn off sticky mode. Quickly press Search twice until you hear "sticky mode disabled."
• VoiceOver: Turn off quick nav. Press Left + Right arrow until you hear "quicknav off."

Open Chat

Go to chat.google.com. When you open Chat, the keyboard focus is on a list of messages in the “Home” list inside the Main landmark. The first time you open Chat, you may want to explore it as a webpage as described in the next section. After you complete your exploration, we recommend you switch to use Chat as a web application as described in Set up your screen reader above.

About the Chat interface

In Chat, there are 4 main areas:

• Top, presented by your screen reader as a Banner landmark: Contains general settings and controls, such as your status, a search bar, and the Google bar to switch to other apps and user accounts.
• Left navigation area, presented as a Navigation landmark: On the left, you can find headings for Shortcuts, Direct messages, and Spaces.
• Chat content, presented as a Main landmark: Contains the most recent messages in the Home section, the currently selected Chat conversation, or Spaces content. This area also includes a list of past messages, a Message edit field for new messages, and action buttons.
• Right side panel, presented as a Complementary landmark: Provides embedded access to other Google products, like Calendar, Keep, Tasks, and Contacts.

Shortcuts

Shortcuts include 3 sections:

Home:

• When you first open Chat, keyboard focus lands on the first message in the list of messages in the Home section.
• The first messages in Chat or Spaces are likely the ones that you haven’t read yet and later messages in the list are older.
• To open that message in the Direct message or Space, press Enter.
• To return to the list of messages in Home, after you read or reply, use normal navigation as below or the browser back.

Mentions:

• This section has a list of most recent messages in Chat or Spaces that mention you using the at-sign.

Starred:

• This section is the list of messages you have “Starred” by using the “More actions” menu for any message. Learn more about starring a message.

From the list of messages in any of the Shortcuts sections:

• To navigate the section heading, press the Left arrow.
• To navigate to the Mentions and Starred section headings, use the Down arrow.
• To navigate to the list of messages in that section, press Enter or the Right arrow.

Tip: If focus doesn’t move to the list of messages from Home, Tab multiple times to the Unread switch, press Space to turn it off, then Tab to the list of messages.

Direct messages

Chats with one person or a group create a list of messages. By default, History is off and messages disappear 24 hours after they arrive. Spaces are for active long-term conversations with a team or group of people. History is on by default.

Spaces with topics or threads

Important: You can no longer create a space organized by topics. Instead, new spaces use threads.

In a space organized by topic, there’s a single panel with a 2-level tree of topics and conversations that each have 1 or more messages. The first level is the topic, and the second level includes all the messages about the topic.

In a space organized by threads, the main panel lists conversations where each message can be the start of a thread. A thread is a set of replies to a message in the main conversation that is presented in a right-side panel.

Navigate around Main Chat content

Chat and Spaces content have 2 modes: Edit and Navigation. When focus is on the reply box, Chat is in Edit mode. To switch from Edit to Navigation mode, press Escape.

Tab and Arrow keys behave differently in each mode:

• In Edit mode: The Up arrow moves to the last posted message and allows you to edit and resend it.
• In Navigation mode:
  • Up arrow moves to the most recent message and then to older messages.
  • On a message, the Tab key navigates to buttons like: Add reaction (an emoji), Edit message (if you posted it), Mark as unread, and More actions.
  • In a Space with Threads:
    • Move to older messages within the main conversation or within a thread with the Up arrow.
    • Move to newer messages within the main conversation or within a thread with the Down arrow.
    • Move to the replies in a thread in the right panel with the Right arrow.
    • Move back to the message that started the thread in the main conversation with the Left arrow.
  • In a Space with Topics:
    • Move within a Topic with an Up or Down arrow.
    • Move to the list of Topics with Left arrow, then Up or Down arrow between Topics.
    • Move to the messages in a Topic with the Right arrow.

Basic navigation

Tab and Arrow keys work for basic navigation. For additional Chat navigation, you can use these commands:

• In the Left navigation area for Chat:
  • Up or down arrow to select a Shortcut section, Direct message conversation, or Space.
  • Shift + Up or Down arrow to move to previous or next unread conversation.
  • Ctrl + Up or Down arrow to move between Shortcuts, Direct messages, or Spaces.
• If focus is on a Chat or Space conversation:
  • Right arrow to the oldest unread message.
  • Enter to move focus to the edit field to add a message.
• In the Main message area:
  • Use the Up or Down arrow to move within the messages.
  • Use the Left arrow to move to the Left navigation area.
  • In a Space, use the right arrow to move into a topic or thread.
• When focus is on the Message edit field:
  • Up arrow to edit the last message you sent.
  • Escape and then Up or Down arrow to go through all messages.
• When focus is on the topics of a Space:
  • Left arrow to move to the Left navigation area.
  • Right arrow to move to the messages of the selected topic.
• On a threaded Space, if focus is on a thread message: Left arrow to move the focus to the main conversation.
• When you press Enter on a Space without topics, focus goes to the Message edit field of the main conversation. When you press Enter on a message in the main conversation, focus moves to the edit field for the thread that starts with that message.

Advanced navigation

To improve your efficiency, use additional keyboard shortcuts.

Show a full list of keyboard shortcuts in Chat

1. Turn off virtual cursor or browse mode in your screen reader.
2. Press Escape if focus is on a Message edit field.
3. Press the question key (Shift + Slash).

To read the keyboard shortcuts dialog, use Chat as a web page. Turn on virtual cursor or browse mode in your screen reader. The list of keyboard shortcuts is in a table, so use your screen reader’s table-reading commands for easier navigation. The first tab stop is a link you can activate to enable or disable some keyboard shortcuts. Make sure the link says Disable, so the extra keyboard shortcuts are available. When done, turn off virtual cursor or browse mode. To dismiss the dialog, press Escape.

In a new browser tab, you can open Google Chat keyboard shortcuts.

Popular shortcuts

Shortcuts are for Chrome and Windows devices. For Mac, use the Command key instead of Ctrl, and the Option key instead of Alt.

• With a screen reader, you can read each of the last 9 messages in a Chat conversation, a Spaces topic, or the main Spaces conversation with Alt + {number}. For ChromeVox, use Alt + Shift + {number}. For VoiceOver, use Option + {number}. Replace {number} with 1 for the most recent message, 2 for the next most recent, and so on. Focus doesn’t move.
• To move focus to the most recent message in a conversation, press Ctrl + j (Command + j on Mac).
  • This works regardless of Edit mode and can be used in place of Escape as described in basic navigation above.
• To move focus to your Chat messages in the Left navigation area, press h then c.
• To move focus to your Spaces messages in the Left navigation area, press h then r.
• To open and move focus to the list of active threads in a threaded Space, press h then t.

• To add, create, or find a person, group, or Space, press Ctrl + Shift + k (Command + Shift + k on Mac). If you’re not in Edit mode, the q shortcut works the same as Ctrl + Shift + k (Command + Shift + k on Mac).

  • To add or create, press the Down arrow to the desired option.
  • To find an existing conversation, type a part of the name and then Down arrow to the desired match.
• To find people, spaces, or messages, press the Slash key when not in Edit mode.
• To start a new topic in a Space, a new message in a Chat, or in the main conversation of a threaded Space, press Ctrl + s (Command + s on Mac).
• To open a Chat or Space menu, press Ctrl + g (Command + g on Mac). For details, go to Access message and Spaces options.
• To reply to a conversation in Chat, a thread in a Space, or a topic and move focus to the Message edit field, press r.

For more on interactions with different elements, go to Complete common tasks in Chat below and refer to the documentation for your screen reader.

Complete common tasks in Chat with a screen reader

Direct messages

Direct messages, also called DMs and Chat, are conversations between you and one or more people. In direct messages, the message list only has one level.

Read a direct message

1. Press Escape, then h then c to move to the Chat section of the Left navigation area.
2. Press Up or Down arrow to select the person whose message you want to read and then press Enter.
3. Press Escape to switch to Navigation mode.
4. Press Up or Down arrow to review previous messages in the chat.
5. If the message includes a link, press Tab to move focus to the link, then press Enter to open the link.

To review recent messages but keep focus on the main reply box:

• For Windows: Press Alt + {number}.
• For ChromeOS: Press Alt + Shift + {number}.
• For MacOS: Press Option + {number}.
• Replace {number} with 1 through 9 for the 9 most recent messages.

Switch between direct messages

To find a person or group you messaged:

1. To open the “Add 1 or more people” combo box, press Ctrl + Shift + k (Command + Shift + k on Mac).
2. Type the name of the person or group you want to find. As you type, Chat verbalizes the name.
3. Choose a name:
   • If Chat verbalizes the name you want, press Ctrl + Enter (Command + Enter on Mac).
   • If Chat doesn’t verbalize the name you want, press Down arrow until you hear the name and then press Ctrl + Enter (Command + Enter on Mac).
   • If you still don’t hear the person’s name, type their entire username and press Enter.

To open a message in the prior messages list:

1. Press Escape and then Left arrow to move to the Left navigation area.
2. Press Up or Down arrow until you find the person you want to message.
3. Press Enter.

Tip: As you move through the Left navigation area, you’re told if there are unread messages for the direct message or Space. To move to the next unread message, press Shift + Down arrow.

Reply to a direct message

1. Use the steps in earlier sections to find or navigate to the person you want to reply to. From Navigation mode, press r to move focus back to the main reply box.
2. Type message text and then press Enter.
3. When not in Edit mode, you can react to a message with an emoji:
   1. Press Tab to the “Add reaction” button and press Space.
   2. Type part of the name of an emoji.
   3. Press Tab twice to the list of matches.
   4. Press Down arrow to the emoji you want and press Enter.

Use a smart reply

Important: Some messages don’t have smart replies available.

1. With focus on the Message edit field, press Shift + Tab until you reach one of the 3 suggested reply buttons.
2. Press Spacebar to select a reply and load it into the Message edit field.
3. Add additional content if desired, then press Enter to send the reply.

Send a direct message to multiple people

1. To start a direct message to multiple people, press Ctrl + Shift + k (Command + Shift + k on Mac) to search your contacts.
2. Type the name of the person you want to add. As you type, Chat verbalizes the name.
3. Choose a name:
   • If Chat verbalizes the name you want, press Ctrl + Enter (Command + Enter on Mac).
   • If Chat doesn’t verbalize the name you want, press Down arrow until you hear the name and then press Ctrl + Enter (Command + Enter on Mac).
   • If you still don’t hear the person’s name, type their entire username and press Enter.
4. Repeat steps 3 and 4 to add all of the people to the message.
5. To move focus to the main reply box in the new Chat, press Enter.
6. Type your message and then press Enter.

Edit a posted message

1. To edit the most recent message you posted, from the Message edit field, press the Up arrow.
2. Edit the message:
   • To re-post, press Enter.
   • To cancel changes, press Escape.

Turn history on or off for a direct message

If allowed by your administrator, you can decide to save your message history. You hear if history is on or off when you focus on the main reply box of the conversation.

1. In the Left navigation area, select the conversation that you want to change history settings for and press Enter.
2. Press Ctrl + g (Command + g on Mac) to open the conversation menu.
3. Down arrow to "History" and press Spacebar or Enter to change the current setting. Some History settings can’t be changed.

Spaces

Spaces are for active long-term conversations with a team or group of people. The membership of a Space may change over time as people join or leave the conversation.

All new Spaces have a main conversation like Chat. Any message in that conversation can become the beginning of a side conversation called a thread. Threads are presented in a right-side panel that opens as needed.

Some legacy Spaces have 2 levels:

• Level 1 is the list of conversation topics.
• Level 2 is messages in a topic.

When you open a Space with topics, the focus is on the oldest unread topic. If there are no unread topics, the focus is on the most recent topic.

Tip: There’s no main conversation in a legacy Space with topics, and all messages must be in a topic.

Read messages in Spaces

1. If focus is on an edit field (Edit mode), press Escape to switch to Navigation mode.
2. Press h then r to move to the Spaces section of the Left navigation area.
3. Press the Up or Down arrow until you reach the Space you want or use the Shift + Up or Down arrow to move to Spaces with unread content. Then press Enter.
4. If the Space has no Topics, focus moves to the main reply box like a Chat message.
5. If the Space has Topics, press the Up or Down arrow to navigate the different Topics.
6. Press the Right arrow to open a topic or a thread.
7. Press the Up or Down arrow to read  the messages.
8. Press the Left arrow to return to the topic or main conversation.

Read recently updated threads

1. With focus in a Space, but not in an edit field, press h then t.
   • Focus moves to the thread with the most recent reply in a list of threads for that Space.
2. To move to threads with older replies, press the Down arrow.
3. To read the recent replies and open the thread, press the Right arrow.
4. To return to the list of threads, press Escape.

To review recent messages without moving focus:

• For Windows: Press Alt + {number}.
• For ChromeOS: Press Alt + Shift + {number}.
• For MacOS: Press Option + {number}.
• Replace {number} with 1 through 9 for the 9 most recent messages.

Tip: These shortcuts aren’t available in a thread.

Reply to messages in Spaces

1. To move focus to the reply box, press the r shortcut.
   • If focus was in the main conversation: This replies to the thread anchored by the main conversation message.
   • If focus was in a thread: This replies to that thread.
   • If focus was in a topic: This replies to that topic.
2. Type your message and then press Enter.
3. To go to the last message in the main conversation or to the last topic, press Ctrl + j (Command + j on Mac).

Tip: In Spaces, you can also Use a smart reply.

Create a conversation Topic in a Space

1. Move focus to any Topic.
2. To focus on the main reply box, press Ctrl + s (Command + s on Mac).
3. Type message text that describes your new Topic and then press Enter.

Your message becomes the first message in the Topic and the name of the Topic.

Tip: You can verify that you will create a new Topic by the name of the focused edit field:

• A new Topic is named "Message" followed by the Space name.
• A reply to an existing Topic is named "Reply."

Tip: This shortcut moves focus to the edit field for the main conversation in a Space without topics.

Create a Space

1. Press Ctrl + i (Command + i on Mac) to open the "Create a Space" dialog.
2. Type the required "Space name."
3. To create a Space with you as the only member, press Enter.
4. For other options, press Tab to:
   • Add a Space description.
   • Add people or groups to the Space.
   • Specify who can join the new Space.
   • Specify if people outside your work or school can join the Space.
   • Activate the Cancel or Create buttons.

Join an existing Space

1. Press Ctrl + o (Command + o on Mac).
2. Type any part of the name.
3. Use the Up or Down arrow to move through the list of Spaces.
4. When you find one you want, press Tab to the "Space joined" checkbox and press Spacebar to check.
5. Press Enter to join and open the new Space.

Add people to a Space

1. Open the Space you want to update.
2. Press Ctrl + g (Command + g on Mac) to open the Space menu.
3. Press Down arrow to move to "Manage members" and then press Enter.
4. Tab to the Add button and press Enter.
5. Type the name of the person you want to add. As you type, you hear the first name that matches.
6. Choose a name:
   • If Chat verbalizes the name you want, press Ctrl + Enter (Command + Enter on Mac).
   • If Chat doesn’t verbalize the name you want, press Down arrow until you hear the name and then press Ctrl + Enter (Command + Enter on Mac).
   • If you still don’t hear the person’s name, type their entire username and press Enter.
7. Press Tab until you get to the Add button and press Enter.

Files in a Space

To post files in a Space for discussion or to share with the members of the Space, move focus to an edit field. To move focus to the "Google Workspace tools" button, where you can add a Drive file or Calendar invite, press Shift + Tab.

To view files posted by others, press Ctrl + g (Command + g on Mac) to go to the Space menu, and then Tab several times to the Chat tab. Press the Right arrow to the Files tab and then press Enter. When you open the Files tab, focus moves to the "Add File" button. If any files are shared, you can Tab through the 3 elements for each file:

1. File details: The file name, who posted it, and when. Press Enter to open the file in a new browser tab.
2. Option to "Move within Drive" or "Add shortcut to Drive."
3. Option to "View in Chat," which moves focus to where the file was added to give context.

Apps

Important: To use apps in Google Chat, you must use a work or school account and your Google Workspace administrator must give permission to install apps.

Apps are special accounts you can chat with, just like you would with people. You can connect with apps in a conversational way to look up information, schedule meetings, or do other tasks. Google creates and maintains some apps like the Google Meet and Google Drive apps. Third-party software vendors create and maintain other apps.

Find apps

1. To search your contacts, press Ctrl + Shift + k (Command + Shift + k on Mac).
2. Press Down arrow until you get to "Find apps" and press Enter.
3. Type a partial name, or use the Tab and Arrow keys to explore offered content.
4. Press Enter on an app and explore the description in the dialog. Initial focus is on the button to add the app to Chat.
5. Press Enter to add this app to your set of Chat conversations.
6. To add the app to a Space:
   1. Press Tab to the "Add to Space" button.
   2. Press Enter to open the "Enter the space name" dialog.
   3. Type a partial name or press Down arrow to the Space you want to add the app to.
7. After activating one of the buttons, the app is added and the dialog is dismissed.

Tip: This is how to find an app and add it to either a Chat or a Space. The next section is how to add an app to the current Space without extra steps.

Add an app to a Space

1. Open the Space you want to update.
2. Press Ctrl + g (Command + g on Mac) to open the menu.
3. Press Down arrow until you get to "Apps & integrations" and then press Enter.
4. Press Tab to the “Add apps” button and press Enter.
5. Type the name of the app you want to add. As you type, you hear the first name that matches.
6. Choose a name:
   • If you hear the name you want, press Enter.
   • Press Down arrow until you hear the name you want and then press Enter.
7. Press Tab until you get to the Add button and then press Enter.

Message an app in a Space

1. Open the Space that has the app.
2. To focus on the main reply box, press Ctrl + s (Command + s on Mac).
3. Type "@appname" followed by your message. Replace "appname" with the name of the app.
4. Press Enter, then wait for it to respond.

See the commands that you can use with an app

• In a direct message with the app, type "help."
• In a Space, type "@appname help." Replace "appname" with the name of the app.

Search

To search for content within Chat, use chat.google.com instead of mail.google.com:

1. Press Slash when not in Edit mode.
2. Type the search term and the first matches are people, groups, or Spaces.
3. Press Up arrow to jump to the last option for "More search results."
4. Press Enter to display all messages that include your search term. Results are in chronological order with the most recent result first.
5. Press Down arrow to the messages that include your search term.

Tip: Activate a result to go to the Chat message or Spaces Topic that includes the result. Use the browser back shortcut to return to the search results. Use the browser back shortcut again to exit the search results.

Change notification settings

You can change how you're notified from the Chat app, or per conversation. Conversation options are described in Access message and Spaces options below.

To open Settings for the Chat app:

1. Press Escape to switch to Navigation mode.
2. Press Slash to move focus to the "Find people, spaces, and messages" field.
3. Press Tab to the Settings button and press Enter to open the settings dialog that includes notification options.
4. Make your changes, then Tab to the Done button and press Enter.

Access message and Spaces options

Press Ctrl + g (Command + g on Mac) to open the options menu for Chat messages and Spaces. This menu includes:

• View members or Manage members
• Apps & integrations
• Pin the conversation to Chat or Spaces
• Notification options for this conversation
• Toggle History
• Block the conversation

Use smart replies

For certain messages you receive, Chat provides suggestions that you can use to send quick replies.

Make sure smart reply is on

1. Open Settings as described in the previous section.
2. Tab to the "Enable smart reply on web and desktop" checkbox.
3. Press Spacebar to toggle on or off.