Box
Type identifier:
boxCategory: Experience Blocks
Description
Container block used for layout composition and optional semantic HTML mapping. It accepts the shared properties and can contain nested children blocks.
Schema Summary
The Box block has these fields, in addition to the shared properties:
type: "box"(required)htmlElement(optional)htmlElementConfig(optional; supportsdetails.defaultOpenonly)children(optional; array of blocks)states(optional array of state override entries)
Properties
Property | Type | Required | Notes |
|---|---|---|---|
|
| Yes | Shared block identifier. |
|
| Yes | Block discriminator. |
|
| No | Optional block name. |
|
| No | Semantic/container element override. One of |
|
| No | Config for supported semantic elements. |
| Array of blocks | No | Nested blocks of any experience block type. |
| Array of states | No | Optional state-specific overrides. |
The Box block also supports shared style/layout/data props (border/background/shadow, spacing, flex/grid/layout, typography, query/forEach/entityContext, transform/transition, and raw style).
States
State entries use:
id: one ofhover,active,focus,enabled,readonly,visited,selected,disabledor custom^s[a-f0-9]{6}$name?activation?.when(datumReferenceordatumCondition)overrides: partialboxfields excludingid,name,states
Box blocks do not support pseudo-state overrides. Media states are available; see Experience States and Print Layout.
Child Rules
children supports nested blocks of any Experience block type. The Box block does not restrict child types.
Minimal Valid Example
{
"id": "box-1",
"type": "box"
}