box
ElementElement functions can be customized with set
and show
rules.
set
and show
rules.An inline-level container that sizes content.
All elements except inline math, text, and boxes are block-level and cannot occur inside of a paragraph. The box function can be used to integrate such elements into a paragraph. Boxes take the size of their contents by default but can also be sized explicitly.
Example
Refer to the docs
#box(
height: 9pt,
image("docs.svg")
)
for more information.

ParametersParameters are the inputs to a function. They are specified in parentheses after the function name.
width
The width of the box.
Boxes can have fractional widths, as the example below demonstrates.
Note: Currently, only boxes and only their widths might be fractionally sized within paragraphs. Support for fractionally sized images, shapes, and more might be added in the future.
Default: auto
View example
Line in #box(width: 1fr, line(length: 100%)) between.

height
auto or relativeSettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.The height of the box.
Default: auto
baseline
SettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.An amount to shift the box's baseline by.
Default: 0pt
View example
Image: #box(baseline: 40%, image("tiger.jpg", width: 2cm)).

fill
The box's background color. See the rectangle's documentation for more details.
Default: none
stroke
The box's border color. See the rectangle's documentation for more details.
Default: none
radius
SettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.How much to round the box's corners. See the rectangle's documentation for more details.
Default: 0pt
inset
SettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.How much to pad the box's content.
Note: When the box contains text, its exact size depends on the current text edges.
Default: 0pt
View example
#rect(inset: 0pt)[Tight]

outset
SettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.How much to expand the box's size without affecting the layout.
This is useful to prevent padding from affecting line layout. For a generalized version of the example below, see the documentation for the raw text's block parameter.
Default: 0pt
View example
An inline
#box(
fill: luma(235),
inset: (x: 3pt, y: 0pt),
outset: (y: 3pt),
radius: 2pt,
)[rectangle].

clip
SettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.Whether to clip the content inside the box.
Default: false
body
none or contentPositionalPositional parameters are specified in order, without names.SettableSettable parameters can be customized for all following uses of the function with a set
rule.
set
rule.The contents of the box.
Default: none