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

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

Aligns content horizontally and vertically.

Example

Let's start with centering our content horizontally:

#set page(height: 120pt)
#set align(center)

Centered text, a sight to see \
In perfect balance, visually \
Not left nor right, it stands alone \
A work of art, a visual throne
Preview

To center something vertically, use horizon alignment:

#set page(height: 120pt)
#set align(horizon)

Vertically centered, \
the stage had entered, \
a new paragraph.
Preview

Combining alignments

You can combine two alignments with the + operator. Let's also only apply this to one piece of content by using the function form instead of a set rule:

#set page(height: 120pt)
Though left in the beginning ...

#align(right + bottom)[
  ... they were right in the end, \
  and with addition had gotten, \
  the paragraph to the bottom!
]
Preview

Nested alignment

You can use varying alignments for layout containers and the elements within them. This way, you can create intricate layouts:

#align(center, block[
  #set align(left)
  Though centered together \
  alone \
  we \
  are \
  left.
])
Preview

Alignment within the same line

The align function performs block-level alignment and thus always interrupts the current paragraph. To have different alignment for parts of the same line, you should use fractional spacing instead:

Start #h(1fr) End
Preview

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

alignment
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 alignment along both axes.

Default value:

start + top

Show example
#set page(height: 6cm)
#set text(lang: "ar")

مثال
#align(
  end + horizon,
  rect(inset: 12pt)[ركن]
)
Preview

body
Required
Required
Required parameters must be specified when calling the function.
Positional
Positional
Positional parameters can be set by specifying them in order, omitting the parameter name.

The content to align.

Open official docs

Search