Skip to main content
Allow participants to raise their hand to get attention during calls. This feature is useful for large meetings, webinars, or any scenario where participants need to signal they want to speak.

​
Raise Hand

Signal that you want to speak or get attention: 
CallSession.shared.raiseHand()

​
Lower Hand

Remove the raised hand indicator: 
CallSession.shared.lowerHand()

​
Listen for Raise Hand Events

Monitor when participants raise or lower their hands using ParticipantEventListener: 
class CallViewController: UIViewController, ParticipantEventListener {
    
    override func viewDidLoad() {
        super.viewDidLoad()
        CallSession.shared.addParticipantEventListener(self)
    }
    
    deinit {
        CallSession.shared.removeParticipantEventListener(self)
    }
    
    func onParticipantHandRaised(participant: Participant) {
        print("\(participant.name ?? "") raised their hand")
        // Show notification or visual indicator
        showHandRaisedNotification(participant)
    }

    func onParticipantHandLowered(participant: Participant) {
        print("\(participant.name ?? "") lowered their hand")
        // Remove notification or visual indicator
        hideHandRaisedIndicator(participant)
    }

    // Other callbacks...
    func onParticipantJoined(participant: Participant) {}
    func onParticipantLeft(participant: Participant) {}
    func onParticipantListChanged(participants: [Participant]) {}
    func onParticipantAudioMuted(participant: Participant) {}
    func onParticipantAudioUnmuted(participant: Participant) {}
    func onParticipantVideoPaused(participant: Participant) {}
    func onParticipantVideoResumed(participant: Participant) {}
    func onParticipantStartedScreenShare(participant: Participant) {}
    func onParticipantStoppedScreenShare(participant: Participant) {}
    func onParticipantStartedRecording(participant: Participant) {}
    func onParticipantStoppedRecording(participant: Participant) {}
    func onDominantSpeakerChanged(participant: Participant) {}
}

​
Check Raised Hand Status

The Participant object includes a raisedHandTimestamp property to check if a participant has their hand raised: 
func onParticipantListChanged(participants: [Participant]) {
    let raisedHands = participants
        .filter { $0.raisedHandTimestamp > 0 }
        .sorted { $0.raisedHandTimestamp < $1.raisedHandTimestamp }
    
    // Display participants with raised hands in order
    updateRaisedHandsList(raisedHands)
}

​
Hide Raise Hand Button

To disable the raise hand feature, hide the button in the call UI: 
let sessionSettings = CometChatCalls.sessionSettingsBuilder
    .hideRaiseHandButton(true)
    .build()