---
title: "Settings – Events and Interfaces"
slug: "settings-event-interfaces"
description: "Explore settings event interfaces in Rocket Chat. Manage secure configurations and extend collaboration apps."
updated: 2026-02-03T07:00:13Z
published: 2026-02-03T07:00:13Z
---

> ## 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.

# Settings – Events and Interfaces

## Event interfaces

Settings-related events are exposed as lifecycle methods in the App class. These methods are triggered when a setting belonging to the app is about to be updated or has been updated.

| Event Method | Description |
| --- | --- |
| `onSettingUpdated` | Called after a setting belonging to the app has been updated by an external system (not the app itself). |
| `onPreSettingUpdate` | Called before an app setting is updated by an external system. |

## Data model interfaces

The following data model interfaces are passed into the event methods. They describe the details of the setting and its update context, but they are not events themselves.

| Interface | Description |
| --- | --- |
| `ISetting` | Represents a setting and provides details such as ID, type, value, etc. |
| `ISettingUpdateContext` | Provides context for the event, including the new setting value. |
| `SettingType` | Represents the type of setting configured for the app. |

> [!NOTE]
> For further details, refer to the Rocket.Chat [Apps-Engine source code](https://github.com/RocketChat/Rocket.Chat/blob/59115026a7042a1289057256bd205df30a60d9f1/packages/apps-engine/src/definition/App.ts#L208-L235).