A good pergola diagram turns a vague backyard dream into a buildable plan with real measurements. Before you cut a single board, you should be able to name every part, know how the loads travel down to the ground, and understand the spacing that keeps the structure square and stable. This guide walks through the anatomy piece by piece, then shows you how to read and use a diagram to order materials and lay out your project.
Part of our Decks & Outdoor guide — explore the full guide →
I have framed dozens of these in the field, and the projects that go smoothly all share one thing: the homeowner understood the drawing before the lumber arrived. Spend an afternoon with a diagram and you save yourself days of guesswork.
The Anatomy of a Pergola
Every pergola, attached or freestanding, is built from the same five structural families. A diagram simply shows how they stack and connect.
- Posts: The vertical members that carry the entire load to the ground. Common sizes are 6×6 for spans up to 12 feet and 8×8 for larger or windier sites. A 4×4 post is fine for a small 8-by-8-foot pergola but feels undersized on anything bigger.
- Beams (or girders): The horizontal members that sit on top of or bolt to the sides of the posts. They run the length of the structure and tie the posts together. Doubled 2×10 or 2×12 beams are typical for a 12-foot span.
- Rafters: The members that run perpendicular to the beams, resting on top of them. Rafters define the roof plane and give the pergola its ladder look. Standard 2×8 rafters spaced 16 to 24 inches on center work for most residential spans.
- Purlins (or top slats): The smallest top layer, running perpendicular to the rafters. Purlins of 2×2 or 1×4 stock provide the dappled shade pergolas are known for. Closer spacing means more shade.
- Footings: The concrete foundation below grade that anchors each post. A typical footing is 12 inches in diameter and 36 to 48 inches deep, set below the local frost line.
When you look at a diagram, trace the load path top to bottom: purlins rest on rafters, rafters rest on beams, beams transfer to posts, and posts deliver everything to the footings. Any weak link in that chain shows up as sag or sway within a season.
How to Read and Use a Pergola Diagram
A useful diagram includes at least three views: a plan view looking straight down, a front elevation, and a side elevation. Together they pin down every dimension you need to buy and cut material.
Plan View
The plan view shows post locations, beam runs, and rafter spacing as if you were a bird overhead. Look here for your overall footprint and for the on-center spacing of rafters. If the drawing reads “2×8 rafters @ 24 in. O.C.,” you measure 24 inches from the center of one rafter to the center of the next, not edge to edge. That distinction trips up beginners constantly.
Elevation Views
Elevations give you heights. They show finished post height (commonly 8 to 10 feet of usable clearance), the depth of the beams, and how far the rafter tails overhang the beams. A 12- to 18-inch overhang is standard and looks intentional; anything past 24 inches starts to droop unless you upsize the lumber.
Connection Details
Good diagrams include callouts for hardware: post bases, through-bolts, and rafter clips. Watch for notes like “2 x 1/2 in. carriage bolts per beam-to-post joint.” Those small details are what separate a structure that survives a storm from one that racks loose.
Dimensions and Spacing That Actually Work
Numbers from a diagram only help if they reflect sound carpentry. Here are the figures I rely on for a standard residential pergola.
- Post spacing: Keep beams spanning 10 to 12 feet between posts. Push past 14 feet and you need to double or triple your beam stock or add an intermediate post.
- Rafter spacing: 16 inches on center for heavier shade and stiffness, 24 inches for an airier look and less lumber. Sixteen-inch spacing adds material cost but reduces bounce.
- Purlin spacing: 6 to 12 inches on center depending on how much shade you want. Tighter spacing in the 4- to 6-inch range can block roughly half the midday sun.
- Footing depth: Below your frost line, period. In northern climates that can mean 42 to 48 inches; in the South, 24 inches may pass code.
Sketch these onto your diagram before ordering. A 12-by-16-foot freestanding pergola with 24-inch rafter spacing needs roughly nine rafters per run, and forgetting that math is how people end up two boards short on a Sunday.
Attached vs. Freestanding Pergolas
The single biggest decision your diagram captures is whether the pergola attaches to the house or stands on its own. Each version changes the framing.
A freestanding pergola uses four or more posts and carries beams on all sides. It is the more forgiving build because every connection is identical and the structure is symmetrical. Place it anywhere in the yard, away from the house, over a patio or fire pit.
An attached pergola replaces one beam with a ledger board lag-bolted to the house framing. The ledger must land on solid rim joist or studs, never just on siding, and it needs proper flashing to keep water out of the wall. A diagram for an attached pergola will show the ledger detail, the flashing, and lag-bolt spacing, usually 16 inches on center staggered. Get this detail wrong and you invite rot into your wall sheathing.
Choosing Between Them
Attached pergolas use fewer posts and feel like an extension of the home, which works well over a back door or kitchen patio. Freestanding versions give you placement freedom and avoid touching the house structure altogether. If your siding is stucco or brick veneer, freestanding is often the simpler, lower-risk path.
From Diagram to Material List
Once your diagram is dimensioned, build the takeoff. Count posts, then linear feet of beam stock, then rafters, then purlins. Add 10 percent for waste and bad boards. For a 12-by-12-foot freestanding pergola in pressure-treated lumber, expect to spend roughly $1,200 to $2,500 in materials depending on species; cedar or redwood lands higher, around $2,500 to $4,500.
Bag concrete for footings is easy to underestimate. A 12-inch-diameter, 42-inch-deep hole takes about three to four 60-pound bags of concrete mix per post. Six posts can mean two dozen bags, so price that into your plan.
A Note on Permits and Codes
Most municipalities treat a pergola as a permanent structure once it is anchored to footings, which means it usually requires a building permit. Many jurisdictions exempt small freestanding structures under 120 square feet, but setback rules from property lines almost always apply. Bring your dimensioned diagram to the permit office; inspectors approve drawings far faster than verbal descriptions.
Check footing depth, post size, and beam-span requirements against your local code before you finalize anything. Codes exist because under-built pergolas fail in wind, and a permit inspection is cheap insurance compared to a rebuild.
Final Thoughts
A pergola diagram is the cheapest tool in the whole project and the one that saves the most time and money. Learn the five structural families, read all three views, lock in your spacing, and confirm your footing depth against local code. Do that, and the build becomes a weekend of confident assembly rather than a string of trips back to the lumberyard.
