TypstDocumentation

boxElement
Question mark

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.
Preview

Parameters
Question mark

width
auto or relative length or fraction
Settable
Question mark

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

Line in #box(width: 1fr, line(length: 100%)) between.
Preview

height
auto or relative length
Settable
Question mark

The height of the box.

Default: auto

baseline
relative length
Settable
Question mark

An amount to shift the box's baseline by.

Default: 0pt

Image: #box(baseline: 40%, image("tiger.jpg", width: 2cm)).
Preview

fill
none or color
Settable
Question mark

The box's background color. See the rectangle's documentation for more details.

Default: none

stroke
none or length or color or dictionary or stroke
Settable
Question mark

The box's border color. See the rectangle's documentation for more details.

Default: none

radius
relative length or dictionary
Settable
Question mark

How much to round the box's corners. See the rectangle's documentation for more details.

Default: 0pt

inset
relative length or dictionary
Settable
Question mark

How much to pad the box's content. See the rectangle's documentation for more details.

Default: 0pt

outset
relative length or dictionary
Settable
Question mark

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

An inline
#box(
  fill: luma(235),
  inset: (x: 3pt, y: 0pt),
  outset: (y: 3pt),
  radius: 2pt,
)[rectangle].
Preview

clip
boolean
Settable
Question mark

Whether to clip the content inside the box.

Default: false

body
none or content
Positional
Question mark
Settable
Question mark

The contents of the box.

Default: none