---
title: "rememberBottomSheetState"
description: "Create and remember a SheetState for BottomSheet, ModalBottomSheet, or BottomSheetScaffold."
type: "composable"
lastmod: "2026-05-20T01:13:53.113226Z"
---
## API Reference

### rememberBottomSheetState

> Source set: Common

```kotlin
@Composable
@ExperimentalMaterial3Api
fun rememberBottomSheetState(
    initialValue: SheetValue,
    enabledValues: Set<SheetValue> = setOf(Hidden, PartiallyExpanded, Expanded),
    confirmValueChange: (SheetValue) -> Boolean = { true },
): SheetState
```

Create and [remember](/jetpack-compose/androidx.compose.runtime/runtime/composable-functions/remember) a [SheetState](/jetpack-compose/androidx.compose.material3/material3/classes/SheetState) for [BottomSheet](/jetpack-compose/androidx.compose.material3/material3/components/BottomSheet), [ModalBottomSheet](/jetpack-compose/androidx.compose.material3/material3/components/ModalBottomSheet), or
[BottomSheetScaffold](/jetpack-compose/androidx.compose.material3/material3/components/BottomSheetScaffold).

#### Parameters

| | |
| --- | --- |
| initialValue | The initial value of the state. |
| enabledValues | The set of [SheetValue](/jetpack-compose/androidx.compose.material3/material3/classes/SheetValue)s that the bottom sheet can settle in. This is the direct source of truth for available states; if a value is included here, the component will attempt to create an anchor for it. |
| confirmValueChange | Optional callback invoked to confirm or veto a pending state change. |