> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/latex-errors/10-illegal-unit-of-measure-pt-inserted.md).

# Illegal unit of measure (pt inserted)

If you are specifying a length in LaTeX, but do not specify the appropriate units, you will generate the error below:

main.tex, line 5

Illegal unit of measure (pt inserted).

\vskip l.11 \vspace{6} Dimensions can be in units of em, ex, in, pt, pc, cm, mm, dd, cc, nd, nc, bp, or sp; but yours is a new one! I'll assume that you meant to say pt, for printer's points. To recover gracefully from this error, it's best to delete the erroneous units; e.g., type \`2' to delete two letters. (See Chapter 27 of The TeXbook.)

See [here](/latex/formatting/01-lengths-in-latex.md) to learn more about lengths in LaTeX.

## Common Causes

**Forgetting to include the appropriate unit when specifying a length:**

The most common cause of this error is simply forgetting to include a unit when specifying a length in LaTeX. An example of a mistake is shown below

```latex
The below image should be 5 centimetres wide

\includegraphics[width=5]{image}
```

The mistake here is that the the width of the image is written as **`width=5`**. LaTeX does not understand whether the image should be five inches, five metres, five millimetres etc. The correct specification is **`width=5cm`**. This lets LaTeX know that the image should be five centimetres wide.

**Using a unit which is not allowed in LaTeX:**

Another common reason this error will appear is if you have used a unit which is not allowed in LaTeX. An example of this is shown below, where it was attempted to specify the image to be one foot wide:

```latex
The below image should be one foot wide

\includegraphics[width=1ft]{image}
```

This will generate an error, as feet are not allowed units in LaTeX. The correct way to write this would be to write the image width as **`width=12in`**, which gives a one foot wide image. Below a list of available units in LaTeX:

| Abbreviation | Value                                                                                                                                                                             |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **pt**       | a point is approximately 1/72.27 inch, that means about 0.0138 inch or 0.3515 mm (exactly point is defined as 1/864 of American *printer’s foot* that is 249/250 of English foot) |
| **mm**       | a millimeter                                                                                                                                                                      |
| **cm**       | a centimeter                                                                                                                                                                      |
| **in**       | inch                                                                                                                                                                              |
| **ex**       | roughly the height of an 'x' (lowercase) in the current font (it depends on the font used)                                                                                        |
| **em**       | roughly the width of an 'M' (uppercase) in the current font (it depends on the font used)                                                                                         |
| **mu**       | math unit equal to 1/18 em, where em is taken from the math symbols family                                                                                                        |

**Having an unexpandable token in the wrong place**

The above is actually a case of this. TeX parses lengths as any number of digits followed by an optional dot followed by any number of digits followed by an optional space followed by any valid unit. While TeX searches for a length it expands every expandable token (macro) until it finds the first unexpandable token.

**Having a linebreak \\\ followed by square brackets:**

If a linebreak command **`\\`** is ever followed by square brackets **`[...]`**, it will be taken as an optional argument, and thus a number with a unit will be expected inside the square brackets This is even true if there is whitespace and newlines between the **`\\`** and **`[...]`** commands. This problem often appears in tables, as shown below:

```latex
\begin{tabular}{c|c}
    [t] & s\\
    [I] & A\\
    [m] & kg
\end{tabular}
```

This will generate an error, as on the third line, we have a linebreak followed by squared brackets. LaTeX expects a number with a unit inside the square brackets, but instead finds **`x`**. The correct way to write the above table is to include the square brackets inside curly braces **`{...}`** as shown below or, if the grouping effects of the braces is undesirable, to put a **`\relax`** before it:

```latex
\begin{tabular}{c|c}
    [t] &  s\\
    {[I]} & A\\\relax
    [m] & kg
\end{tabular}
```

**Using the subfigure package:**

The **`subfigure`** package is long outdated, and will generate a 'Illegal unit of measure' error when there is no error present. An example of this is shown below:

```latex
% In your preamble
\usepackage{subfigure}

% In the body of your document
\begin{figure}
    \centering
    \begin{subfigure}[b]{0.3\textwidth}
        \includegraphics[scale=0.2]{image}
        \caption{A gull}
        \label{fig:gull}
    \end{subfigure}%
\end{figure}
```

This will generate an error, as the subfigure package does not recognise **`\textwidth`** as containg a unit, when it is in fact a predefined measurement (equivalent to the constant width of the total text block on a page). The way to resolve this is to use the more updated **`subcaption`** package, which has replaced **`subfigure`**. Writing the same code as above with **`\usepackage{subcaption}`** in the preamble instead of **`\usepackage{subfigure}`** will give the desired result without any error.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/latex/latex-errors/10-illegal-unit-of-measure-pt-inserted.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
