# The PGF/TikZ manual: where to find it and which part to read

> Where the official PGF/TikZ manual is (CTAN PDF, texdoc tikz, the tikz.dev HTML edition), which version it describes, and which section to read for each task.

URL: https://www.labcanvas.com/tikz/manual

Updated 2026-11-22. Pictures typeset with TeX Live 2026 and PGF 3.1.12; each is made from the code under it, in a standalone document with the preamble lines shown. Code on this page: CC0 1.0 (https://creativecommons.org/publicdomain/zero/1.0/), copy freely. Try any snippet in the TikZ editor: https://www.labcanvas.com/tools/tikz-editor

## Quick answer

The official PGF/TikZ manual is a PDF of 1,324 pages on the [CTAN page of the pgf package](https://ctan.org/pkg/pgf), and TeX Live installs it with the package: run `texdoc tikz` or `texdoc pgf` to open it. An HTML edition of the same manual, maintained by Dominik Peters, is at [tikz.dev](https://tikz.dev/). Both describe PGF 3.1.12, the current version, released on 1 August 2026.

![A rounded box with the text: This picture was made with PGF 3.1.12.](https://www.labcanvas.com/tikz-snippets/manual/pgf-version.webp)

*\pgfversion expands to the installed version: LabCanvas’s TeX Live 2026 has PGF 3.1.12.*

Preamble: `\usepackage{tikz}`

```latex
\begin{tikzpicture}
  \node[draw, rounded corners, inner sep=6pt] {This picture was made with PGF \pgfversion};
\end{tikzpicture}
```

## Where to get the manual

| Edition | Where | Notes |
| --- | --- | --- |
| Official PDF on CTAN | ctan.org/pkg/pgf, link “PGF Manual” ( pgfmanual.pdf) | The manual of the released version: 3.1.12, 1,324 pages, 9.5 MB, built on 1 August 2026. |
| On your computer | texdoc tikz or texdoc pgf in a terminal | TeX Live’s pgf package includes pgfmanual.pdf, and texdoc’s configuration sends both words to it. If nothing opens, the documentation was not installed: TeX Live’s installer has an option to leave it out. |
| HTML edition | tikz.dev | Unofficial, maintained by Dominik Peters and produced with the lwarp package; one web page per chapter, an anchor for each key and a copy button on the examples. On 22 November 2026 it said “Manual for Version 3.1.12”, updated 9 November 2026. |
| PDF from the PGF/TikZ team | pgf-tikz.github.io/pgf/pgfmanual.pdf | The “Official PDF version” tikz.dev links to. The copy there on 22 November 2026 was built on 9 November 2026 (1,323 pages) and also says version 3.1.12. |

The manual is free documentation: you may copy and share it under the GNU Free Documentation License 1.2 or the LaTeX Project Public License 1.3c, at your choice.

## Which version the manual describes

The current release is **PGF 3.1.12**, uploaded to CTAN by the PGF/TikZ team in August 2026 (the release is dated 1 August 2026; the version before it was 3.1.11a, from August 2025). The manual says it belongs to version 3.1.12 and that this version needs at least TeX Live 2020 and xcolor 2.00.

What changed in 3.1.12, from its release notes: a few breaking changes, mostly internal (it needs a TeX built with Web2C 2020 or newer, and file lookups now use LaTeX’s own functions), about fifteen fixes, and additions such as a monotonic interpolation plot handler and the keys `actualtext`, `alt` and `artifact`, accepted (and ignored) by TikZ for use in tagged PDF.

Your own installation may be older. TeX Live 2026 was released on 1 March 2026, before 3.1.12, so an installation from that release has 3.1.12 only once it is updated with `tlmgr update`; an Overleaf project uses the TeX Live version chosen in its settings. To see what you have, typeset `\pgfversion`, as in the picture above, which LabCanvas’s TeX Live 2026 typesets as 3.1.12. If a key from the manual is unknown to your installation, compare the versions first.

## How the manual is organised

The manual describes TikZ first and the layers below it last, roughly from the most used to the most technical. Its own advice: install, read the tutorial, then skim the TikZ part; the basic and system layers are rarely needed.

| Part (PDF page) | What it covers | Read it when |
| --- | --- | --- |
| I Tutorials and Guidelines (p. 30) | Five tutorials (§2–6) and guidelines on graphics (§7) | You are starting out |
| II Installation and Configuration (p. 102) | Versions and requirements, licences, supported formats and drivers (§8–10) | Something does not load, or you need the licence |
| III TikZ ist kein Zeichenprogramm (p. 123) | The TikZ language: coordinates, paths, actions, arrows, nodes, pics, graphs, matrices, trees, plots, transparency, decorations, transformations, animations (§11–26) | Daily reference |
| IV Graph Drawing (p. 416) | Automatic layouts of graphs and trees; needs LuaLaTeX (§27–39) | You want TikZ to place the nodes for you |
| V Libraries (p. 564) | One chapter per library: shapes, positioning helpers, decorations, shadows, patterns, external… (§40–78) | You load a library and want its options |
| VI Data Visualization (p. 853) | PGF’s own plotting system (§79–86); not the same as pgfplots | Rarely: most people plot with pgfplots |
| VII Utilities (p. 975) | pgfkeys, \foreach, calendars, page layouts, colour (§87–92) | Styles in depth and loops |
| VIII Mathematical and Object-Oriented Engines (p. 1029) | Expressions, functions, number printing (§93–98) | You compute with \pgfmathparse |
| IX The Basic Layer (p. 1073) | PGF’s commands under TikZ (§99–118) | You write a package or a new shape |
| X The System Layer (p. 1234) | The driver interface (§119–123) | You port PGF to a new driver |
| XI References and Index (p. 1274) | The index of every command, key and library | Looking up a key by name |

## Which section to read for each task

Section numbers are those of the 3.1.12 manual, the same in the PDF and on tikz.dev; the last column links to the LabCanvas page on the same subject, where there is one.

| To… | Read | tikz.dev | On LabCanvas |
| --- | --- | --- | --- |
| Learn TikZ from the start | §2 Tutorial: A Picture for Karl’s Students (and §3–6, the other tutorials) | tutorial | TikZ: what it is and how to use it |
| Load TikZ and libraries; tikzpicture options; scopes; styles | §12 Hierarchical Structures | tikz-scopes | The tikzpicture environment |
| Coordinates: polar, relative, named, intersections, calc | §13 Specifying Coordinates | tikz-coordinates | Coordinates at a glance |
| Lines, rectangles, circles, arcs, grids, curves | §14 Syntax for Path Specifications | tikz-paths | Lines, rectangles |
| Colour, line width, dashes, fill, shading, clipping, bounding box | §15 Actions on Paths | tikz-actions | Lines |
| Arrow tips | §16 Arrows (§16.5 lists the tips of arrows.meta) | tikz-arrows | Arrows |
| Nodes: text, shapes, anchors, positioning, labels, edges | §17 Nodes and Edges | tikz-shapes | Text boxes |
| More node shapes: ellipse, diamond, cylinder, star… | §71 Shape Library | library-shapes | Rectangles |
| Small reusable pictures (pics) | §18 Pics: Small Pictures on Paths | tikz-pics |  |
| Graphs with the graph syntax | §19 Specifying Graphs | tikz-graphs |  |
| Grids of nodes (matrices) | §20 Matrices and Alignment | tikz-matrices | Commutative diagrams |
| Trees | §21 Making Trees Grow | tikz-trees |  |
| Plot a function with TikZ alone | §22 Plots of Functions | tikz-plots |  |
| Opacity and fadings | §23 Transparency | tikz-transparency |  |
| Zigzags, snakes, braces, markings along a path | §24 Decorated Paths and §50 Decoration Library | tikz-decorations, library-decorations |  |
| Scale, rotate, shift, slant | §25 Transformations | tikz-transformations | Scaling a tikzpicture |
| Drop shadows | §70 Shadows Library | library-shadows | Shadows |
| Backgrounds and layers | §45 Background Library | library-backgrounds |  |
| A frame around a group of nodes | §54 Fitting Library | library-fit |  |
| Hatching and dot patterns | §62 Pattern Library | library-patterns |  |
| 3D drawings on planes | §40 Three Dimensional Drawing Library | library-3d |  |
| Circuits | §49 Circuit Libraries (TikZ’s own; circuitikz is a separate package) | library-circuits | circuitikz |
| Repeat with \foreach | §88 Repeating Things: The Foreach Statement | pgffor |  |
| Keys and styles in depth (/.style, /.append style) | §87 Key Management | pgfkeys |  |
| Maths in coordinates and options | §94 Mathematical Expressions | math-parsing |  |
| Compile pictures once and reuse them (faster documents) | §52 Externalization Library | library-external |  |
| Automatic graph layouts (LuaLaTeX) | §27–35 Graph Drawing | gd-usage-tikz |  |

## Manuals of packages built on TikZ

Packages built on TikZ have their own manuals, not chapters of the PGF/TikZ manual. tikz.dev hosts HTML editions of several of them.

| Package | For | Manual |
| --- | --- | --- |
| pgfplots (1.18.3) | Plots with axes, legends and data | CTAN (PDF), tikz.dev/pgfplots; texdoc pgfplots |
| tikz-cd (1.0) | Commutative diagrams | CTAN, tikz.dev/tikz-cd; texdoc tikz-cd |
| circuitikz (1.8.7) | Electrical and electronic circuits | CTAN, the project’s site; texdoc circuitikz |
| chemfig (1.84) | Molecules and reaction schemes | CTAN, tikz.dev/chemfig; texdoc chemfig |

## Finding what you need in the manual

- **Look the key up by name.** The index (part XI) lists every command, key and library. On tikz.dev, the keys have their own anchors you can link to, such as [/tikz/baseline](https://tikz.dev/tikz-scopes#pgf./tikz/baseline).
- **Read the key’s entry, not only its example.** Each entry gives the key’s full path (`/tikz/baseline`), its value and its default. In the PDF, the command or key being defined is printed in red and optional parts in green.
- **Load the library the example names.** When an example needs a library, the manual shows its `\usetikzlibrary` line above the code. Copy that line too, or the example fails with an unknown key.
- **Try the example, then change one thing.** Paste it into the [TikZ editor](https://www.labcanvas.com/tools/tikz-editor) or your own document, check it compiles, then adapt it.

When the manual does not answer the question, it suggests looking through the development page’s issues, where a similar problem may already be solved, and asking on the pgf-tikz mailing list; both are linked from the CTAN page.

## Frequently asked questions

### Where can I download the TikZ manual?

From the CTAN page of the pgf package (ctan.org/pkg/pgf), as pgfmanual.pdf. If you have TeX Live, it is already on your computer: run `texdoc tikz`.

### Is there an online HTML version of the TikZ manual?

Yes: tikz.dev, an unofficial HTML edition of the PGF/TikZ manual maintained by Dominik Peters. It has the same chapters and section numbers as the PDF.

### What is the latest version of PGF/TikZ?

Version 3.1.12, released on 1 August 2026 (CTAN, August 2026). The previous version was 3.1.11a, from August 2025. Typeset `\pgfversion` to see the version your installation has.

### Why is the TikZ manual called the PGF manual?

TikZ is the frontend of the PGF graphics system, and the package on CTAN is called pgf. The one manual covers TikZ, its libraries and the PGF layers below it, so its file is pgfmanual.pdf.

### How long is the TikZ manual?

The PDF of version 3.1.12 on CTAN has 1,324 pages. Most readers need the tutorials (part I), the TikZ part (part III) and the chapters of the libraries they load.

### Where is the pgfplots documentation?

pgfplots has its own manual: on CTAN (ctan.org/pkg/pgfplots), as `texdoc pgfplots`, and in HTML at tikz.dev/pgfplots.

### Can I share or print the TikZ manual?

Yes. The documentation of PGF/TikZ may be used under the GNU Free Documentation License 1.2 or the LaTeX Project Public License 1.3c.

## References

- [CTAN: the pgf package (version 3.1.12, manual, licences)](https://ctan.org/pkg/pgf)
- [CTAN announcement and release notes: pgf 3.1.12, released 1 August 2026](https://ctan.org/ctan-ann/id/4ed7ec5e4b8ff011@hogwart)
- [CTAN announcement: pgf 3.1.11a, 29 August 2025](https://ctan.org/ctan-ann/id/aLLWMqu3eoFR4n20@prptp)
- [PGF/TikZ manual (version 3.1.12), PDF on CTAN (1,324 pages)](https://mirrors.ctan.org/graphics/pgf/base/doc/generic/pgf/pgfmanual.pdf)
- [PGF/TikZ manual (version 3.1.12), PDF from the PGF/TikZ team](https://pgf-tikz.github.io/pgf/pgfmanual.pdf)
- [PGF/TikZ manual (version 3.1.12), HTML edition at tikz.dev (title page: version and maintainer)](https://tikz.dev/)
- [PGF/TikZ manual (version 3.1.12), §1.4 How to Read This Manual](https://tikz.dev/#sec-1.4)
- [PGF/TikZ manual (version 3.1.12), §1.6 Getting Help](https://tikz.dev/#sec-1.6)
- [PGF/TikZ manual (version 3.1.12), §8.1 Package and Driver Versions](https://tikz.dev/installation#sec-8.1)
- [PGF/TikZ manual (version 3.1.12), §9.1 Which License Applies?](https://tikz.dev/license#sec-9.1)
- [PGF/TikZ manual (version 3.1.12), §28 Using Graph Drawing in TikZ (requires LuaTeX)](https://tikz.dev/gd-usage-tikz#sec-28)
- [texdoc manual (v4.1.2), §3.1 How Texdoc works](https://mirrors.ctan.org/support/texdoc/doc/texdoc.pdf)
- [texdoc configuration (texdoc.cnf): alias tikz = pgfmanual](https://mirrors.ctan.org/support/texdoc/texdoc.cnf)
- [The TeX Live Guide 2026, §3.2.4 Options (documentation tree) and §5.2 tlmgr](https://tug.org/texlive/doc/texlive-en/texlive-en.html)
- [TeX Live: TeX Live 2026, released 1 March 2026](https://tug.org/texlive/)
- [Overleaf docs: Selecting a TeX Live version and LaTeX compiler](https://docs.overleaf.com/getting-started/recompiling-your-project/selecting-a-tex-live-version-and-latex-compiler)
- [CTAN: pgfplots (1.18.3), tikz-cd (1.0), circuitikz (1.8.7), chemfig (1.84)](https://ctan.org/pkg/pgfplots)

## More TikZ guides

- [TikZ: what it is and how to use it in LaTeX](https://www.labcanvas.com/tikz): What TikZ (PGF/TikZ) is and how to use it in LaTeX: the minimal document, libraries, coordinates, a first figure in steps, Overleaf and TeX Live.
- [The tikzpicture environment: options, scaling and centring](https://www.labcanvas.com/tikz/tikzpicture): The tikzpicture environment: its options, scale vs transform shape vs \resizebox, centring it in a figure with a caption, and inline TikZ with baseline.
- [TikZ examples: 179 figures with code, by field](https://www.labcanvas.com/tikz/examples): A gallery of 179 TikZ and pgfplots figures with their full code, from open-source collections (MIT or CC0): physics, maths, machine learning, plots, diagrams.
- [TikZ arrows: arrow tips, sizes, curves and labels](https://www.labcanvas.com/tikz/arrows): All TikZ arrow tips in one rendered table, arrows.meta sizing (length, width, scale, open, round), and curved, labelled, thick, block and squiggly arrows.
- [TikZ lines: dashed, dotted, thickness and line width](https://www.labcanvas.com/tikz/lines): TikZ lines: dashed and dotted styles with their exact patterns, ultra thin to ultra thick widths, dash pattern, caps and joins, double lines, grids.
- [Commutative diagrams with tikz-cd](https://www.labcanvas.com/tikz/commutative-diagrams): Draw commutative diagrams with tikz-cd: the tikzcd grid, \arrow directions, labels, arrow styles, pullbacks, exact sequences, snake lemma and editors.
- [CircuiTikZ: drawing circuits in LaTeX](https://www.labcanvas.com/tikz/circuitikz): Draw circuits in LaTeX with CircuiTikZ 1.8.7: the to[R=$R_1$] syntax, sources, switches, labels, ground, op-amps, transistors, logic gates, full examples.
