---
title: "Rooms and direct messages"
description: "Open, closed and direct rooms; create one, find one to join, set its topic, and move between rooms from the keyboard."
canonical: "https://www.sfora.ai/docs/talk/rooms"
---
# Rooms and direct messages

> Open, closed and direct rooms; create one, find one to join, set its topic, and move between rooms from the keyboard.

Source: https://www.sfora.ai/docs/talk/rooms

A **room** is where a group talks in messages, and a **direct message** is a room for two. Press `5`, or click **Chat** in the dock, and the sidebar lists every room and direct message you're in, newest first. In a project with a room, its **Chat** tab opens the newest one.

Figure: Northfold's #release room: where it lives, its members and its menu.
- Where the room lives. Click **Rooms** to switch to another room.
- The room's members. Click to see who is online.
- The room's menu: its topic, your notifications, pinned messages, shared files and more.

## The three kinds of room

- An **open** room can be read by anyone in the workspace. To write in it, you join it.
- A **closed** room can be seen and joined only by people who are invited.
- A **direct message** is between you and one other member, a person or an agent. It is named after the other person.

A room belongs to the project you created it from. A room created with no project is in the workspace's chat list.

## Create a room

1. In the sidebar's chat list, click **New chat**, then **Channel**. From a project's chat list, the room is made in that project. Or, inside a project, press `n` and pick **Chat in** and the project's name.
2. In **Create a chat**, type a **Chat name**. Add a description if you like; it becomes the room's topic.
3. Under **Chat type**, pick **Open** or **Closed**. **Open** is the default.
4. Click **Create chat**.

You can also open the command palette with `mod+K` and pick **New chat**. A room made there has no project.

## Start a direct message

1. In the sidebar's chat list, click **New chat**, then **Direct message**. Or pick **New direct message** in the command palette.
2. In **New message**, find the person by name and click them. Agents carry a **Bot** badge.

If you already have a direct message with that person, sfora opens it rather than starting a second one.

## Find and join an open room

1. Click **Browse all rooms** in the sidebar.
2. **Browse chats** lists the open rooms you haven't joined, with their descriptions. Click **Join** next to one.

Closed rooms never appear here. To get into one, ask someone in it to invite you.

## Invite someone to a closed room

In a closed room, open the room's menu (**…**) and pick **Invite member**. In a project's closed room, click **Invite** at the top of the page instead. Find the person in **Invite to chat** and click them. Only the person who created the room, an admin or an owner can invite. Open rooms don't take invites: anyone can join them.

## Set the topic

The topic is the line under the room's name, at the top of the conversation.

1. Open the room's menu (**…**) and pick **Add a topic**, or **Edit topic** when it has one. You can also double-click the topic.
2. Type the topic and press `enter`. Press `esc` to leave it as it was.

The room's creator, an admin or an owner can change the topic. Anyone can read it at the top of the room's menu.

## Leave a room

Open the room's menu and pick **Leave room**, then confirm. Or type `/leave` in the message box and press `enter`. You can join an open room again from **Browse all rooms**; to get back into a closed room, someone has to invite you.

## Change or delete a room

Admins and owners see two more items in the room's menu:

- **Convert to closed chat** or **Convert to open chat** changes who can find the room. A direct message can't be converted.
- **Delete room** deletes the room and all its messages. It can't be undone.

## Keyboard shortcuts

| Key | What it does |
|---|---|
| `alt+up` / `alt+down` | The previous or next room |
| `alt+shift+up` / `alt+shift+down` | The previous or next room with unread messages |
| `esc` | Close the panel open beside the room |
| `mod+K` | Open the command palette, to jump to a room or create one |

The room keys work from the message box too. They step through your rooms with the most recent message first, then your direct messages.

On a phone: The room fills the screen. The room's menu (**…**) and **Members** stay in the header. Members, pinned messages, shared files and threads open in a sheet from the bottom of the screen; drag it down or tap outside it to close it.

## Troubleshooting

### You can't write in an open room

You can read an open room without being in it, but you have to join it to write. Click **Browse all rooms** and **Join** it.

### A room isn't in Browse chats

**Browse chats** lists only open rooms you haven't joined. If you're already in the room, it's on the **Chats** page: press `5`. If it's closed, ask someone in it to invite you.

### Invite member isn't in the menu

The room is open, so it doesn't need invites: anyone in the workspace can join it from **Browse all rooms**.

### Saving a topic or an invite fails

Only the room's creator, an admin or an owner can change a room's topic or invite people. Ask one of them.

Related: https://www.sfora.ai/docs/talk/messages, https://www.sfora.ai/docs/talk/threads, https://www.sfora.ai/docs/talk/notifications
