LilyPond Notation Reference: 4.1.1 The \paper block

### 4.1.1 The `\paper` block

The `\paper` block can appear within a `\book` block, but not within a `\score` block. Settings in a `\paper` block apply to the entire book, which may include multiple scores. Settings that can appear in a `\paper` block include:

- the `set-paper-size` scheme function,
- `\paper` variables used for customizing page layout, and
- markup definitions used for customizing the layout of headers, footers, and titles.

The `set-paper-size` function is discussed in the next section, Paper size and automatic scaling. The `\paper` variables that deal with page layout are discussed in later sections. The markup definitions that deal with headers, footers, and titles are discussed in Custom headers, footers, and titles.

Most `\paper` variables will only work in a `\paper` block. The few that will also work in a `\layout` block are listed in The `\layout` block.

Except when specified otherwise, all `\paper` variables that correspond to distances on the page are measured in millimeters, unless a different unit is specified by the user. For example, the following declaration sets `top-margin` to ten millimeters:

>     \paper {
>       top-margin = 10
>     }

To set it to `0.5` inches, use the `\in` unit suffix:

>     \paper {
>       top-margin = 0.5\in
>     }

The available unit suffixes are `\mm`, `\cm`, `\in`, and `\pt`. These units are simple values for converting from millimeters; they are defined in ‘`ly/paper-defaults-init.ly`’. For the sake of clarity, when using millimeters, the `\mm` is typically included in the code, even though it is not technically necessary.

It is also possible to define `\paper` values using Scheme. The Scheme equivalent of the above example is:

>     \paper {
>       #(define top-margin (* 0.5 in))
>     }

#### See also

Notation Reference: Paper size and automatic scaling, Custom headers, footers, and titles, The `\layout` block.

Installed Files: ‘`ly/paper-defaults-init.ly`’.

Andere talen: deutsch, español, français, 日本語.

#### LilyPond — Notation Reference