Every LaTeX user eventually runs into compile errors. This guide explains common LaTeX error messages, including Missing $ inserted, Undefined control sequence, and Content after \end{document} is ignored, then shows how to fix them with clear examples.
How to Read LaTeX Error Messages
Before diving into specific errors, let’s understand how to read error messages:
! Missing $ inserted.
<inserted text>
$
l.15 The area is x^
2 square units.
| Part | Meaning |
|---|
! | Indicates an error |
Missing $ inserted | The error description |
l.15 | Line number where the error occurred |
x^ | The specific text causing the problem |
Pro tip: In LaTeX Cloud Studio, click on error messages to jump directly to the problematic line.
Error 1: Missing $ inserted
The most common LaTeX error. This happens when you use math symbols outside of math mode.
The Error
! Missing $ inserted.
<inserted text>
$
l.10 The formula x^2 + y^2 = z^
2 shows...
Why It Happens
Characters like ^, _, \sum, \int, and Greek letters (\alpha, \beta) only work inside math mode.
The Fix
Before (Wrong):
The formula x^2 + y^2 = z^2 shows the Pythagorean theorem.
The value is approximately \pi.
After (Correct):
The formula $x^2 + y^2 = z^2$ shows the Pythagorean theorem.
The value is approximately $\pi$.
Quick Reference
| Symbol Type | Requires Math Mode? | Example |
|---|
Superscripts (^) | Yes | $x^2$ |
Subscripts (_) | Yes | $x_i$ |
| Greek letters | Yes | $\alpha$, $\beta$ |
| Math operators | Yes | $\sum$, $\int$ |
| Regular text | No | Hello world |
Error 2: Undefined control sequence
This error occurs when LaTeX doesn’t recognize a command you’ve used.
The Error
! Undefined control sequence.
l.12 \begn
{document}
Why It Happens
- Typo in command name
- Missing package that defines the command
- Using a command in the wrong context
The Fix
Common typos:
% Wrong
\begn{document}
\sectoin{Title}
\includ{file}
% Correct
\begin{document}
\section{Title}
\include{file}
Missing package:
% Wrong - using \includegraphics without graphicx
\documentclass{article}
\begin{document}
\includegraphics{image} % Error!
\end{document}
% Correct - add the package
\documentclass{article}
\usepackage{graphicx}
\begin{document}
\includegraphics{image}
\end{document}
Common Commands and Required Packages
| Command | Required Package |
|---|
\includegraphics | graphicx |
\url, \href | hyperref |
\toprule, \midrule | booktabs |
\align environment | amsmath |
\textcolor | xcolor |
\SI, \si | siunitx |
Error 3: Missing } inserted
LaTeX expects every { to have a matching }.
The Error
! Missing } inserted.
<inserted text>
}
l.8 \textbf{This is bold text
Why It Happens
- Forgot closing brace
- Mismatched braces
- Special character not escaped
The Fix
Before (Wrong):
\textbf{This is bold text
\section{Introduction
\textit{Nested \textbf{formatting} example
After (Correct):
\textbf{This is bold text}
\section{Introduction}
\textit{Nested \textbf{formatting} example}
Finding Mismatched Braces
Count opening and closing braces—they should be equal:
% Use editor brace matching (hover over { to find matching })
\textbf{This is \textit{nested} text}
^ ^
|____________________________|
LaTeX Cloud Studio tip: Enable brace matching in settings to highlight matching pairs.
Error 4: File not found
LaTeX cannot locate a file you’re trying to include.
The Error
! LaTeX Error: File `myimage.png' not found.
Type X to quit or <RETURN> to proceed,
or enter new name. (Default extension: png)
Why It Happens
- File doesn’t exist
- Wrong file path
- Wrong file name (case-sensitive!)
- File extension issues
The Fix
Check file location:
% If your file structure is:
% project/
% main.tex
% images/
% diagram.png
% Wrong
\includegraphics{diagram}
% Correct
\includegraphics{images/diagram}
Check file name (case-sensitive on Linux/Mac):
% File is named "Diagram.png"
% Wrong (on Linux/Mac)
\includegraphics{diagram}
% Correct
\includegraphics{Diagram}
For bibliography files:
% Wrong
\bibliography{References} % But file is references.bib
% Correct
\bibliography{references}
Error 5: Environment undefined
You’re trying to use an environment that doesn’t exist or isn’t loaded.
The Error
! LaTeX Error: Environment align undefined.
Why It Happens
- Misspelled environment name
- Missing package
- Using environment incorrectly
The Fix
Misspelled environment:
% Wrong
\begin{itemise}
\end{itemise}
% Correct
\begin{itemize}
\end{itemize}
Missing package for math environments:
% Wrong - align needs amsmath
\documentclass{article}
\begin{document}
\begin{align}
y &= mx + b
\end{align}
\end{document}
% Correct
\documentclass{article}
\usepackage{amsmath}
\begin{document}
\begin{align}
y &= mx + b
\end{align}
\end{document}
Common Environments and Required Packages
| Environment | Required Package |
|---|
align, gather, multline | amsmath |
lstlisting | listings |
minted | minted |
tikzpicture | tikz |
algorithm | algorithm2e or algorithmicx |
Error 6: Overfull/Underfull hbox
These are warnings (not errors) about line breaking issues.
The Warning
Overfull \hbox (15.2pt too wide) in paragraph at lines 10--12
Underfull \hbox (badness 10000) in paragraph at lines 15--17
Why It Happens
- Overfull: Line is too long, extends into margin
- Underfull: Line has too much space, looks stretched
The Fix
For overfull (too wide):
% Option 1: Allow hyphenation
\usepackage[hyphens]{url}
% Option 2: Use sloppypar for problematic paragraphs
\begin{sloppypar}
This paragraph contains a very long URL or technical term
that LaTeX struggles to break properly.
\end{sloppypar}
% Option 3: Add manual break hints
super\-cali\-fragi\-listic
% Option 4: For URLs
\usepackage{hyperref}
\url{https://very-long-url-that-causes-problems.com/path}
For underfull (too sparse):
% Usually happens with \\ at paragraph end
% Wrong
This is the end of a paragraph.\\
% Correct
This is the end of a paragraph.
Don’t ignore these warnings! Overfull boxes can cause text to extend beyond page margins, looking unprofessional in printed documents.
Error 7: Missing \begin
LaTeX can’t find where your document content starts.
The Error
! LaTeX Error: Missing \begin{document}.
Why It Happens
- Content before
\begin{document}
- Missing
\begin{document} entirely
- Encoding issues with invisible characters
The Fix
Content in preamble:
% Wrong
\documentclass{article}
\usepackage{amsmath}
This text is in the wrong place! % Error here
\begin{document}
Actual content
\end{document}
% Correct
\documentclass{article}
\usepackage{amsmath}
\begin{document}
This text is in the right place!
Actual content
\end{document}
Check for invisible characters:
% Sometimes copy-paste introduces hidden characters
% Delete and retype the line if you suspect this
\documentclass{article} % Delete and retype this line
\begin{document}
\end{document}
Error 8: Too many }‘s
You have more closing braces than opening ones.
The Error
Why It Happens
- Extra closing brace
- Deleted opening brace
- Copy-paste error
The Fix
Find and remove the extra brace:
% Wrong
\textbf{Some bold text}}
% Correct
\textbf{Some bold text}
Check for mismatched environments:
% Wrong
\begin{itemize}
\item First
\end{enumerate} % Wrong environment!
% Correct
\begin{itemize}
\item First
\end{itemize}
Error 9: Misplaced alignment tab character &
The & character has special meaning in tables and math alignment.
The Error
! Misplaced alignment tab character &.
l.10 Bread & butter
Why It Happens
- Using
& in regular text (it’s reserved for tables)
- Wrong number of
& in a table row
& outside tabular environment
The Fix
In regular text, escape the ampersand:
% Wrong
Bread & butter
Smith & Jones LLC
% Correct
Bread \& butter
Smith \& Jones LLC
In tables, check column count:
% Wrong - 3 columns defined, but 4 values in row
\begin{tabular}{|l|c|r|}
A & B & C & D \\ % Error! Too many &
\end{tabular}
% Correct
\begin{tabular}{|l|c|r|l|} % 4 columns
A & B & C & D \\
\end{tabular}
Error 10: Dimension too large
A calculated dimension exceeds LaTeX’s maximum.
The Error
! Dimension too large.
l.25 \includegraphics[width=2\textwidth]{image}
Why It Happens
- Image scaled too large
- Infinite or very large calculation
- Negative dimensions
The Fix
For images:
% Wrong
\includegraphics[width=2\textwidth]{image}
% Correct
\includegraphics[width=\textwidth]{image}
\includegraphics[width=0.8\textwidth]{image}
For spacing:
% Wrong - this creates infinite stretch
\hspace{\fill}text\hspace{\fill}
% Correct
\hfill text \hfill
Bonus: General Debugging Tips
1. Compile Often
Don’t write 50 lines before compiling. Compile after each significant addition to catch errors early.
2. Binary Search for Errors
If you have a mysterious error:
% Comment out half your document
\begin{document}
First half of content
%{
Second half of content
%}
\end{document}
If it compiles, the error is in the second half. Repeat until you find the problematic line.
3. Start Fresh
If an error is truly mysterious:
% Create minimal example
\documentclass{article}
\begin{document}
% Paste suspicious code here
\end{document}
4. Check Log File
The .log file contains detailed information:
This is pdfTeX, Version 3.141592653
...
! Missing $ inserted.
<inserted text>
$
l.10 x^
2
5. Clear Auxiliary Files
Sometimes old .aux, .log, .toc files cause problems:
# Delete auxiliary files and recompile
rm *.aux *.log *.toc *.out
Quick Error Reference Table
| Error Message | Likely Cause | Quick Fix |
|---|
| Missing $ inserted | Math outside math mode | Add $...$ |
| Undefined control sequence | Typo or missing package | Check spelling, add package |
| Missing } inserted | Unclosed brace | Add missing } |
| File not found | Wrong path or name | Check path, case sensitivity |
| Environment undefined | Missing package | Add required package |
| Overfull hbox | Line too wide | Use \sloppy or break text |
| Missing \begin | Content in preamble | Move text after \begin{document} |
| Too many }‘s | Extra closing brace | Remove extra } |
| Misplaced & | & in regular text | Use \& to escape |
| Dimension too large | Oversized element | Reduce size values |
Need More Help?
LaTeX Cloud Studio advantage: Our editor highlights errors in real-time and provides AI-powered suggestions to fix common issues automatically.