LabCanvas

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.

A rounded box with the text: This picture was made with PGF 3.1.12.
\pgfversion expands to the installed version: LabCanvas’s TeX Live 2026 has PGF 3.1.12.
Preamble: \usepackage{tikz}
\begin{tikzpicture}
  \node[draw, rounded corners, inner sep=6pt] {This picture was made with PGF \pgfversion};
\end{tikzpicture}
Open in the TikZ editor
Full document
A complete file you can compile as it is.
\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

EditionWhereNotes
Official PDF on CTANctan.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 computertexdoc tikz or texdoc pgf in a terminalTeX 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 editiontikz.devUnofficial, 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 teampgf-tikz.github.io/pgf/pgfmanual.pdfThe “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 coversRead 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 pgfplotsRarely: 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 libraryLooking 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…Readtikz.devOn LabCanvas
Learn TikZ from the start§2 Tutorial: A Picture for Karl’s Students (and §3–6, the other tutorials)tutorialTikZ: what it is and how to use it
Load TikZ and libraries; tikzpicture options; scopes; styles§12 Hierarchical Structurestikz-scopesThe tikzpicture environment
Coordinates: polar, relative, named, intersections, calc§13 Specifying Coordinatestikz-coordinatesCoordinates at a glance
Lines, rectangles, circles, arcs, grids, curves§14 Syntax for Path Specificationstikz-pathsLines, rectangles
Colour, line width, dashes, fill, shading, clipping, bounding box§15 Actions on Pathstikz-actionsLines
Arrow tips§16 Arrows (§16.5 lists the tips of arrows.meta)tikz-arrowsArrows
Nodes: text, shapes, anchors, positioning, labels, edges§17 Nodes and Edgestikz-shapesText boxes
More node shapes: ellipse, diamond, cylinder, star…§71 Shape Librarylibrary-shapesRectangles
Small reusable pictures (pics)§18 Pics: Small Pictures on Pathstikz-pics
Graphs with the graph syntax§19 Specifying Graphstikz-graphs
Grids of nodes (matrices)§20 Matrices and Alignmenttikz-matricesCommutative diagrams
Trees§21 Making Trees Growtikz-trees
Plot a function with TikZ alone§22 Plots of Functionstikz-plots
Opacity and fadings§23 Transparencytikz-transparency
Zigzags, snakes, braces, markings along a path§24 Decorated Paths and §50 Decoration Librarytikz-decorations, library-decorations
Scale, rotate, shift, slant§25 Transformationstikz-transformationsScaling a tikzpicture
Drop shadows§70 Shadows Librarylibrary-shadowsShadows
Backgrounds and layers§45 Background Librarylibrary-backgrounds
A frame around a group of nodes§54 Fitting Librarylibrary-fit
Hatching and dot patterns§62 Pattern Librarylibrary-patterns
3D drawings on planes§40 Three Dimensional Drawing Librarylibrary-3d
Circuits§49 Circuit Libraries (TikZ’s own; circuitikz is a separate package)library-circuitscircuitikz
Repeat with \foreach§88 Repeating Things: The Foreach Statementpgffor
Keys and styles in depth (/.style, /.append style)§87 Key Managementpgfkeys
Maths in coordinates and options§94 Mathematical Expressionsmath-parsing
Compile pictures once and reuse them (faster documents)§52 Externalization Librarylibrary-external
Automatic graph layouts (LuaLaTeX)§27–35 Graph Drawinggd-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.

PackageForManual
pgfplots (1.18.3)Plots with axes, legends and dataCTAN (PDF), tikz.dev/pgfplots; texdoc pgfplots
tikz-cd (1.0)Commutative diagramsCTAN, tikz.dev/tikz-cd; texdoc tikz-cd
circuitikz (1.8.7)Electrical and electronic circuitsCTAN, the project’s site; texdoc circuitikz
chemfig (1.84)Molecules and reaction schemesCTAN, tikz.dev/chemfig; texdoc chemfig

Finding what you need in the manual

  1. 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.
  2. 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.
  3. 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.
  4. 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

  1. CTAN: the pgf package (version 3.1.12, manual, licences)ctan.org
  2. CTAN announcement and release notes: pgf 3.1.12, released 1 August 2026ctan.org
  3. CTAN announcement: pgf 3.1.11a, 29 August 2025ctan.org
  4. PGF/TikZ manual (version 3.1.12), PDF on CTAN (1,324 pages)mirrors.ctan.org
  5. PGF/TikZ manual (version 3.1.12), PDF from the PGF/TikZ teampgf-tikz.github.io
  6. PGF/TikZ manual (version 3.1.12), HTML edition at tikz.dev (title page: version and maintainer)tikz.dev
  7. PGF/TikZ manual (version 3.1.12), §1.4 How to Read This Manualtikz.dev
  8. PGF/TikZ manual (version 3.1.12), §1.6 Getting Helptikz.dev
  9. PGF/TikZ manual (version 3.1.12), §8.1 Package and Driver Versionstikz.dev
  10. PGF/TikZ manual (version 3.1.12), §9.1 Which License Applies?tikz.dev
  11. PGF/TikZ manual (version 3.1.12), §28 Using Graph Drawing in TikZ (requires LuaTeX)tikz.dev
  12. texdoc manual (v4.1.2), §3.1 How Texdoc worksmirrors.ctan.org
  13. texdoc configuration (texdoc.cnf): alias tikz = pgfmanualmirrors.ctan.org
  14. The TeX Live Guide 2026, §3.2.4 Options (documentation tree) and §5.2 tlmgrtug.org
  15. TeX Live: TeX Live 2026, released 1 March 2026tug.org
  16. Overleaf docs: Selecting a TeX Live version and LaTeX compilerdocs.overleaf.com
  17. 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.

More TikZ guides

Tools

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