# Breakout groups

With Breakout Groups, you can easily implement collaborative sessions directly into your app or website.

## Setup

To use Breakout Groups, you'll need to ensure the following is true. **All of these conditions must be met** for Breakout Groups to function properly, so if you're having issues implementing Breakout Groups, these are good things to double-check:

1. The meeting is set to the `group` roomMode during [meeting creation](https://docs.whereby.com/reference/whereby-rest-api-reference/meetings) 
2. You are using the [`?breakout=on`](https://docs.whereby.com/whereby-for-web-browser/web-component-and-pre-built-ui/configuring-with-attributes#breakout-less-than-on-or-off-greater-than) parameter/attribute if you have `?minimal` enabled
3. The meeting will happen between the meeting creation and `endDate` that was defined in the API request to create the room
4. You are using [Host URLs](https://docs.whereby.com/whereby-product-features/user-roles-and-privileges) and will have a Host in the meeting to start the breakout session

## Additional information

You can also programmatically predefine the number of groups and their names before the meeting using our [?groups](https://docs.whereby.com/whereby-for-web-browser/web-component-and-pre-built-ui/configuring-with-attributes#groups-orange-banana-coconut) parameter in the URL or[ Web Component attribute](https://docs.whereby.com/reference/using-the-whereby-embed-element).

After you've implemented, we have a [series of guides](https://docs.whereby.com/end-user/end-user-support-guides/using-breakout-groups) you can use to train your hosts on using the Breakout Groups feature.

## Known limitations

* Cloud recording does not support our Breakout Groups feature. When using Breakout Groups, the recorder will remain in the main room and will not capture any of the meeting content from individual groups.


---

# Agent Instructions: 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:

```
GET https://docs.whereby.com/whereby-product-features/breakout-groups-with-embedded.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.