> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vobiz.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Conference Attributes

> Full reference for every attribute on the Vobiz Conference XML element - control muting, beeps, participant limits, hold music, and recording.

<Info>
  **Room name**

  The text content of the `<Conference>` element is the room name. All callers placed into the same room name are bridged together. Room names are case-sensitive.
</Info>

## Attributes

| Attribute                                 | Description                                                                                                                                                                                                                                                                                    |
| ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `muted` <br /> *boolean*                  | If `true`, the participant joins the conference muted and cannot be heard by others until unmuted. <br />**Default:** `false`                                                                                                                                                                  |
| `beep` <br /> *boolean*                   | If `true`, a beep plays to all participants when someone joins or leaves the conference. <br />**Default:** `true`                                                                                                                                                                             |
| `startConferenceOnEnter` <br /> *boolean* | If `true`, the conference starts and hold music stops when this participant enters. Set to `false` for participants who should wait in hold until the moderator arrives. <br />**Default:** `true`                                                                                             |
| `endConferenceOnExit` <br /> *boolean*    | If `true`, the conference ends and all other participants are disconnected when this participant leaves. Useful for moderator-controlled conferences. <br />**Default:** `false`                                                                                                               |
| `maxParticipants` <br /> *integer*        | Maximum number of participants allowed in the conference. Callers beyond this limit are rejected. <br />**Allowed values:** positive integer <br />**Default:** `200`                                                                                                                          |
| `waitSound` <br /> *string*               | URL of audio to play to the participant while they wait for the conference to start (i.e. while `startConferenceOnEnter` is `false` for them). Vobiz fetches this URL via POST and expects XML with `<Play>`, `<Speak>`, or `<Wait>` elements. <br />**Allowed values:** a fully qualified URL |
| `waitMethod` <br /> *string*              | HTTP method used to fetch `waitSound`. <br />**Allowed values:** `GET`, `POST` <br />**Default:** `POST`                                                                                                                                                                                       |
| `callbackUrl` <br /> *string*             | URL notified on conference lifecycle events: participant enter, participant exit, conference start, and conference end. See [Conference Callbacks](/xml/conference/conference-callbacks) for the full parameter list. <br />**Allowed values:** a fully qualified URL                          |
| `callbackMethod` <br /> *string*          | HTTP method used to notify `callbackUrl`. <br />**Allowed values:** `GET`, `POST` <br />**Default:** `POST`                                                                                                                                                                                    |
| `record` <br /> *boolean*                 | If `true`, the entire conference is recorded. The recording URL is included in the conference-end callback. <br />**Default:** `false`                                                                                                                                                         |
| `timeLimit` <br /> *integer*              | Maximum duration of the conference in seconds. The conference ends automatically when this limit is reached. <br />**Allowed values:** positive integer <br />**Default:** `14400` (4 hours)                                                                                                   |

## Examples

### Basic conference room

```xml Minimal conference - all defaults theme={null}
<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Conference>SalesTeamRoom</Conference>
</Response>
```

### Moderator-controlled conference

The moderator (`endConferenceOnExit="true"`) holds all participants in music until they arrive, then ends the call for everyone when they leave.

```xml Moderator joins last; ends conference on exit theme={null}
<?xml version="1.0" encoding="UTF-8"?>

<!-- Participant XML (plays hold music until moderator arrives) -->
<Response>
    <Speak>Please hold while we connect you to the conference.</Speak>
    <Conference
        startConferenceOnEnter="false"
        waitSound="https://yourapp.com/hold-music">
        WeeklyStandup
    </Conference>
</Response>

<!-- Moderator XML (starts the conference; ends it when they leave) -->
<Response>
    <Conference
        startConferenceOnEnter="true"
        endConferenceOnExit="true"
        beep="true">
        WeeklyStandup
    </Conference>
</Response>
```

### Recorded conference with participant limit

```xml Record the session and cap at 10 participants theme={null}
<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Conference
        maxParticipants="10"
        record="true"
        callbackUrl="https://yourapp.com/conference-events"
        callbackMethod="POST">
        BoardMeeting
    </Conference>
</Response>
```

### Muted listener (broadcast mode)

```xml Caller joins as a silent listener theme={null}
<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Speak>You are now listening to the all-hands broadcast.</Speak>
    <Conference
        muted="true"
        startConferenceOnEnter="false">
        AllHandsBroadcast
    </Conference>
</Response>
```