PAPER(1) User Commands PAPER(1)

paper - print paper size information

paper [OPTION...] [PAPER...|--all]

Print paper size information.

show information about all known paper sizes
do not show paper sizes (width followed by height)
unit in which to show sizes [pt, mm, in; default: natural units]
display this help message and exit
display version information and exit

paper prints information about the given paper sizes, which can include the standard form of its name, its width and height. The output is designed to be both human- and machine-readable. The name is matched case-insensitively, and ignoring spaces.

If neither a paper size nor the --all option is given, the current paper size is used.

The current paper size is obtained by looking in order at the following values until a non-empty value is found. If no paper size is configured, paper exits with an error.

The PAPERSIZE environment variable
The user's default paper size in $XDG_CONFIG_HOME/papersize
The current locale's default paper size (if supported by the system)
The system default paper size in /etc/papersize
The first paper size in the system list
The first paper size in the user's list

Paper size to use.

System default paper size.
User's default paper size.

Written by Reuben Thomas.

Report bugs at

Copyright © 2013-2022 Reuben Thomas <>. paper comes with ABSOLUTELY NO WARRANTY. You may redistribute copies of paper under the terms of the GNU General Public License version 3, or, at your option, any later version.See


March 2024 paper 2.1.3