Tutorial

Understanding the Bootstrap 3 Grid System

Draft updated on Invalid Date
    author

    Chris on Code

    Understanding the Bootstrap 3 Grid System

    This tutorial is out of date and no longer maintained.

    Introduction

    With the 3rd version of the great Bootstrap out for about 4 and a half months now, people have had their time to play around with it, learn the changes, find new features, and build amazing things.

    The Difference

    The most interesting change for me was the difference in the grid system. Bootstrap 2 catered to two different browser sizes (desktop and then mobile). With Bootstrap 3, you now build with mobile in mind first, and the grid system lets you create different grid systems based on browser size.

    Bootstrap 2

    The grid you create works on desktops and then stacks on top of each other when the browser size is below 767px. This is limited since you can only define 1 grid on desktop-sized browsers. You are left with a stacked grid on mobile devices.

    Bootstrap 3

    The new Bootstrap grid system applies to mobile-first. When you declare a specific grid size, that is the grid for that size and above. This can be a little hard to grasp at first so here’s an example.

    For example, let’s say you want a site that has:

    • 1 column on extra small devices
    • 2 columns on small AND medium devices
    • 4 columns on large devices

    Since the grid system now cascades up from mobile devices, this is how this code will look.

        <div class="row">
            <div class="col-sm-6 col-lg-3">
                This is part of our grid.
            </div>
            <div class="col-sm-6 col-lg-3">
                This is part of our grid.
            </div>
            <div class="col-sm-6 col-lg-3">
                This is part of our grid.
            </div>
            <div class="col-sm-6 col-lg-3">
                This is part of our grid.
            </div>
        </div>
    

    We don’t have to define anything for extra small devices since the default is one column. We have to define a grid size for small devices, but not for medium devices. This is because the grid cascades up. So if you define a size at sm, then it will be that grid size for sm, md, and lg.

    We’ll explain the different grid sizes and how you create them and then show examples.

    The Grid Sizes

    This is the best part about the new grid system. You could realistically have your site show a different grid on 4 different browser sizes. Below is the breakdown of the different sizes.

    Name Target Widths Code
    Extra Small Phones Less than 768px .col-xs-$
    Small Devices Tablets 768px and Up .col-sm-$
    Medium Devices Desktops 992px and Up .col-md-$
    Large Devices Large Desktops 1200px and Up .col-lg-$

    The official Bootstrap docs offer a much more comprehensive understanding of how the grid works. Take a look at those to get a more solid overview of column sizes, gutter sizes, maximum column sizes, and the max-width of your overall site based on the browser size.

    Default Sizes for the Bootstrap Grid

    Sometimes you will need to use media queries to get your site to act the way you’d like it to. Knowing the default grid sizes is essential to extending the Bootstrap grid. We’ve written up a quick tip to show you the default sizes so take a look if you need the Bootstrap media queries and breakpoints.

    Bootstrap Media Queries and Breakpoints

    Responsive Utilities

    Just like Bootstrap 2, Bootstrap 3 provides responsive utilities for hiding and showing elements based on the browser size. This will also help us in defining our grid system.

    • .visible-xs
    • .visible-sm
    • .visible-md
    • .visible-lg
    • .hidden-xs
    • .hidden-sm
    • .hidden-md
    • .hidden-lg

    This helps because we are able to show certain elements based on size. In our examples today, we’ll be showing an extra sidebar on large desktops.

    Examples

    Here are a few examples of grids that you can create. We’ll go through some basic sites that some people might want and show how easy it is to build that site with the Bootstrap 3 grid.

    Resize your browser’s width to see the different grids in action.

    Simple: Large Desktop vs Mobile

    Let’s say you wanted a site to have 1 column on extra small (phone) and small (tablet) devices, 2 columns on medium (medium desktop) devices, and 4 columns on large (desktop) devices.

    Here is the code for that example:

        <div class="row">
            <div class="col-md-6 col-lg-3">
                <div class="visible-lg text-success">Large Devices!</div>
                <div class="visible-md text-warning">Medium Devices!</div>
                <div class="visible-xs visible-sm text-danger">Extra Small and Small Devices</div>
            </div>
            <div class="col-md-6 col-lg-3">
                <div class="visible-lg text-success">Large Devices!</div>
                <div class="visible-md text-warning">Medium Devices!</div>
                <div class="visible-xs visible-sm text-danger">Extra Small and Small Devices</div>
            </div>
            <div class="col-md-6 col-lg-3">
                <div class="visible-lg text-success">Large Devices!</div>
                <div class="visible-md text-warning">Medium Devices!</div>
                <div class="visible-xs visible-sm text-danger">Extra Small and Small Devices</div>
            </div>
            <div class="col-md-6 col-lg-3">
                <div class="visible-lg text-success">Large Devices!</div>
                <div class="visible-md text-warning">Medium Devices!</div>
                <div class="visible-xs visible-sm text-danger">Extra Small and Small Devices</div>
            </div>
        </div>
    

    Intermediate: Show Extra Column on Large Desktops

    This is an interesting example and one that the new grid excels at. Let’s say you have a site that has a sidebar and a main content section. For extra small devices, you want one column, main content with the sidebar stacked below it. For small and medium devices, we want the sidebar and main content to sit side by side. Now for large devices, we want to utilize the space on larger devices. We want to add an extra sidebar to show more content.

    We change the size of the main content to span 6 columns on large devices to make room for our second sidebar. This is a great way to utilize the space on larger desktops. And here is the code for that example.

        <div class="row">
            <div class="col-sm-9 col-lg-6 text-danger">
                I am the main content.
            </div>
            <div class="col-sm-3 text-warning">
                I am the main sidebar.
            </div>
            <div class="col-lg-3 visible-lg text-success">
                I am the secondary sidebar that only shows up on LARGE devices.
            </div>
        </div>
    

    Advanced: Different Grid For Every Size

    This will be a more complex example. Let’s say that at no point in our grid system do we want all of our columns to stack. For extra small devices, we want 2 columns. For small devices, we want 3 columns. For medium devices, we want 4 columns. For large devices, we want 6 columns (one that only shows on large devices).

    You get the drill now. Let’s just straight into the example and code.

        <div class="row">
            <div class="col-xs-6 col-sm-4 col-md-3 col-lg-2">
                I'm content!
            </div>
            <div class="col-xs-6 col-sm-4 col-md-3 col-lg-2">
                I'm content!
            </div>
            <div class="col-xs-6 col-sm-4 col-md-3 col-lg-2">
                I'm content!
            </div>
            <div class="col-xs-6 col-sm-4 col-md-3 col-lg-2">
                I'm content!
            </div>
            <div class="col-xs-6 col-sm-4 col-md-3 col-lg-2">
                I'm content!
            </div>
            <div class="col-xs-6 col-sm-4 col-md-3 col-lg-2 visible-lg">
                I'm content only visible on large devices!
            </div>
        </div>
    

    You can see that as the browser size gets smaller, the columns start to form. Also, the content inside each will begin stacking.

    Conclusion

    You can see how easy it is to build complex and dynamic sites with the Bootstrap 3 grid. From mobile 2 column sites to complex hiding and showing elements on large desktops, you can build any type of site. Hopefully, these examples will give you an idea of the flexibility of the new grid system and all the great things you can create.

    Thanks for learning with the DigitalOcean Community. Check out our offerings for compute, storage, networking, and managed databases.

    Learn more about our products

    About the authors
    Default avatar
    Chris on Code

    author

    Still looking for an answer?

    Ask a questionSearch for more help

    Was this helpful?
     
    Leave a comment
    

    This textbox defaults to using Markdown to format your answer.

    You can type !ref in this text area to quickly search our full set of tutorials, documentation & marketplace offerings and insert the link!

    Try DigitalOcean for free

    Click below to sign up and get $200 of credit to try our products over 60 days!

    Sign up

    Join the Tech Talk
    Success! Thank you! Please check your email for further details.

    Please complete your information!

    Featured on Community

    Get our biweekly newsletter

    Sign up for Infrastructure as a Newsletter.

    Hollie's Hub for Good

    Working on improving health and education, reducing inequality, and spurring economic growth? We'd like to help.

    Become a contributor

    Get paid to write technical tutorials and select a tech-focused charity to receive a matching donation.

    Welcome to the developer cloud

    DigitalOcean makes it simple to launch in the cloud and scale up as you grow — whether you're running one virtual machine or ten thousand.

    Learn more