Info
This site is generated using the static site generator developed by the Typst Community. Please adjust the text content of this banner according to your usage requirements. At Typst GmbH's request, when publishing documentation, you must clearly indicate that it is non-official and display the version of Typst being documented. For details, refer to Issue #874 on typst/typst.
TypstDocumentEnglish
v0.dev.2025-09-12

square
Element
Element
Element functions can be customized with set and show rules.

A square with optional content.

Example

// Without content.
#square(size: 40pt)

// With content.
#square[
  Automatically \
  sized to fit.
]
Preview

Parameter
Parameter
Parameters are input values for functions. Specify them in parentheses after the function name.

size

The square's side length. This is mutually exclusive with width and height.

Default value:

auto

width
Settable
Settable
Settable parameters can be set using the set rule, changing the default value used thereafter.

The square's width. This is mutually exclusive with size and height.

In contrast to size, this can be relative to the parent container's width.

Default value:

auto

height
Settable
Settable
Settable parameters can be set using the set rule, changing the default value used thereafter.

The square's height. This is mutually exclusive with size and width.

In contrast to size, this can be relative to the parent container's height.

Default value:

auto

fill
Settable
Settable
Settable parameters can be set using the set rule, changing the default value used thereafter.

How to fill the square. See the rectangle's documentation for more details.

Default value:

none

stroke
Settable
Settable
Settable parameters can be set using the set rule, changing the default value used thereafter.

How to stroke the square. See the rectangle's documentation for more details.

Default value:

auto

radius
Settable
Settable
Settable parameters can be set using the set rule, changing the default value used thereafter.

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

Default value:

(:)

inset
Settable
Settable
Settable parameters can be set using the set rule, changing the default value used thereafter.

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

Default value:

0% + 5pt

outset
Settable
Settable
Settable parameters can be set using the set rule, changing the default value used thereafter.

How much to expand the square's size without affecting the layout. See the box's documentation for more details.

Default value:

(:)

body
Positional
Positional
Positional parameters can be set by specifying them in order, omitting the parameter name.
Settable
Settable
Settable parameters can be set using the set rule, changing the default value used thereafter.

The content to place into the square. The square expands to fit this content, keeping the 1-1 aspect ratio.

When this is omitted, the square takes on a default size of at most 30pt.

Default value:

none

Open official docs

Search