---
title: "React Native SDK: Custom actions"
description: "Handle custom actions triggered by the widget with the Gleap React Native SDK. Follow the integration code examples."
url: https://docs.gleap.ai/en/articles/510-react-native-sdk-custom-actions
collection: "React Native"
updated: 2026-11-01
language: en
---

# React Native SDK: Custom actions

Handle custom actions triggered by the widget with the Gleap React Native SDK. Follow the integration code examples.

We know that the built in actions (Bug Reporting, Feature Requests, Ratings & Contact Us) might not be enough for certain use cases. For these situations we offer custom actions, which allow you to start any custom action by code.

## Configure a custom action

Open Settings → Widget → Content → Quick actions. Add or open a quick action, choose Custom action, and enter its Custom action name. Use that exact name in the handler below.

Now you need to **set a name for your custom action**. Choose any name you like (it's however important that this name matches the name you check in the next step).

![Current messenger quick-action settings in the Pied Piper demo project.](https://staticfiles.gleap.io/p613b5dd730aed737108f87ab/gmAdnE7X2jnNhNn1dRmzvgLczFyPAIF7Qsn2PicWuQHx4eAMN1Er2Il0dBP2VBl1brGt4Zn56QT.png)

## Custom action callback

Once you've set a custom action in the Gleap dashboard, it will be called automatically on selection through the user. In order to perform custom code, simply implement our `registerCustomAction` to receive the custom action events.

### Add & implement the Gleap delegate

The following code sample shows how to implement the `registerCustomAction` protocol.

```swift
Gleap.registerListener('customActionTriggered', (data) => {
    if (data.name === 'MAGIC_ACTION') {
      console.log('Magic action got called.');
    }
});
```

> **Info:** The **custom action name** is defined by you in the visual widget configurator on the Gleap dashboard.

## Related

- [React Native SDK setup](https://docs.gleap.ai/en/articles/499-react-native-sdk-setup.md)
- [React Native SDK: User identity](https://docs.gleap.ai/en/articles/500-react-native-sdk-user-identity.md)
- [React Native SDK: Track events](https://docs.gleap.ai/en/articles/501-react-native-sdk-track-events.md)
- [React Native SDK: Track pages](https://docs.gleap.ai/en/articles/502-react-native-sdk-track-pages.md)
- [React Native SDK: Frontend tools](https://docs.gleap.ai/en/articles/503-react-native-sdk-frontend-tools.md)