The PGF/TikZ manual: where to find it and which part to read
Quick answer
The official PGF/TikZ manual is a PDF of 1,324 pages on the CTAN page of the pgf package, 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. Both describe PGF 3.1.12, the current version, released on 1 August 2026.

\usepackage{tikz}\begin{tikzpicture}
\node[draw, rounded corners, inner sep=6pt] {This picture was made with PGF \pgfversion};
\end{tikzpicture}
Full document
\documentclass[border=4pt]{standalone}
\usepackage{tikz}
\begin{document}
\begin{tikzpicture}
\node[draw, rounded corners, inner sep=6pt] {This picture was made with PGF \pgfversion};
\end{tikzpicture}
\end{document}Contents
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.
- 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
\usetikzlibraryline 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 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)ctan.org
- CTAN announcement and release notes: pgf 3.1.12, released 1 August 2026ctan.org
- CTAN announcement: pgf 3.1.11a, 29 August 2025ctan.org
- PGF/TikZ manual (version 3.1.12), PDF on CTAN (1,324 pages)mirrors.ctan.org
- PGF/TikZ manual (version 3.1.12), PDF from the PGF/TikZ teampgf-tikz.github.io
- PGF/TikZ manual (version 3.1.12), HTML edition at tikz.dev (title page: version and maintainer)tikz.dev
- PGF/TikZ manual (version 3.1.12), §1.4 How to Read This Manualtikz.dev
- PGF/TikZ manual (version 3.1.12), §1.6 Getting Helptikz.dev
- PGF/TikZ manual (version 3.1.12), §8.1 Package and Driver Versionstikz.dev
- PGF/TikZ manual (version 3.1.12), §9.1 Which License Applies?tikz.dev
- PGF/TikZ manual (version 3.1.12), §28 Using Graph Drawing in TikZ (requires LuaTeX)tikz.dev
- texdoc manual (v4.1.2), §3.1 How Texdoc worksmirrors.ctan.org
- texdoc configuration (texdoc.cnf): alias tikz = pgfmanualmirrors.ctan.org
- The TeX Live Guide 2026, §3.2.4 Options (documentation tree) and §5.2 tlmgrtug.org
- TeX Live: TeX Live 2026, released 1 March 2026tug.org
- Overleaf docs: Selecting a TeX Live version and LaTeX compilerdocs.overleaf.com
- CTAN: pgfplots (1.18.3), tikz-cd (1.0), circuitikz (1.8.7), chemfig (1.84)ctan.org
The facts on this page were checked against these sources, and every picture is the code with it typeset with TeX Live 2026. Code on this page: CC0 1.0, copy it freely.
Try the code in your browserEvery snippet on this page opens in the free TikZ editor: it is typeset with TeX Live as you type, with errors pointed at their line.
Open the TikZ editor