---
title: Honeybadger for React Native version <=5
description: Honeybadger monitors your React Native applications for errors and exceptions so that you can fix them wicked fast.
url: https://docs.honeybadger.io/lib/javascript/integration/react-native-v5/
---

Note

This documentation is for **version 5** or earlier. If you are using a more recent version, please see the [latest documentation](https://docs.honeybadger.io/lib/javascript/integration/react-native/).

## Installation

From the root directory of your React Native project:

```shell
npm install "@honeybadger-io/react-native"
cd ios && pod install
```

The above will download the Honeybadger React Native library and add it as a dependency of your project. The iOS step is required to properly add the library to the Xcode project through CocoaPods. Android doesn’t require a separate step.

## Initialization

Add the following to your **App.js** file to initialize the Honeybadger library.

```js
import Honeybadger from "@honeybadger-io/react-native";


export default function App() {
  Honeybadger.configure("PROJECT_API_KEY");
  // ...
}
```

You can log into your [Honeybadger](https://honeybadger.io) account to obtain your API key.

## Configuration

The configure method takes additional configuration options.

| Name         | Type    | Required | Default | Example              |
| ------------ | ------- | -------- | ------- | -------------------- |
| apiKey       | String  | YES      | `""`    | `"hb-api-key-1234"`  |
| reportErrors | Boolean | NO       | true    |                      |
| revision     | String  | NO       | `""`    | `"8afb34a"`          |
| projectRoot  | String  | NO       | `""`    | `"/path/to/project"` |

```js
Honeybadger.configure("hb-api-key-1234", "8afb34a", "/path/to/project");
```

The **reportErrors** parameter determines if errors are to be sent to Honeybadger. This is set to **true** by default. In certain environments, say, during development, it could be useful to set **reportErrors** to **false** to prevent errors from being posted to your Honeybadger account.

## Usage examples

iOS, Android, and JavaScript errors will be automatically handled by the Honeybadger React Native library, by default. But you can also use the following API to customize error handling in your application.

### Honeybadger.notify(error, additionalData)

You can use the **notify** method to send any kind of error, exception, object, String, etc. If sending an error or exception, the Honeybadger React Native library will attempt to extract a stack trace and any relevant information that might be useful. You can also optionally provide **additionalData** to the **notify** method, as either a string or an object, to include any relevant information.

### Honeybadger.setContext(context)

If you have data that you would like to include whenever an error or an exception occurs, you can provide that data using the **setContext** method. Provide an object as an argument. You can call **setContext** as many times as needed. New context data will be merged with any previously-set context data.

```js
Honeybadger.setContext({
  user_id: "123abc",
  more: "some additional data",
});
```

### Honeybadger.resetContext()

If you’ve used **Honeybadger.setContext()** to store context data, you can use **Honeybadger.resetContext()** to clear that data.

### Honeybadger.setLogLevel(logLevel)

Sets the logging level for the Honeybadger library.

```js
Honeybadger.setLogLevel("debug");
```

The following values are accepted:

| Value     | Meaning                                  |
| --------- | ---------------------------------------- |
| “debug”   | Everything will be logged to console.    |
| “warning” | Only warnings will be logged to console. |
| “error”   | Only errors will be logged to console.   |

The default logging level is “warning”.

---

## Try Honeybadger for FREE

Intelligent logging, error tracking, and Just Enough APM™ in one dev-friendly platform. Find and fix problems before users notice.

[Start free trial](https://app.honeybadger.io/users/sign_up)

[See plans and pricing](https://www.honeybadger.io/plans/)