> For the complete documentation index, see [llms.txt](https://docs.cipp.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cipp.app/user-documentation/email/management/list-rooms.md).

# Rooms

This page lists the room mailboxes in the selected tenant. Each row brings the mailbox together with the room's location and facility details, so the address, capacity, and building sit alongside the mailbox name. Rooms are grouped for users with [Room Lists](/user-documentation/email/management/room-lists.md).

## Action Buttons

<details>

<summary>Add Room Mailbox</summary>

Creates a new room mailbox in the selected tenant.

| Field                        | Description                                                                              |
| ---------------------------- | ---------------------------------------------------------------------------------------- |
| Display Name                 | The name shown in the address list and in booking dialogs. Required.                     |
| Username                     | The part before the @ symbol. Required.                                                  |
| Primary Domain name          | The domain used after the @ symbol, chosen from the tenant's verified domains. Required. |
| Resource Capacity (Optional) | The number of people the room seats. Left unset when the box is empty.                   |

**Create Room Mailbox** submits the form. Sign-in for the new mailbox is blocked as part of creating it, so nobody can sign in as the room. Once a mailbox has been created the button changes to **Create Another**, so the drawer can be reused without closing it. Everything else about the room, including its location, facilities, and booking behaviour, is set afterwards on the [Edit Room](/user-documentation/email/management/list-rooms/edit.md) page.

</details>

## Table Details

Each row combines the room's mailbox with its location and facility details, so the columns below are not a straight return from a single Exchange command.

| Column                            | Description                                                                                                                                                           |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Display Name                      | The name of the room as it appears in the address list and in booking dialogs.                                                                                        |
| Mail                              | The address booking requests are sent to.                                                                                                                             |
| Building                          | The building the room is in.                                                                                                                                          |
| Floor                             | The floor the room is on.                                                                                                                                             |
| Capacity                          | The number of people the room seats, taken from the room's location details and falling back to the capacity set on the mailbox. Shows `0` when neither has been set. |
| City                              | The city the room is in.                                                                                                                                              |
| State                             | The state or province the room is in.                                                                                                                                 |
| Country Or Region                 | The country or region the room is in.                                                                                                                                 |
| Hidden From Address Lists Enabled | `true` when the room is hidden from the global address list, so it does not appear in the room finder.                                                                |

{% hint style="danger" %}
**Please note:** Because newly created, updated, and converted rooms will not be shown via Graph immediately and can take up to 24 hours to be visible a decision was made to switch to the slower method of polling Exchange PowerShell.
{% endhint %}

## Table Actions

<table><thead><tr><th>Action</th><th>Description</th><th data-type="checkbox">Bulk Action Available</th></tr></thead><tbody><tr><td>Edit Room</td><td>Opens the <a data-mention href="/pages/v5oSYx7RcA1MdjxkJA0M">/pages/v5oSYx7RcA1MdjxkJA0M</a> page with the selected row's room pre-populated.</td><td>false</td></tr><tr><td>Edit permissions</td><td>Opens the <a data-mention href="/pages/BItSvgOgmXx96BOpMCvc">/pages/BItSvgOgmXx96BOpMCvc</a> page for the account behind the mailbox, where mailbox and calendar permissions are managed.</td><td>false</td></tr><tr><td>Block Sign In</td><td>Blocks sign-in for the selected room mailbox, so nobody can sign in as the room. Greyed out when sign-in is already blocked.</td><td>true</td></tr><tr><td>Unblock Sign In</td><td>Restores sign-in for the selected room mailbox. Greyed out unless sign-in is currently blocked.</td><td>true</td></tr><tr><td>Delete Room</td><td>Deletes the account behind the selected room mailbox, which removes the mailbox with it. Asks for confirmation first.</td><td>true</td></tr></tbody></table>

***

## Feature Requests / Ideas

We value your feedback and ideas. Please raise any [feature requests](https://github.com/CyberDrain/CIPP/issues/new?template=feature.yml) on GitHub.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cipp.app/user-documentation/email/management/list-rooms.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.