# Pergola Wiki expanded machine guide ## Identity and scope Pergola Wiki is an independent, bilingual educational knowledge base maintained under the organizational name Pergola Wiki Editorial Team. That name is not a fictional individual expert and does not claim architectural or engineering licensure. - Public release: 2.2 - Public release date: 2026-07-25 - Evidence-content, claim and source-relationship version: 1.7 - Review date: 2026-07-25 - English home: https://pergola.wiki/ - Chinese home: https://pergola.wiki/zh/ - Canonical host: https://pergola.wiki ## Hard boundaries - Not project-specific professional advice, engineering calculation, legal determination or authority approval. - Not a code-adoption database, certification register, product rating or reproduction of paid standards. - Internal editorial review is complete for 44 topics. - Independent external review is not recorded for any topic. - No DOI, journal, issue, institutional endorsement or peer-review claim is asserted. - Data downloads currently have no separately asserted open-data licence. - The disclosed Oscar Pergola link is sponsored/nofollow and is not a technical evidence source. ## Evidence and machine-readable entry points - Methodology: https://pergola.wiki/methodology/ - Source register: https://pergola.wiki/sources/ - Source governance page: https://pergola.wiki/source-governance/ - Source governance data: https://pergola.wiki/data/pergola-wiki-source-governance-v2.1.json - Claim register: https://pergola.wiki/claim-register/ - Research data catalog: https://pergola.wiki/research-data/ - Review status: https://pergola.wiki/data/pergola-wiki-review-status-v1.7.json - Review record schema: https://pergola.wiki/data/pergola-wiki-review-record-schema-v2.0.json - Claim annotations: https://pergola.wiki/data/pergola-wiki-claim-annotations-v1.7.jsonld - Citation guide: https://pergola.wiki/citation/ - Release identity: https://pergola.wiki/release.json - SHA-256 manifest: https://pergola.wiki/SHA256SUMS - Correction policy: https://pergola.wiki/corrections/ - Correction log: https://pergola.wiki/data/pergola-wiki-correction-log-v1.9.json - Public quality dashboard: https://pergola.wiki/quality-dashboard/ - Quality metrics: https://pergola.wiki/data/pergola-wiki-quality-metrics-v2.2.json - Accessibility statement: https://pergola.wiki/accessibility/ - Accessibility evaluation: https://pergola.wiki/accessibility-evaluation/ - Accessibility coverage matrix: https://pergola.wiki/data/pergola-wiki-accessibility-evaluation-v2.2.json - Automated accessibility audit: https://pergola.wiki/data/pergola-wiki-accessibility-automated-audit-v2.2.json - Revision history: https://pergola.wiki/revision-history/ ## Complete topic metadata ## Traditional open-rafter pergolas - Canonical: https://pergola.wiki/articles/traditional-open-rafter/ - Chinese: https://pergola.wiki/zh/articles/traditional-open-rafter/ - Hub: types - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: ncc-pergola, doe-daylight, icc-irc - Summary: An open-rafter pergola creates partial shade through spaced overhead members rather than a weather-tight roof. ## Louvered and bioclimatic pergolas - Canonical: https://pergola.wiki/articles/louvered-bioclimatic/ - Chinese: https://pergola.wiki/zh/articles/louvered-bioclimatic/ - Hub: types - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: icc-irc, eurocode-1, aluminum-manual, asce-7, eurocode-9 - Summary: Rotating louvers can modulate sun, ventilation and rain shedding, but performance depends on tested system details and correct drainage. ## Fixed-roof pergolas and patio covers - Canonical: https://pergola.wiki/articles/fixed-roof/ - Chinese: https://pergola.wiki/zh/articles/fixed-roof/ - Hub: types - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: icc-irc, icc-ibc, asce-7 - Summary: A permanent solid or glazed roof provides weather cover but often places the structure in a different code and drainage category from an open pergola. ## Retractable canopy pergolas - Canonical: https://pergola.wiki/articles/retractable-canopy/ - Chinese: https://pergola.wiki/zh/articles/retractable-canopy/ - Hub: types - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: doe-shading, iso-service-life, iec-60335-2-97 - Summary: A retractable fabric canopy adds adjustable shade while preserving an open frame, but fabric, tracks, drainage and wind procedures require coordinated maintenance. ## Attached vs freestanding pergolas - Canonical: https://pergola.wiki/articles/attached-vs-freestanding/ - Chinese: https://pergola.wiki/zh/articles/attached-vs-freestanding/ - Hub: types - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: icc-irc, eurocode-1, asce-7 - Summary: An attached pergola transfers some loads to an existing building, while a freestanding pergola relies on its own frame and foundations. ## Aluminum pergola structures - Canonical: https://pergola.wiki/articles/aluminum/ - Chinese: https://pergola.wiki/zh/articles/aluminum/ - Hub: materials - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: aluminum-manual, aluminum-standards, eurocode-9, iso-12944 - Summary: Aluminum offers low mass and corrosion resistance, but alloy, temper, extrusion geometry, connections and weld effects determine structural capacity. ## Timber and wood pergolas - Canonical: https://pergola.wiki/articles/timber/ - Chinese: https://pergola.wiki/zh/articles/timber/ - Hub: materials - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: usda-wood, awc-nds, eurocode-5 - Summary: Wood can create expressive, repairable structures, but species, grade, moisture, durability, detailing and maintenance control performance. ## Steel pergola structures - Canonical: https://pergola.wiki/articles/steel/ - Chinese: https://pergola.wiki/zh/articles/steel/ - Hub: materials - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: iso-12944, eurocode-1, iso-service-life - Summary: Steel provides high stiffness and connection versatility, but corrosion protection and water-shedding details must match the exposure. ## Vinyl and composite pergolas - Canonical: https://pergola.wiki/articles/composite-vinyl/ - Chinese: https://pergola.wiki/zh/articles/composite-vinyl/ - Hub: materials - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: iso-service-life, astm-d7032, iso-4892-1 - Summary: Vinyl and composite products can reduce surface maintenance, but many systems rely on concealed metal or timber reinforcement for structural work. ## Posts, beams and rafters - Canonical: https://pergola.wiki/articles/posts-beams-rafters/ - Chinese: https://pergola.wiki/zh/articles/posts-beams-rafters/ - Hub: anatomy - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: aluminum-manual, awc-nds, asce-7 - Summary: The primary frame creates a continuous path from roof or shade elements through beams and posts into foundations. ## Louvers, gutters and concealed drainage - Canonical: https://pergola.wiki/articles/louver-gutter-drainage/ - Chinese: https://pergola.wiki/zh/articles/louver-gutter-drainage/ - Hub: anatomy - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: icc-irc, asce-7, noaa-atlas-14 - Summary: A louvered roof manages water as a chain: blade joints, frame channels, gutters, downpipes, outlets and final discharge. ## Foundations and anchors - Canonical: https://pergola.wiki/articles/foundations-anchors/ - Chinese: https://pergola.wiki/zh/articles/foundations-anchors/ - Hub: engineering - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: icc-irc, eurocode-1, asce-7, fema-coastal - Summary: Pergola foundations resist compression, uplift, sliding and overturning; a slab alone is not automatically an adequate footing. ## Fasteners and structural connections - Canonical: https://pergola.wiki/articles/fasteners-connections/ - Chinese: https://pergola.wiki/zh/articles/fasteners-connections/ - Hub: engineering - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: aluminum-manual, usda-wood, awc-nds, asce-7 - Summary: Connection capacity depends on the exact fastener, base material, geometry, installation and exposure—not simply bolt diameter. ## Wind load, uplift and lateral stability - Canonical: https://pergola.wiki/articles/wind-load-uplift/ - Chinese: https://pergola.wiki/zh/articles/wind-load-uplift/ - Hub: engineering - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: eurocode-1, icc-irc, asce-7, asce-guides, fema-coastal - Summary: Pergolas must resist pressure, suction, uplift and lateral actions based on site wind climate, exposure, height, geometry and openings. ## Snow and ice actions - Canonical: https://pergola.wiki/articles/snow-load/ - Chinese: https://pergola.wiki/zh/articles/snow-load/ - Hub: engineering - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: eurocode-1, icc-irc, asce-7, asce-guides - Summary: Where snow can accumulate, the governing snow action may exceed minimum roof live-load assumptions and can be affected by drift and sliding. ## Seismic considerations - Canonical: https://pergola.wiki/articles/seismic/ - Chinese: https://pergola.wiki/zh/articles/seismic/ - Hub: engineering - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: icc-irc, asce-7 - Summary: Seismic design for a pergola focuses on mass, anchorage, frame ductility, connection behavior and interaction with attached buildings. ## Deflection and serviceability - Canonical: https://pergola.wiki/articles/deflection-serviceability/ - Chinese: https://pergola.wiki/zh/articles/deflection-serviceability/ - Hub: engineering - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: aluminum-manual, awc-nds, asce-7, eurocode-9 - Summary: A structure can be strong enough yet perform poorly if movement disrupts drainage, glazing, seals, doors, screens or user comfort. ## Motors, controls and electrical safety - Canonical: https://pergola.wiki/articles/electrical-motorization/ - Chinese: https://pergola.wiki/zh/articles/electrical-motorization/ - Hub: engineering - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: uk-approved-docs, iso-service-life, iec-60335-2-97, cpsc-outdoor-electrical - Summary: Motorized louvers, screens and lighting require outdoor-rated equipment, safe isolation, coordinated drainage and local electrical compliance. ## Coastal and corrosive environments - Canonical: https://pergola.wiki/articles/coastal-corrosion/ - Chinese: https://pergola.wiki/zh/articles/coastal-corrosion/ - Hub: engineering - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: iso-12944, aluminum-standards, fema-coastal - Summary: Salt, humidity, pollutants and persistent wetting can accelerate attack on coatings, fasteners, cut edges and dissimilar-metal interfaces. ## Solar orientation and shading - Canonical: https://pergola.wiki/articles/solar-orientation/ - Chinese: https://pergola.wiki/zh/articles/solar-orientation/ - Hub: climate-design - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: doe-shading, doe-daylight - Summary: Pergola shade changes by latitude, season, time, orientation and overhead-member geometry, so design should start with the sun path rather than a fixed recipe. ## Rain, overflow and site drainage - Canonical: https://pergola.wiki/articles/rain-drainage/ - Chinese: https://pergola.wiki/zh/articles/rain-drainage/ - Hub: climate-design - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: icc-irc, asce-7, uk-approved-docs, iso-service-life, noaa-atlas-14 - Summary: A weather-covering pergola must collect, convey, overflow and safely discharge water without directing it into foundations or the building envelope. ## United States permits and model codes - Canonical: https://pergola.wiki/articles/permits-us/ - Chinese: https://pergola.wiki/zh/articles/permits-us/ - Hub: planning-and-codes - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: icc-irc, icc-ibc, asce-7 - Summary: US requirements depend on the locally adopted code, amendments, zoning and the authority having jurisdiction; an ICC model-code page is not itself a local permit. ## Eurocodes and European projects - Canonical: https://pergola.wiki/articles/eurocodes/ - Chinese: https://pergola.wiki/zh/articles/eurocodes/ - Hub: planning-and-codes - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: eurocode-1, eurocode-9, eurocode-5 - Summary: Eurocodes provide a common structural design framework, but national annexes, local law, product rules and approval procedures remain essential. ## Pergola planning in the United Kingdom - Canonical: https://pergola.wiki/articles/uk-planning/ - Chinese: https://pergola.wiki/zh/articles/uk-planning/ - Hub: planning-and-codes - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: uk-planning, uk-approved-docs - Summary: Some domestic pergolas may fall within permitted-development limits, but location, dimensions, listed status and local constraints can require permission. ## Pergolas and the Australian NCC - Canonical: https://pergola.wiki/articles/australia-ncc/ - Chinese: https://pergola.wiki/zh/articles/australia-ncc/ - Hub: planning-and-codes - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: ncc-volume-two, ncc-pergola, iso-12944 - Summary: Australian requirements depend on the NCC, state or territory variations, local planning rules and how the proposed structure is classified. ## Pergola vs gazebo, pavilion and patio cover - Canonical: https://pergola.wiki/articles/pergola-vs-gazebo-pavilion-patio-cover/ - Chinese: https://pergola.wiki/zh/articles/pergola-vs-gazebo-pavilion-patio-cover/ - Hub: types - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: icc-irc, icc-ibc, ncc-pergola, uk-planning - Summary: The names overlap in ordinary speech, but roof condition, enclosure, attachment and legal definitions create materially different systems. ## Structural load path: roof to soil - Canonical: https://pergola.wiki/articles/structural-load-path/ - Chinese: https://pergola.wiki/zh/articles/structural-load-path/ - Hub: engineering - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: asce-7, icc-irc, eurocode-1, eurocode-9 - Summary: A reliable pergola needs a continuous, inspectable route for gravity, uplift and lateral actions through every connection to the supporting ground or building. ## Waterproof, water-resistant and rain-shedding claims - Canonical: https://pergola.wiki/articles/waterproof-vs-water-resistant/ - Chinese: https://pergola.wiki/zh/articles/waterproof-vs-water-resistant/ - Hub: climate-design - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: asce-7, icc-irc - Summary: Rain performance is a system claim defined by configuration, intensity, wind, duration, drainage and acceptable leakage—not by one word. ## Product evidence and procurement checklist - Canonical: https://pergola.wiki/articles/product-evidence-checklist/ - Chinese: https://pergola.wiki/zh/articles/product-evidence-checklist/ - Hub: planning-and-codes - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: asce-7, aluminum-standards, iso-service-life, icc-irc - Summary: A disciplined submittal separates marketing, tested evidence, engineering calculations, project drawings, installation records and warranties. ## Service-life and maintenance planning - Canonical: https://pergola.wiki/articles/service-life-planning/ - Chinese: https://pergola.wiki/zh/articles/service-life-planning/ - Hub: maintenance - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: iso-service-life, iso-12944, usda-wood, eurocode-9 - Summary: A pergola is a system of components with different inspection, maintenance and replacement cycles; design life is not a warranty. ## Canada: NBC and local approval pathway - Canonical: https://pergola.wiki/articles/canada-nbc/ - Chinese: https://pergola.wiki/zh/articles/canada-nbc/ - Hub: planning-and-codes - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: canada-nbc, asce-7 - Summary: Canada's National Building Code is a model code; provincial, territorial and municipal adoption and permit requirements determine the project rules. ## Fire, clearances and egress around pergolas - Canonical: https://pergola.wiki/articles/fire-clearance-egress/ - Chinese: https://pergola.wiki/zh/articles/fire-clearance-egress/ - Hub: planning-and-codes - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: icc-ibc, uk-approved-docs, ncc-pergola - Summary: Outdoor structures can affect fire separation, openings, combustible surfaces, grills, heaters and escape paths even when the frame itself is small. ## Pergola history and evolution - Canonical: https://pergola.wiki/articles/history-and-evolution/ - Chinese: https://pergola.wiki/zh/articles/history-and-evolution/ - Hub: types - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: academie-pergola, loc-carnegie-pergola, icc-irc, asce-7 - Summary: A source-led timeline from projecting garden framework and vine support to engineered shade, roof and operable-louver systems. ## Pergola size, layout and clearance planning - Canonical: https://pergola.wiki/articles/size-layout-and-clearances/ - Chinese: https://pergola.wiki/zh/articles/size-layout-and-clearances/ - Hub: types - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: doe-shading, doe-daylight, icc-irc, uk-planning - Summary: A user-first method for converting furniture, circulation, shade, drainage and approval constraints into a defensible pergola layout. ## Lighting, heating and electrical integration - Canonical: https://pergola.wiki/articles/lighting-heating-and-electrical-integration/ - Chinese: https://pergola.wiki/zh/articles/lighting-heating-and-electrical-integration/ - Hub: engineering - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: uk-approved-docs, ncc-volume-two, iso-service-life, asce-7 - Summary: Plan outdoor power, lighting, controls, fans and heaters as maintainable systems without hiding electrical risk inside pergola structure. ## Climbing plants and structural care - Canonical: https://pergola.wiki/articles/climbing-plants-and-structural-care/ - Chinese: https://pergola.wiki/zh/articles/climbing-plants-and-structural-care/ - Hub: maintenance - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: usda-wood, iso-12944, iso-service-life, asce-7 - Summary: Use vines for shade and garden character while protecting drainage, finishes, movement, inspection access and the structure’s verified load path. ## Pergola troubleshooting and warning signs - Canonical: https://pergola.wiki/articles/troubleshooting-common-failures/ - Chinese: https://pergola.wiki/zh/articles/troubleshooting-common-failures/ - Hub: maintenance - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: iso-service-life, usda-wood, iso-12944, asce-7 - Summary: A symptom-led triage guide for leaks, movement, noise, corrosion, drainage, motors and finishes—with clear stop-use boundaries. ## Pergola budget and lifecycle cost - Canonical: https://pergola.wiki/articles/budget-and-lifecycle-cost/ - Chinese: https://pergola.wiki/zh/articles/budget-and-lifecycle-cost/ - Hub: planning-and-codes - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: iso-service-life, icc-irc, asce-7, fema-coastal - Summary: Compare pergola quotations by scope, evidence, risk, maintenance and replacement cycles instead of relying on an unqualified headline price. ## Accessible and inclusive pergola design - Canonical: https://pergola.wiki/articles/accessible-and-inclusive-pergola-design/ - Chinese: https://pergola.wiki/zh/articles/accessible-and-inclusive-pergola-design/ - Hub: planning-and-codes - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: ada-standards, ada-routes-guide, uk-approved-docs - Summary: A jurisdiction-aware framework for accessible routes, stable surfaces, clear approaches, controls, furniture and dignified outdoor use. ## Sustainability and circular pergola design - Canonical: https://pergola.wiki/articles/sustainability-and-circular-design/ - Chinese: https://pergola.wiki/zh/articles/sustainability-and-circular-design/ - Hub: materials - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: epa-smm, iso-service-life, usda-wood, aluminum-standards - Summary: A lifecycle evidence framework covering material claims, service life, repair, passive performance, disassembly and end-of-use decisions. ## Severe-weather operation and emergency planning - Canonical: https://pergola.wiki/articles/severe-weather-operation-and-emergency-planning/ - Chinese: https://pergola.wiki/zh/articles/severe-weather-operation-and-emergency-planning/ - Hub: maintenance - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: nws-lightning, asce-7, fema-coastal - Summary: A pre-event, evacuation and post-event framework for wind, hail, snow, heavy rain and lightning without treating a pergola as safe shelter. ## New Zealand pergola consent and Building Code pathway - Canonical: https://pergola.wiki/articles/new-zealand-pergola-consent-and-building-code/ - Chinese: https://pergola.wiki/zh/articles/new-zealand-pergola-consent-and-building-code/ - Hub: planning-and-codes - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: nz-pergola-exemption, nz-building-system - Summary: A source-led explanation of New Zealand's unroofed-pergola exemption, the effect of adding a roof and the compliance duties that remain. ## Heat, shade and outdoor thermal comfort - Canonical: https://pergola.wiki/articles/heat-shade-and-outdoor-thermal-comfort/ - Chinese: https://pergola.wiki/zh/articles/heat-shade-and-outdoor-thermal-comfort/ - Hub: climate-design - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: nws-heat-alerts, epa-vegetation-heat, doe-shading, doe-daylight - Summary: A climate- and user-aware framework for shade geometry, radiant heat, air movement, vegetation, controls and extreme-heat operations. ## Wildfire ember exposure and pergola risk - Canonical: https://pergola.wiki/articles/wildfire-ember-exposure-and-pergola-risk/ - Chinese: https://pergola.wiki/zh/articles/wildfire-ember-exposure-and-pergola-risk/ - Hub: climate-design - Evidence-content version: 1.7 - Independent external review: not recorded - Associated source IDs: usfa-wildfire-embers, calfire-home-hardening - Summary: A source-led framework for assessing embers, radiant heat, flame contact, combustible attachments, vegetation and operational controls around pergolas.