> For the complete documentation index, see [llms.txt](https://kb.mago.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.mago.io/mago-stage/mago-stage-client-apps/connect-a-controller-to-a-receiver.md).

# Connect a controller to a receiver

Connect a controller to a receiver before sending or presenting content.

An activated receiver can display:

* A QR code
* A six-character connection code
* Its availability in the controller’s display list
* Its membership in an available receiver group

The options shown on the controller depend on the organization, license, device, and selected Mago Stage environment.

### Before connecting

Confirm that:

* The receiver has been activated.
* The controller and receiver use the same Mago Stage environment.
* Both devices are online.
* The receiver is showing its connection screen.
* The controller has permission to access the receiver.
* The organization’s license allows another connection.

See **Activate a receiver** if the receiver is still showing an activation code.

### Connect using a QR code

1. Open Mago Stage on the controller.
2. Open the display connection control.
3. Select **Scan QR code**.
4. Allow camera access when requested.
5. Point the controller’s camera at the QR code shown on the receiver.
6. Keep the complete QR code visible within the scanner.
7. Wait for the connection to complete.

After connection, the receiver’s name appears in the controller’s connected-display controls.

If camera access was previously denied, enable it in the device’s operating-system settings before trying again.

<figure><img src="https://2978719120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2FbpP2hYI1Myy7hMs_%2Fuploads%2Ft7LWFe0Wgp58iBtWbBEu%2Fimage.png?alt=media&amp;token=38b30205-74dc-4be4-a521-7155d4785850" alt=""><figcaption></figcaption></figure>

### Connect using a connection code

1. Open Mago Stage on the controller.
2. Open the display connection control.
3. Select **Enter code**.
4. Enter the six-character code shown on the receiver.
5. Confirm the code.
6. Wait for the connection to complete.

Spaces and hyphens in the entered code are ignored.

Use the code currently shown on the receiver. If the receiver displays a new code, the previous code may no longer work.

<figure><img src="https://2978719120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2FbpP2hYI1Myy7hMs_%2Fuploads%2FckpT80RNeoZKwvypfTyc%2Fimage.png?alt=media&amp;token=a3458423-31f6-4565-ae67-1e2759b92b72" alt=""><figcaption></figcaption></figure>

### Connect from the display list

When permitted by the organization, the connection dialog lists receivers available to the signed-in user.

1. Open the display connection control.
2. Find the receiver under **Displays**.
3. Select the receiver.
4. Wait for the connection to complete.

If the receiver is not listed, use its QR code or connection code, or ask an administrator to confirm your access.

On iPhone and iPad, Mago Stage may require Local Network permission to find displays on the current network.

### Connect to a receiver group

Receiver groups allow several receivers to be selected together.

1. Open the display connection control.
2. Open **Groups**.
3. Select the required group.
4. Wait while Mago Stage connects to the available receivers.

A group may be unavailable when:

* It has no active receivers.
* Its receivers are offline.
* The user does not have access to the group.
* The organization’s license does not permit the requested connection.
* The group belongs to another Mago Stage environment.

Group size and receiver limits are covered under **Product limits**.

### Connect an additional receiver

To connect another receiver while a Stage is open:

1. Select the connected-display control in the Stage header.
2. Select **Connect a display**.
3. Select an available receiver or group, scan a QR code, or enter a connection code.
4. Wait for the additional connection to complete.
5. Repeat when the organization’s license and device allow more connections.

Phone-sized controllers can connect to a maximum of two displays during a session. Other limits can depend on the organization’s license and configuration.

### Disconnect receivers

To disconnect one or more receivers:

1. Open the connected-display control.
2. Select the receiver you want to disconnect, or choose the applicable disconnect action.
3. Select **Disconnect displays** or **Disconnect all** when required.
4. Confirm that the disconnected receiver returns to its connection screen.

Disconnecting a receiver does not:

* Deactivate it
* Remove it from the organization
* Delete its display record
* Remove its license assignment

It only ends the active controller connection.

### Troubleshooting

#### The connection code is rejected

Confirm that:

* All six characters were entered correctly.
* The receiver is still showing the same code.
* The controller and receiver use the same environment.
* The receiver has been activated.
* The receiver is online.

If the receiver shows a new code, use the new code.

#### The QR code does not scan

Confirm that:

* Camera permission is enabled.
* The complete QR code is visible.
* The camera lens is clean.
* The receiver screen is bright enough.
* Glare is not obscuring the code.
* The controller is held steadily.

Use **Enter code** if scanning remains unsuccessful.

#### The receiver is not listed

Confirm that:

* The receiver is online.
* The receiver is activated.
* The correct organization is selected.
* The controller has access to the receiver.
* Both devices use the same environment.
* Local Network permission is enabled on iPhone or iPad.

You can still connect using the QR code or connection code when permitted.

#### No displays in the group are online

The group exists, but none of its receivers are currently available.

Check the receivers’ power, application status, network connections, and selected environments.

#### The controller remains on Connecting

Confirm that:

* Both devices can reach the Mago Stage service.
* HTTPS and secure WebSocket connections are allowed.
* The receiver remains on its connection screen.
* The device date and time are correct.
* The organization’s connection limit has not been reached.

Cancel the attempt and try again after checking connectivity.

#### The connection limit has been reached

Disconnect an unused receiver and try again.

If the limit does not match the expected organization capacity, ask an administrator to review the applicable license and receiver assignments.

#### The receiver disconnects repeatedly

Check:

* Network stability
* Wi-Fi signal quality
* Proxy WebSocket timeouts
* Device sleep settings
* Application updates
* Server availability

Use wired Ethernet for fixed receivers where practical.
