---
title: "Unleash"
description: "Learn how to use Sentry with Unleash."
url: https://docs.sentry.io/platforms/python/integrations/unleash/
---

# Unleash | Sentry for Python

The [Unleash](https://www.getunleash.io/) integration tracks feature flag evaluations produced by the Unleash SDK. These evaluations are held in memory and are sent to Sentry on error and transaction events. **At the moment, we only support boolean flag evaluations from Unleash's is\_enabled method.**

## [Install](https://docs.sentry.io/platforms/python/integrations/unleash.md#install)

Install `sentry-sdk` from PyPI:

```bash
pip install sentry-sdk
```

## [Configure](https://docs.sentry.io/platforms/python/integrations/unleash.md#configure)

Add `UnleashIntegration` to your `integrations` list:

```python
import sentry_sdk
from sentry_sdk.integrations.unleash import UnleashIntegration

sentry_sdk.init(
    dsn="___PUBLIC_DSN___",
    # Add data like request headers and IP for users, if applicable;
    # see https://docs.sentry.io/platforms/python/data-management/data-collected/ for more info
    send_default_pii=True,
    integrations=[UnleashIntegration()],
)
```

For more information on how to use Unleash, read Unleash's [Python reference](https://docs.getunleash.io/reference/sdks/python) and [quickstart guide](https://docs.getunleash.io/quickstart).

## [Verify](https://docs.sentry.io/platforms/python/integrations/unleash.md#verify)

Test the integration by evaluating a feature flag using your Unleash SDK before capturing an exception.

```python
import sentry_sdk
from UnleashClient import UnleashClient

unleash = UnleashClient(...)  # See Unleash quickstart.
unleash.initialize_client()

test_flag_enabled = unleash.is_enabled("test-flag")
sentry_sdk.capture_exception(Exception("Something went wrong!"))
```

Visit the [Sentry website](https://sentry.io/issues/) and confirm that your error event has recorded the feature flag "test-flag", and its value is equal to `test_flag_enabled`.

## [Supported Versions](https://docs.sentry.io/platforms/python/integrations/unleash.md#supported-versions)

* UnleashClient >= 6.0.1
* sentry-sdk >= 2.20.0
* python >= 3.8

##### Next Steps

* **Track feature flag evaluations in other parts of your codebase.** If needed, you can set up evaluation tracking for more than one SDK. [Read the docs](https://docs.sentry.io/platforms/python/feature-flags.md#enable-evaluation-tracking) to learn more.
* **Set up your change tracking webhook.** In order to take full advantage of the feature flag capabilities Sentry offers there is an additional setup step needed. Your feature flag provider needs to notify Sentry when a feature flag definition has changed. A Sentry webhook URL can be registered with your provider. Learn [how](https://docs.sentry.io/platforms/python/feature-flags.md#enable-change-tracking).