The Quick Answer: What Makes a Great Attached Pergola Design
A great attached pergola design is one that looks like it belongs to your home — not like it was bolted on. The most successful Bay Area projects share three traits: the connection point is engineered to fit the home’s architecture, the proportions match the scale of the facade, and the configuration is chosen to match how the outdoor space will actually be used. Below are six configurations we install across the Bay Area, with real examples and design considerations for each.
At StruXure NorCal, we design and install attached Pergola X systems across the Bay Area — from compact urban patios in San Francisco and Menlo Park to expansive backyards in Walnut Creek, Danville, and Pleasanton. This guide walks through the configurations that work, why they work, and how to choose the one that fits your home.
6 Attached Pergola Configurations We Install Across the Bay Area
Every attached pergola we build connects to the home through one of these six configurations. Each one suits a specific architectural condition and outdoor use case. Click through to the linked pages for more on any configuration that fits your project.
Configuration 01
Wall-Mounted Ledger
The classic attached pergola. A structural ledger board fastens directly to the home’s framing, and the pergola extends outward supported by two outer posts. The cleanest visual integration with the house.
Best forSingle-story and two-story homes with solid wall framing and clean patio access
Configuration 02
Deck Attached
An attached pergola installed over an existing deck. The ledger connects to the home above the deck level, and posts anchor through the deck framing or sit on engineered post bases to distribute load properly.
Best forHomes with existing decks that need shade, definition, and weather protection without rebuilding
Configuration 03
Patio Surface-Mounted
Attached on the home side, surface-mounted on existing concrete or paver patios with heavy-duty anchor bolts. No new footings needed — the structure ties into the existing patio slab.
Best forEstablished patios where breaking concrete for footings isn’t desirable or feasible
Configuration 04
Rooftop Terrace Attached
Attached to an existing rooftop wall or parapet, with posts anchored to engineered roof structure. Common on urban Bay Area properties where the rooftop is the primary outdoor space.
Best forSan Francisco, Oakland, and South Bay urban homes with rooftop terraces or upper decks
Configuration 05
Hillside / Uneven Terrain
Attached pergola with adjustable galvanized steel post bases anchored into concrete footings at varying depths. Compensates for grade changes so the pergola sits level across sloped lots.
Best forHillside homes in Oakland Hills, Diablo Foothills, Portola Valley, and Saratoga
Configuration 06
Outdoor Kitchen Extension
Attached pergola designed to cover an outdoor kitchen or dining area built off the home. Higher clearance and tighter coverage make this configuration work for grills, cooktops, and dining tables.
Best forHomeowners building a full outdoor kitchen or year-round dining space adjacent to the home
All six configurations use the same core Pergola X louvered roof system — the louvers, motors, sensors, drainage, and finishes are identical. What changes is the connection geometry and the post strategy. That’s what lets us deliver consistent premium performance across wildly different Bay Area architectural conditions.
Matching the Configuration to Your Outdoor Space
If you know how you’ll use the space, the right configuration usually becomes obvious. Here’s a quick lookup:
Proportion: The Quiet Variable That Makes or Breaks the Design
The single most common mistake in attached pergola design isn’t choosing the wrong configuration — it’s choosing the wrong proportions. A pergola that’s too small for the house looks like a tacked-on accessory. A pergola that’s too tall or too wide overpowers the facade. The structure should feel like it belongs.
Underscaled — Off
A tiny pergola against a large facade reads as an afterthought. The structure gets lost; the house dominates.
Balanced — Right
The pergola top aligns with a visual line on the house (the eave or first-floor header). Width matches the proportions of the adjacent facade.
Three proportion rules that consistently make attached pergolas look intentional:
- Align the pergola top to an existing horizontal line on the house — the gutter, an eave, a window header, or a balcony deck. The eye should be able to follow that line straight from the house into the pergola without a jog.
- Match the pergola width to the visual unit of the facade it attaches to. If your back wall has a clear central section flanked by jutting wings, the pergola should match that center section’s width — not the entire wall.
- Keep the pergola depth in scale with its width. A roughly 1.6:1 width-to-depth ratio (the classic “golden ratio”) feels comfortable. A narrow strip pergola against a wide house looks like a sun visor; a deep pergola off a narrow house looks top-heavy.
For more on sizing decisions, see our guide on how to choose pergola size.
Design Moves That Elevate Any Attached Pergola
Past the structural decisions, a handful of finishing moves consistently separate a good attached pergola from a great one:
Coordinate the Finish to the Home’s Trim
A Pergola X in matte black against a dark trim line reads as architectural. The same pergola in a clashing color reads as an add-on. Powder-coated aluminum is available in standard and custom colors — match it to your fascia, window frames, or roof trim, not to the wall.
Integrate Lighting From Day One
Recessed LED lighting, integrated downlights, and string-light mounting points should be engineered into the design before installation — not added later. The result is a finished outdoor room that works at night, not a daytime structure with afterthought fixtures.
Plan for Screens and Side Privacy
Retractable screens and side panels can transform an attached pergola from a shade structure into a true outdoor room — adding wind protection, privacy from neighbors, and insect control. Engineering the mounting points during the original install is dramatically cleaner than retrofitting.
Match the Smart Controls to How You’ll Actually Use the Space
Wall-mounted control panels work for households where the pergola covers the main entertaining area. App and voice control work better for households that move between zones. Rain and wind sensors are worth the upgrade in any Bay Area microclimate that gets sudden coastal weather changes.
Bay Area-Specific Considerations
Bay Area design notes
Conditions that affect attached pergola design across our service area:
- Coastal microclimates: SF, Marin, and Peninsula coastal homes get fog, salt air, and sudden temperature swings — sensors and motorized louvers earn their keep here
- Tri-Valley heat: Walnut Creek, Livermore, Danville, and Pleasanton see strong afternoon sun — tighter louver coverage and integrated screens add real comfort
- Hillside structural: Oakland Hills, Diablo Foothills, Portola Valley — wind load and slope drive engineering decisions
- HOA architectural review: Master-planned communities like Blackhawk and Ruby Hill have specific aesthetic requirements that should be factored into early design
Attached pergolas in the Bay Area also require permits in most municipalities because they’re classified as home additions. For a full breakdown of what to expect, see our guide on pergola permits and HOA rules in the Bay Area.
Common Mistakes That Sink Attached Pergola Designs
After years of Bay Area installs, the same handful of mistakes keep coming up. All of them are avoidable with the right design upfront:
Skipping the proportion check
Choosing pergola dimensions based on the patio footprint rather than the architectural unit of the facade. The patio is the floor; the house is the wall. The pergola needs to relate to both.
Mismatched horizontal lines
Attaching the pergola at a height that doesn’t relate to any existing line on the house. The eye picks up the misalignment instantly even when no one can articulate what’s wrong.
Wrong configuration for the home
Forcing a wall-mounted ledger onto a home with stucco, complex rooflines, or historic siding when a different configuration (or a freestanding system) would have been the better fit.
Inadequate waterproofing at the ledger
Attached pergolas live or die at the ledger-to-wall connection. Improper flashing or sealant creates moisture intrusion that can cost more to repair than the pergola itself.
Retrofitting features that should’ve been engineered in
Adding lighting, screens, fans, or heaters after install always looks more bolted-on than building them into the original design — and usually costs more in labor.
Bringing the Vision to Your Bay Area Home
An attached pergola, done right, doesn’t just shade a patio — it extends the architecture of your home into the outdoors. The right configuration, the right proportions, the right finish: these are the decisions that determine whether a pergola feels like part of the house or a decoration applied to it.
Every Bay Area home is different. The same configuration that’s perfect for a Walnut Creek single-story bungalow would be wrong for an Atherton two-story or an Oakland hillside contemporary. Design starts with seeing your specific home, your specific outdoor space, and how you actually want to use it.
If you’re ready to explore which configuration fits your home, contact StruXure NorCal today for a free design consultation. We’ll walk through your space, your architecture, and the configuration that gives you the seamless indoor-outdoor connection you’re after.
FAQs
What is a pergola called when it’s attached to the house?
A pergola attached to a house is called an attached pergola, sometimes also referred to as a wall-mounted pergola or lean-to pergola. The specific term varies by region, but all three describe the same configuration: a pergola that connects directly to the home’s exterior wall via a structural ledger board, with the opposite side supported by posts.
Is it okay to attach a pergola to a house?
Yes — attaching a pergola to a house is a standard installation method, provided the connection is engineered properly. The ledger board must anchor into the home’s structural framing (not just the siding), and the connection point must be waterproofed with flashing and sealant to prevent moisture intrusion. Professional installation is strongly recommended because improper ledger work can cause significant water damage to the home over time.
Do I need planning permission to build a pergola attached to my house?
In most Bay Area municipalities, yes — attached pergolas are typically classified as home additions or structural modifications and require a building permit. The permit process usually involves engineered structural plans showing the ledger connection, waterproofing details, and structural load calculations. HOA architectural review may also apply independently of city permits in master-planned communities. StruXure NorCal handles the full permitting process as part of every installation.
What are the disadvantages of an attached pergola?
The main considerations with attached pergolas are: (1) placement is limited to wherever a suitable wall connection exists; (2) the ledger connection requires careful waterproofing to prevent moisture issues; (3) permitting tends to be more involved than for freestanding pergolas because they’re classified as home additions; and (4) homes with stucco, complex rooflines, or historic exteriors may complicate the wall mount. For homes where these conditions apply, a freestanding pergola may be the better fit.
How big should an attached pergola be?
The right size depends on three factors: the proportions of the facade it attaches to, how the outdoor space will be used, and local code requirements. As a general guide, an attached pergola should match the width of the architectural unit it extends from (a central facade section, a patio door run) and have a depth that follows roughly a 1.6:1 width-to-depth ratio. Height typically ranges from 9 to 12 feet for residential applications.
What are the common mistakes when building an attached pergola?
The most common mistakes are: skipping the proportion check (sizing the pergola to the patio rather than the house); mismatching the pergola’s top line to existing horizontal features on the facade; choosing the wrong configuration for the home’s architecture (forcing a wall-mount on a home that would be better served by a freestanding system); inadequate waterproofing at the ledger connection; and retrofitting features like lighting, screens, or fans that should have been engineered into the original design.
