> For the complete documentation index, see [llms.txt](/llms.txt).
> The full corpus is at [llms-full.txt](/llms-full.txt).

# useBlockObjectButton

> **useBlockObjectButton**(`props`): [`BlockObjectButton`](/api/toolbar/type-aliases/blockobjectbutton/)

Defined in: toolbar/src/use-block-object-button.ts:172

Manages the state, keyboard shortcut and available events for a block
object button.

Note: This hook assumes that the button triggers a dialog for inputting
the block object value.

:::caution[Beta]
This API should not be used in production and may be trimmed from a public release.
:::

## Parameters

### props

#### schemaType

[`ToolbarBlockObjectSchemaType`](/api/toolbar/type-aliases/toolbarblockobjectschematype/)

## Returns

[`BlockObjectButton`](/api/toolbar/type-aliases/blockobjectbutton/)