The page dimensions in a LaTeX document are highly configurable and the geometry package offers a simple way to change the length and layout of different elements such as the paper size, margins, footnote, header, orientation, etc.

[edit] Introduction

Suppose you have to create a document in a4paper and the text shouldn't exceed 6 in width and 8 in height. To create it with geometry is easy, include this one line in the preamble:

\usepackage[a4paper, total={6in, 8in}]{geometry}

The parameters passed to the command determine the layout. In this case a4paper establishes the paper size and the total parameter determines the size of the text area. Note that ShareLaTeX uses a European LaTeX distribution, which produces documents in A4 size by default.

  Open an example of the geometry package in ShareLaTeX

[edit] Paper size, orientation and margins

Paper size, orientation and margins are the most common page elements that must be changed depending on the type of document. To set the desired values there are two ways, either you pass them as parameters to the \includepackage statement as in the example above, or use a \geometry command in the preamble.

For example, let's create a document with legal paper size, landscape orientation and a 2 in margin:

\usepackage[legalpaper, landscape, margin=2in]{geometry}

You can achieve the same thing in a slightly different way:

\usepackage{geometry}
\geometry{legalpaper, landscape, margin=2in}

As you see, the parameters are comma separated. For a complete list of predefined paper sizes, see the reference guide. The second parameter is the orientation, its default value is portrait. Finally, each margin is set to 2 in.

  Open an example of the geometry package in ShareLaTeX

[edit] Fine tuning your LaTeX page dimensions

The regular LaTeX page dimensions are presented (with example values) in picture at the right of this section.

The geometry package provides a flexible and easy interface to change page dimensions. You can change the page layout with intuitive parameters:

Next is a list of document elements whose length can be changed. The parameters have to be written in the form parameter=value, use standard LaTeX units. (mm, cm, pt, in)

textwidth

Corresponds to element 8 in the figure.

textheight

Element 7 in the figure.

total

Depends on other parameters, by default defines the dimensions of the Body, but can be combined with the includehead, includefoot, includeheadfoot and includemp commands to change the dimensions of Header, the Body, the Footer and the Margin Notes altogether.

left, lmargin, inner

These three parameters change the length of the left margin. Elements 1 and 3 in the figure, combined.

right, rmargin, outer

These three parameters change the length of the right margin. Elements 9 and 10 in the figure, combined.

top, tmargin

These two parameters represent elements 2 and 6 in the figure, combined.

bottom, bmargin

These two parameters set the distance from the bottom edge of the document to its baseline.

headheight

Height of the header

footsep

Separation between the bottom of the text (baseline) and the top of the footnote. Element 11 in the figure.

footskip

Distance between the baseline of the text and the baseline of the footnote.

marginparwidth, marginpar

Width of the margin notes. Element 10 in the figure.

The paper size can be set to any size you need by means of the command papersize={⟨width⟩,⟨height⟩}.

Let's see an example with some of the aforementioned options:

\usepackage{geometry}
 \geometry{
 a4paper,
 total={170mm,257mm},
 left=20mm,
 top=20mm,
 }

Here the text area, the left margin and the top margin are set. The right and bottom margins are automatically computed to fit the page.

  Open an example of the geometry package in ShareLaTeX

[edit] Reference guide

[edit] Further reading

For more information see:

• Lengths in LaTeX
• Headers and footers
• Multiple columns
• Footnotes
• Page numbering
• Text alignment
• Hyperlinks
• Understanding packages and class files
• Writing your own package
• Writing your own class
• The geometry package documentation.