---
title: "Android SDK setup"
description: "Install and initialize Gleap in your application with the Gleap Android SDK. Follow the integration code examples."
url: https://docs.gleap.ai/en/articles/466-android-sdk-setup
collection: "Android"
updated: 2026-11-01
language: en
---

# Android SDK setup

Install and initialize Gleap in your application with the Gleap Android SDK. Follow the integration code examples.

The Gleap SDK for Android is the easiest way to integrate Gleap into your apps. Communicate with your users directly and build better software by discovering their everyday pain points. Gleap is your all-in-one customer feedback tool for apps and websites.

For the SDK to work, you need an API key, which you can get for free at [app.gleap.ai](https://app.gleap.ai).

## 🏗 Installation

Gleap is distributed through the [Maven Central](https://central.sonatype.com/artifact/io.gleap/gleap-android-sdk). Add the following to you build.gradle (Module: app).

```javascript
implementation group: 'io.gleap', name: 'gleap-android-sdk', version: '19.3.1'
```

The Gleap SDK is now almost successfully installed. **Let's carry on with the initialization** 🎉

### 👷‍♂️ Initialize & configure the SDK

Open your preferred development tool and add the following code to your main activity (typically MainActivity.java).

```javascript
import io.gleap.Gleap;
```

These two includes are everything you need.

```javascript
@Override
protected void onCreate(Bundle savedInstanceState) {
    ....
    Gleap.initialize("YOUR_API_KEY", this);
}
```

You are all set now! **Run the app and report your first bug 🎉.**

> **Info:** Get your API key [here](https://app.gleap.ai).

## 🌍 Data region

Gleap stores and processes your data in the region you selected at signup: EU (default) or US. If your project lives in the US region, select the region **before** initializing the SDK (requires SDK v18.0.0 or newer). EU projects don't need this call.

```java
Gleap.getInstance().setRegion("us");
Gleap.initialize("YOUR_API_KEY", this);
```

See [Data regions](https://gleap-developer-docs.gleap.help/en/articles/711-data-regions) for all hosts and details.

## Required permissions

In order to use the image picker for attachments, add the following permissions to your `AndroidManifest.xml`.

```javascript
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<uses-permission android:name="android.permission.READ_MEDIA_VISUAL_USER_SELECTED"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
```

The following permissions are needed to enable audio recordings.

```javascript
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-feature android:name="android.hardware.audio.pro" android:required="false" />
<uses-feature android:name="android.hardware.microphone" android:required="false" />
```

The following permissions are needed for our video call feature:

## 🤝 Need help?

We are here to help, simply drop us an email at [hello@gleap.ai](mailto:hello@gleap.ai).

## Related

- [Android SDK: User identity](https://docs.gleap.ai/en/articles/467-android-sdk-user-identity.md)
- [Android SDK: Callbacks](https://docs.gleap.ai/en/articles/468-android-sdk-callbacks.md)
- [Android SDK: Frontend tools](https://docs.gleap.ai/en/articles/469-android-sdk-frontend-tools.md)
- [Android SDK: Forms](https://docs.gleap.ai/en/articles/470-android-sdk-forms.md)
- [Android SDK: Feedback button](https://docs.gleap.ai/en/articles/471-android-sdk-feedback-button.md)