# Experimental

Artifact: [androidx.annotation:annotation-experimental](https://developer.android.com/jetpack/androidx/releases/annotation) [View Source](https://cs.android.com/search?q=file:androidx/annotation/experimental/Experimental.kt+class:androidx.annotation.experimental.Experimental) Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/annotation#1.0.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/annotation#1.1.0)

*** ** * ** ***


```
@Retention(value = AnnotationRetention.BINARY)
@Target(allowedTargets = [AnnotationTarget.ANNOTATION_CLASS])
annotation Experimental
```

<br />

*** ** * ** ***

> [!CAUTION]
> **This annotation is deprecated.**   
> This annotation has been replaced by \`@RequiresOptIn\`, use this instead:
>
> ```kotlin
> RequiresOptIn
> ```

Denotes that the annotated element is a marker of an experimental API.

Any declaration annotated with this marker is considered part of an unstable API surface and its call sites should accept the experimental aspect of it either by using `https://developer.android.com/reference/kotlin/androidx/annotation/experimental/UseExperimental`, or by being annotated with that marker themselves, effectively causing further propagation of that experimental aspect.

## Summary

| ### Nested types |
|---|
| `enum https://developer.android.com/reference/kotlin/androidx/annotation/experimental/Experimental.Level : https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-enum/index.html<https://developer.android.com/reference/kotlin/androidx/annotation/experimental/Experimental.Level>` **This enum is deprecated.** This annotation has been replaced by \`@RequiresOptIn\` |

| ### Public constructors |
|---|
| `[Experimental](https://developer.android.com/reference/kotlin/androidx/annotation/experimental/Experimental#Experimental(androidx.annotation.experimental.Experimental.Level))(level: https://developer.android.com/reference/kotlin/androidx/annotation/experimental/Experimental.Level)` **This function is deprecated.** This annotation has been replaced by \`@RequiresOptIn\` |

| ### Public properties |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/annotation/experimental/Experimental.Level` | `https://developer.android.com/reference/kotlin/androidx/annotation/experimental/Experimental#level()` **This property is deprecated.** This annotation has been replaced by \`@RequiresOptIn\` |

## Public constructors

### Experimental

Added in [1.6.0](https://developer.android.com/jetpack/androidx/releases/annotation#1.6.0) Deprecated in [1.6.0](https://developer.android.com/jetpack/androidx/releases/annotation#1.6.0)

```
[Experimental](https://developer.android.com/reference/kotlin/androidx/annotation/experimental/Experimental#Experimental(androidx.annotation.experimental.Experimental.Level))(level: Experimental.Level = Level.ERROR)
```

> [!CAUTION]
> **This function is deprecated.**   
> This annotation has been replaced by \`@RequiresOptIn\`, use this instead:
>
> ```kotlin
> RequiresOptIn
> ```

## Public properties

### level

```
val level: Experimental.Level
```

> [!CAUTION]
> **This property is deprecated.**   
> This annotation has been replaced by \`@RequiresOptIn\`, use this instead:
>
> ```kotlin
> RequiresOptIn
> ```

Defines the reporting level for incorrect usages of this experimental API.