---
title: "Rocket Chat Iframe Events Guide"
slug: "iframe-events"
description: "Explore Iframe events in Rocket Chat. Manage secure interactions, improve integrations, and streamline collaboration."
updated: 2026-02-09T08:39:19Z
published: 2026-02-09T08:39:19Z
canonical: "developer.rocket.chat/iframe-events"
---

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

# Iframe Events

When the iframe integration is enabled, certain events are triggered. These events include the following:

| Event name | Description |
| --- | --- |
| `startup` | Fired when an iframe initializes |
| `notification` | Fired when a user receives a notification |
| `unread-changed-by-subscription` | Fired each time a user's subscription record changes (i.e.: unread counts, etc) |
| `unread-changed` | Fired when the pages title changes |
| `room-opened` | Fired when a room is opened |
| `new-message` | Fired every time the opened room receives a new message |
| `click-user-card-message` | Fired when the user clicks on a username link |
| `click-mention-link` | Fired when the user clicks on a mention link |
| `click-message-link` | Fired when the user clicks on a posted link |
| `click-action-link` | Fired when the user clicks on an action link button (i.e.: "click to join" to video conferences) |

Here is a sample code that listens to events fired from Rocket.Chat opened on an `iframe`:

```javascript
window.addEventListener('message', function(e) {
    console.log(e.data.eventName); // event name
    console.log(e.data.data); // event data
});
```