---
title: "NavigationBackHandler"
description: "A composable that handles back navigation gestures for a SceneState, driven by a NavigationEventState."
type: "composable"
lastmod: "2026-04-23T11:19:38.195462Z"
---
## API Reference

### NavigationBackHandler

> Source set: Common

```kotlin
@Composable
public fun <T : Any> NavigationBackHandler(
    sceneState: SceneState<T>,
    state: NavigationEventState<SceneInfo<T>> = rememberNavigationEventState(sceneState),
    onBackCancelled: () -> Unit = {},
    onBackCompleted: () -> Unit,
)
```

A composable that handles back navigation gestures for a [SceneState](/jetpack-compose/androidx.navigation3/navigation3-ui/classes/SceneState), driven by a
`NavigationEventState`.

This is a convenience wrapper around the core
[androidx.navigationevent.compose.NavigationBackHandler](/jetpack-compose/androidx.navigation3/navigation3-ui/composable-functions/NavigationBackHandler) that automatically handles the
`NavigationEventState` based on the provided [sceneState](/jetpack-compose/androidx.navigation3/navigation3-ui/classes/SceneState).

#### Parameters

| | |
| --- | --- |
| sceneState | the [SceneState](/jetpack-compose/androidx.navigation3/navigation3-ui/classes/SceneState) that this handler is associated with. |
| state | the hoisted `NavigationEventState` (returned from [rememberNavigationEventState](/jetpack-compose/androidx.navigation3/navigation3-ui/composable-functions/rememberNavigationEventState)) to be registered. |
| onBackCancelled | called if a back navigation gesture is cancelled. |
| onBackCompleted | called when a back navigation gesture completes and navigation occurs. |