How to Build a Pergola on a Deck

Ready to add some backyard shade? We’ll show you how to build a pergola on a deck. This simple DIY deck pergola adds shade and style to your outdoor living space.

You can also add a firepit and swings to your pergola, or build a family set of Adirondack chairs and an outdoor dining table with built-in drink coolers.

Build a DIY deck pergola to make your backyard perfect for relaxing and entertaining! Full tutorial from The Heathered Nest on

Adding a Backyard Shade Pergola to Our Deck

We enjoy our deck. It gets a wonderful breeze most of the summer that keeps the bugs down and helps us stay cool.

At some point we decided we wanted to add a little bit of shade to our deck. An actual screen room was a little too ambitious (and costly), so we decided on a DIY pergola.

A deck pergola offers a little bit of shade, but keeps that open feeling of being outside.

Now as you might know from previous musings on our blog, The Heathered Nest, we have a pretty large deck that we inherited when we bought this house. We spent a fair amount of time giving it a makeover this past summer. 

Just to give you an idea of how much time, here’s a picture of how the deck looked before this project:

the patio BEFORE the amazing DIY deck pergola

We removed the railing from the raised deck, cleaned it up, and added a solid deck stain (that looks like paint but should hold up so much better!).

Then we added a pergola to the existing deck to add shade.

Can you put a pergola on a raised deck?

Yes! We are living proof that you can put a pergola on an existing raised deck or floating deck.

Depending on the height of your deck, you might want to add a railing to the DIY deck pergola (or the deck itself), and you’ll want to make sure the deck pergola is reinforced with heavy duty hardware and connections since the additional height may catch more wind resistance.

DIY Deck Pergola Tutorial

The simple DIY deck pergola has been one of our favorite features, so today, we’d like to talk about how we DIY’d ours, and hopefully inspire some of you to give a project like this a try at home, too!

Video: How to Build a DIY Deck Pergola

The tutorial and video below show how to build a pergola on a deck. Watch it here on our YouTube channel and be sure to subscribe for more videos!

Planning a DIY Pergola on an Existing Deck

Planning out the pergola on the deck | DIY pergola tutorial for

***WARNING!! This is a construction project which requires use of power tools, heavy construction materials, and a working knowledge of safe DIY practices. If you are not comfortable with any of these required skills, please save yourself injury, trips to the ER,  death, dismemberment, physical trauma, or emotional trauma caused by a nagging husband or wife asking you why you cannot seem to complete this project. This is not a project for beginners. By utilizing this tutorial, you agree utilize information contained herein at your own risk. Neither nor will assume liability for any injuries, etc, incurred as a result of following the tutorial information written in this post. You must also ensure you have checked and are in compliance with any local building codes pertinent to this project. Installation requirements will vary based upon factors such as the surface on which the pergola will stand, be it ground, a deck or patio, etc. ***

Before you start hoisting beams in the air and getting that saw buzzing, make sure you’ve got a good DIY deck pergola plan worked out.

Decide exactly where you’re building your pergola — ours was on top of our existing deck which is raised a bit above the yard level.

Then, you need to determine the size of the pergola you’d like to build. Ours is about 14’x14’ (this is the distance between the 6×6 posts).

The strength and structural integrity of your pergola will depend greatly upon the size of the structure you are planning to build. Choose your lumber sizes for the needed strength over the span of the project.

Again, be sure to check local building codes for compliance before beginning the project.

For our 14-foot square DIY deck pergola, we used 12′ 6×6 posts, 22′ 2×2 beams, and 16′ 2×10 joists — all pressure treated wood.

If the planning feels overwhelming, you can order a DIY pergola kit, shipped to your door instead.

Why are the beams and joists so much longer than the pergola size? We chose a simple pergola design, and wanted a wide overhang with curved beam and joist ends to dress up the basic square pergola. Our pattern was about 2′ long on the boards. If you choose square ends for your beams and joists, or a simpler shorter decorative curved end, you may not need as much overhang.

Framing: Parts of a Pergola

We’ll be using certain terms throughout the post for parts of the pergola. (See image below.)

  • Post: the vertical portion of the pergola, which is attached to the deck using a bracket or, for a freestanding pergola, anchored in a concrete footing.
  • Beam: the main support-bearing horizontal portion of the pergola, which is attached to the post using bolts.
  • Joist: additional horizontal portion of the pergola that adds shade and gives it the pergola style (unless you’re building an open modern DIY deck pergola like this) as well as adding support to the structure.
Awesome DIY deck pergola tutorial! Our backyard needs some shade and this is perfect. Can go on an existing deck or a patio or over the grass. Tutorial from The Heathered Nest on

For our 14′ x 14′ large DIY deck pergola, we used 6×6 posts, 2×12 beams, and 2×10 joists.

This post contains affiliate links. Learn more and read our full disclosure policy here.

DIY Deck Pergola Materials & Hardware (14×14 pergola)

Depending on the size of your pergola and the available materials, your shopping list will vary. We used:

Try a DIY shortcut: order a pre-made wood pergola kit shipped right to your door instead. (Pergola kits also come in metal/steel/aluminum and vinyl if you prefer.)

What type of wood should I build a pergola from?

Pergolas (and other outdoor structures like arbors and gazebos) should be built from a weather-resistant wood such as cedar or redwood, or pressure-treated timbers available at the lumber yard.

Be sure to also get corrosion resistant bolts and screws rated for outdoor weather *and* for exposure to pressure treated lumber.

Tools to Build a DIY Pergola

Step by Step DIY Deck Pergola Tutorial

 Step 1. Set the post anchors on the deck

How to build a pergola on a wood deck | DIY pergola tutorial

With the location and size determined, we can get started on the pergola construction.

How to Anchor a Pergola to a Wood Deck

If, like ours, your pergola will be sitting on top of an existing deck, the 6×6 pergola posts must be located over top of the existing support structure. This means locating the existing deck joists.

Once the location of the 6×6’s posts has been determined, the 6×6 metal post anchors can be installed. The post anchors have a hole in the middle so that you can attach it to the deck joist.

I drilled a pilot hole using a 1/8” bit. Then the anchor is secured to the existing joist with a 1/4” lag bolt. I used an impact drill for this, but you could also use an old fashioned socket set.

Justin used similar post bases to add an arched arbor to their wood deck here.

How to Anchor a Pergola to a Concrete Patio or In-Ground Footing

If you want to build your pergola on an existing concrete slab or directly on the ground, you will need to install your 6×6 posts differently.

For an existing concrete slab, you can use the same post anchors, but you will need to use a hammer drill and special concrete anchors to attach the post anchor to the slab.

If you are going to build your pergola directly on the ground, you will need to dig holes for each of the posts, add some gravel, fill the hole with concrete, and set the post.  The hole depth will depend on local building codes, but is normally between 24″ and 36″ deep, and 24″ in diameter.

Step 2. Raise the 6×6 posts and add temporary bracing

Installing 6x6 posts, using 2x4's for temporary bracing | DIY deck pergola tutorial
Installing 6×6 posts, using 2×4’s for temporary bracing.

With the anchors now installed, its almost time to lift the 6×6 posts into place. This job will take at least two people. Hopefully, you have a buddy that owes you. Be very careful, because these things are heavy!

But before you actually lift up the posts, we need to prep them a bit.

We figured this little tip out the hard way…shave off about 1/8” to ¼” off of one side of the 6×6 post, just at the very bottom. This will allow the post to slide into the post base anchor bracket much easier.

Also, pre-drill a hole in the bottom of the 6×6 post, right in the middle. Drill a 1” hole about 2” deep. This will allow the 6×6 post to sit flush with the ground and not be held up by that lag bolt we just installed.

Post installed into an anchor on the deck, DIY pergola tutorial
6×6 post installed into anchor. Notice how we shaved a touch off the side of the post to allow it to fit more easily into the anchor.

After you’ve prepped the 6×6 pergola post for the anchor bracket, install it (with a buddy or two):

  1. Lift the first 6×6 post into place in the post base.
  2. Once the post is vertical, square it up using your level.
  3. Brace the post with 2×4’s as beam support.

Bracing posts

I simply screwed the 2×4’s directly into the 6×6 post and into my existing deck. Check out the pics to see exactly how this should look.

Think about where you put the bracing because this will be up for the duration of the project. Be sure not only that your bracing is securing the beams, but also that it will not get in your way as you continue constructing.

Continue this same procedure with the remaining 3 posts.

install pergola posts for a DIY deck pergola on a raised existing deck, tutorial and video


Step 3. Cut the decorative ends of beams

Cut decorative ends on beams for a stylish update, simple DIY deck pergola tutorial

Before installing the four 2×12 beams to the front and back of the structure, you can use a jigsaw to make the ends look a bit more decorative. Pinterest is a great source for design inspiration like this.

See some simple beam end examples (and templates) on this simple wood wedding arch arbor plan or this gothic arch arbor plan.

Once you find a design aesthetic/look you like, using a pencil, simply sketch the shape freehand onto the end of one of your 2x12s.

Once you’ve sketched a look you’re happy with, use the jig saw to cut along your sketched line.

The scrap piece that has been removed from your beam now becomes a template used to cut the edges of the remaining beams. This ensures they will all be identical.

After it was cut, we used a palm sander to smooth out the edges of the jigsawed pattern on the beam. Our pattern took up about 2’ of space.

You need to apply this pattern to both ends of the beam, not just one. How large or small, or the shape of this pattern in general are all personal preferences.

How to cut decorative ends on pergola beams | DIY deck pergola tutorial
Using jigsaw to cut decorative ends of pergola beams.


Step 4. Install beams to front and back of structure.

Installing posts and beams, DIY pergola tutorial for

It’s almost time to “sandwich” the front and back posts with two sets of 2×12 beams.

But before we hoist these big pieces of wood up, we are going to prepare some bracing that will help hold the beam in place while we get it bolted. We’ll do that with some 2×4 scraps.

Cut a few 2×4’s approximately 2′ in length, and screw them into the 6×6 posts at the height that you want your 2×12 beams to sit.

Once you’ve secured your 2×4 bracing pieces, then lift the first 2×12, and rest it on the 2×4 bracing. Check for level. Then lift the second 2×12 beam into place on the opposite side of the post.

Add bracing to set beams, How to build a DIY deck pergola, tutorial for

I also clamped the beams to the post to help temporarily secure them until I could bolt the beams to the posts.

The beams are secured to the 6×6 posts with two carriage bolts. To install a carriage bolt, first drill a pilot holes through each beam and post attachment point, then install and tighten the carriage bolt, washers, and nut.

Once you have the carriage bolts installed and tightened into the posts, the 2×4 braces can be removed.

IMPORTANT NOTE: We later trimmed our pergola posts to height to match the beams/joist heights. It is safest, and a better procedure, however, not to erect your posts until they are sized correctly — so we’d recommend trimming the posts before installing.

Beautiful simple DIY deck pergola on an existing deck, full how-to and tutorial from The Heathered Nest on
Appearance of the beams “sandwiching” the 6×6 posts from below the structure.

Step 5. Cut the decorative ends on the joists

Curved decorative ends on pergola beams and joists, simple DIY deck pergola tutorial

2×10’s are the material used for the joists. While not required, it adds some decorative “flair” to cut the same pattern into the ends of your joists that you cut on your 2×12 beams with the jigsaw.

Be sure to keep this extra decorative end length in mind when you are determining board lengths for your joists!

Since the dimension of the joists are smaller than the beams, the scale of the pattern will be slightly different.

So again, sketch your pattern with a pencil onto one of your joists. Once comfortable with the design, cut it out with your jigsaw. The discarded piece of wood will be used as a template for cutting the pattern into the remaining 2×10 joists. 

Since our pergola butted up against our house on one side, we only needed to cut this pattern on one end of our joists. But this may not be the case for your particular project.

DIY deck pergola against the house, with string lights on a deck, The Heathered Nest for
Rear of our pergola abuts house, so no decorative ends were cut on this side.

Step 6. Install joists around the pergola beams

how to build a pergola on a deck, simple DIY deck pergola tutorial

In our case, before we moved onto the joist installation, we had to trim excess length from the top our 6×6 posts. It is safest, and a better procedure, however, not to erect your posts until they are sized correctly.

Our joists are 9″, so we want the top of the 6×6 post to rise only about 8″ above the 2×12 beams so that they are just shy of the height of our joists.  This will allow us to bolt the joists into the 6×6 post, but not have the 6×6 post sticking up above the joists.

The first four joists that you will install are those on either end of the pergola that will sandwich the 6×6 posts above the 2×12 beams.

Use two carriage bolts to secure the joists around the 6×6 post in all four corners of your pergola.

How to build a DIY pergola, tutorial for

Step 7. Install joists across the top of the pergola structure

The remaining joists are spaced equally between the posts. They ended up about 2’ apart.

To secure these joists to the beams, I used 2.5” screws and screwed them at an angle into the beams.

If you live in a high-wind area, you’ll want to consider strengthening the structure with hurricane tie brackets like these as well.

How to secure pergola joists without a bracket only screws | DIY deck pergola tutorial for

Step 8. Brace top of joists with 2×4 rafters

Above the DIY deck pergola joists, and perpendicular to them, we’d recommend installing four (4) rows of 2x4s as rafters.  This will help keep the joists straight and reduce warping.  

Screw in one row each at the front and back, and then the other two rows spaced evenly in between. Lay the 2×4’s flat and secure them to each joist using 4″ screws.

Top view of DIY deck pergola with lattice and screen to add shade, tutorial from The Heathered Nest on

On our pergola, instead of using the 2x4s on top, we did something a little different. We installed lattice and screen material to add extra shade.

That is a separate project, and is not part of this particular post, but you could tackle that additional work if you desired. 

Beautiful DIY pergola! Tutorial on from The Heathered Nest

Step 9. Finish, Brace, and Decorate

Your pergola structure is complete! You can now remove the 2x4s that were bracing the posts.

Now your pergola is free standing, so it will sway just a little bit. Ours did not sway too much, but if it does, you can always add in some bracing at the top corners to help stiffen it up.

Perfect for summer! A DIY pergola on a deck, with a painted rug and curtains. Build it with the tutorial from The Heathered Nest on

All that’s left to do is sit out there and enjoy! I did add some curtains and lighting (plus a ping ping dining table) to make it cozy.

Learn how to make and hang the pergola curtains here and how to make your own rustic chandelier from cans here.

The practically perfect pergola | DIY deck pergola tutorial for

We had a lot of work to get us to the point where we could say we really loved our outdoor space, but this pergola has been a a great addition to our deck. Hope that it may be to yours as well.

Build a DIY pergola to make your backyard perfect for relaxing and entertaining! Full tutorial from The Heathered Nest on


More amazing backyard ideas:

Build a DIY pergola to make your backyard perfect for relaxing and entertaining! Full tutorial from The Heathered Nest on
Make your backyard deck even more amazing this summer with this custom DIY pergola. Tutorial from The Heathered Nest on @Remodelaholic

First Published 09 April 2016. Last Updated 07 June 2022.

Website | + posts

Former doctor of physical therapy, Heather, and her engineer hubby, Dave, blog at the colorful, slightly off-kilter DIY and home decor blog, The Heathered Nest. Definitely a contrast to the mostly neutral world of home decor that currently abounds, Heather and Dave's home is full of pattern, punchy colors, and tons of DIY, all done on the cheap, though it may not appear it. Their work has been featured in magazines to include This Old House, USA Today Home Magazine, Reloved, GreenCraft and Cottages & Bungalows. They've made appearances on several DIY network TV shows, including "I Hate my Bath" and "I Want That". And their work has been featured all over the www in spots such as Better Homes & Gardens, House Beautiful, Country Living, Good Housekeeping, The Today Show, Washington Post, Huffington Post, USA Today, Apartment Therapy and more.

We love hearing from fellow Remodelaholics, so let us know what you like about this and leave any questions below in the comments. If you've followed a tutorial or been inspired by something you've seen here, we'd love to see pictures! Submit pictures here or by messaging us over on Facebook.

Similar Posts

Leave a Reply

Your email address will not be published. Required fields are marked *


  1. I have been doing research on building a pergola recently. While this one looks great, I would be very concerned about not having it anchored in the ground, or to the structure of the house (from pictures it doesn’t look like it is, so please correct me if I missed something). The top of a pergola can act like a giant sail, and with this design, it seems like you have a significant risk of the whole pergola ripping off in the wind (and maybe taking deck boards with it). Have you considered this?

    1. Mike,
      Thanks for your comments. Yes, we definitely considered how to secure the pergola to ensure it would not blow away. The main posts of the pergola are not secured to the deck boards, they are actually anchored into the deck structure, which is cemented into the ground. It’s sturdy. Has already withstood a blizzard (literally) and a recent windstorm with sustained winds over 40 mph. In your research you have probably noticed that most pergolas are free standing, and not attached to a house, or adjacent structure, which goes for ours also. The way ours was built did not require us to have any additional structure to keep it from swaying, but some pergolas might, so keep that in mind.
      By all means, follow local codes, and if you are concerned about the safety of your proposed plan, then definitely get a pro to look it over before you proceed. Safety first!
      Best of luck with your project!!
      Thanks, Dave (The Heathered Nest)

  2. can you elaborate on the roofing material with the lattice (or is there another post).

    My 2 question are 1. how well has it held up (does it look dirty over time). and 2. did you pitch your roof so that it would run off or is it completely flat?

  3. Great how to for a solid looking pergola. Also, great tip on shaving off the bottom of the posts to fit the brackets, I was just planning to bend them to fit.

  4. Thank you so much for this! I followed your DIY instructions and my pergola turned out beautiful! It’s mounted on my deck as you did yours. It is extremely sturdy (already put to the test by a few nasty thunderstorms) and just looks awesome! Every time my wife walks out onto the deck she’s still says “I can’t believe you built this!” Thanks again! You rock!

  5. What was your estimated cost for materials? I’m debating on buying a kit or building from scratch to my own specifications.

  6. The pergola looks perfect in your deck! I think it’s quite essential to have some sort of shade in backyards or any space that a family would be planning to stay/sit down to. I don’t know about anybody else, but I don’t want to be in direct sunlight for such a long time.

  7. Thank you for taking the time to share. The carriage bolts specified are 10″ long but going thru a 6×6 and 2 2×6 doesn’t seem the bolts are long enough. Were they 12″ long?

    1. Great question, Randy. Since the nominal sizes of the boards aren’t their actual sizes (when using milled lumber instead of rough), a 10″ bolt can hold a 6×6 (5 1/2″) and 2 2×6 (1 1/2″ each) since those will only be about 8 1/2″ total width.