CSS Grid for UI Layouts

CSS Grid is a great layout tool for content-driven websites that include long passages of text, and it has tremendous value for a variety of traditional UI layouts as well. In this article I’ll show you how to use CSS Grid to improve application layouts that need to respond and adapt to user interactions and changing conditions, and always have your panels scroll properly.

CSS Grid builds website layouts. It lets web designers create beautiful dynamic layouts using just a tiny bit of supported code instead of the endless float hacks we’ve had to use for years. My friend and co-worker Jen Simmons has been talking about CSS Grid for years, tirelessly pushing to get it implemented in browsers, and her work has paid off. As of the end of last year, the current version of every major browser, desktop and mobile, supports CSS Grid.

CSS Grid really is powerful, and you can build dynamic content driven websites easily, like in these examples. However, Grid is good for more than laying out pretty blocks of content. Grid gives you full control over both dimensions of your layout, including scrolling. This means features we take for granted in native applications like collapsing side-panels and fixed toolbars are now trivial to implement. No more hacks and no more debugging. Grid just works.

I’ve been building web tools for years. Here’s a screenshot of a game building tool I made for my retro RPGs. When Flexbox first appeared I immediately started using it. I built complex layouts using nested horizontal and vertical boxes, with a few utility classes for things like scrolling and stretching.

Flexbox has certainly made me more productive than absolutely positioned divs and float hacks, but it still has problems. Look at this closeup where panels come together. See how the footers on the left and right don’t line up?

Here’s another screenshot. The toolbar is at the top of the drawing canvas, and according to my framework it should be fixed at the top, but the minute you start scrolling this happens. The toolbar disappears:

Each of these problems can be fixed with more positioning and float hacks, but the result is always fragile. Every time I add a new panel I have to debug my layout all over again; searching to identify which div is grabbing the extra space during a resize. And the markup is ugly. The nested horizontal and vertical boxes become very complicated, and this example is only two levels deep. As interaction and functionality become more complex the design becomes even more challenging.

<div class='hbox'>
  <div class='vbox'>
    <div class='hbox'>header</div>
    <div class='scroll'>
      <div class='sidebar'>sidebar</div>
    <div class='footer'>footer</div>

  <div class=vbox>
    <div class='hbox'>button button 
        spacer label spacer button button </div>
    <div class='center'>main content</div>
    <div class='hbox'>the footer</div>

  <div class=vbox>
    <div class=’hbox’>header</div>
    <div class=’scroll’>
      <div class=’sidebar’>sidebar</div>
    <div class=’footer’>footer</div>

Entering the Second Dimension

The fundamental problem with Flexbox is that it is one dimensional. This makes Flexbox great for one dimensional uses, like toolbars and navbars, but it begins to fail when I need to align content both horizontally and vertically at the same time. Instead I need real two dimensional layout, which is why I need CSS Grid. Fundamentally Grid is 2D.

Here’s a similar kind of layout built with CSS Grid.

Look closely at the bottom footers. They come together perfectly. And by using the grid-gap for the lines instead of adding borders to each panel, I don’t have to worry about inconsistent grid line widths. Everything just works.

The biggest benefit I get from CSS Grid is adapting to changing conditions. My apps often have side panels. I need to make sure everything in the layout works regardless of whether the panels are expanded or collapsed, ideally without having to recalculate layout in JavaScript. Sidebars are made out of multiple components like headers and footers. All of these need to line up, regardless of which one is larger or smaller.  Grid can do this too using a magic function called minmax().

If you’ve studied CSS Grid before then you know you can define your layout using templates for the rows and columns.  A template like 200px 1fr 200px will give you 200px wide sidebars with a middle content area taking up the rest of the space. But what happens if the panel should collapse? Right now the column would stay at 200px, even though the content has shrunk. Instead we can use minmax with the min-content keyword for the max parameter.

#grid {
  display: grid;
  box-sizing: border-box;
  width: 100vw;
  height: 100vh;
      [start] minmax(auto, min-content) 
      [end] minmax(auto,min-content);
  grid-gap: 1px;
  background-color: black;

Now the grid column will be always be just wide enough to hold whatever is in any of the columns using their minimum width. Thus if one part of the column (say the header) is wider than the others, the column will expand to fit them all. If they become skinnier or disappear altogether, then the column will adjust accordingly. Essentially we have replicated the expanding/contracting behavior of Flexbox, but made it work with everything in the column together, not just one item. This is real 2D layout.

Here is the code for the rest of the demo.

.start {
  grid-column: start;
.center {
  grid-column: center;
.end {
  grid-column: end;
header {
  grid-row: header;
footer {
  grid-row: footer;
.sidebar {
  overflow: auto;

<div id="grid">

<header class="start">header</header>
<header class="center">
  <button id="toggle-left">toggle left</button>

<header class="end">header</header>

<div class="start sidebar">sidebar</div>
<div class="center content">the center content</div>
<div class="end sidebar">
<footer class="start">left footer</footer>
<footer class="center">center footer</footer>
<footer class="end">right footer</footer>


To make the toggle buttons in the upper header actually hide the sidebars I added this code. Note that with modern DOM APIs and arrow functions we can essentially replicate JQuery in just a few lines:

const $ = (selector) => document.querySelector(selector)
const $$ = (selector) => document.querySelectorAll(selector)
const on = (elem, type, listener) => elem.addEventListener(type,listener)

  $$(".start").forEach((elem) => elem.classList.toggle('closed'))
  $$(".end").forEach((elem) => elem.classList.toggle('closed'))

Also note that CSS Grid does not deprecate Flexbox. We still use Flexbox in the cases where it makes sense: namely one dimensional content like toolbars. Here are the styles that I’m using for my toolbars made out of headers:

<header class="center">
  <button id="toggle-left">toggle left</button>
  <span class="spacer"></span>
  <span class="spacer"></span>
  <button id="toggle-right">toggle right</button>

header {
  background-color: #ccc;
  display: flex;
  flex-direction: row;

.spacer {
  flex: 1;

The spacer class makes an element take up all of the extra space. By using two spacers between the buttons I can make my toolbar shrink and grow as needed with the filename always in the middle. This is similar to native toolbars.

You can try out a demo live at this Codepen, then remix it to poke and prod.

See the Pen CSS Grid for UI Layouts by Josh Marinacci (@joshmarinacci) on CodePen.

CSS Grid is wonderful for designing interactive applications with two-dimensional complexity. We can keep the markup semantic. Panels and toolbar line up properly. The grid-gap gives us automatic borders. It adjusts our layout in complex ways without any JavaScript code, and it gives us control over both the horizontal and vertical. And we can do it all without using a heavy CSS framework.

Jen Simmons has started a new YouTube channel, Layout Land to help you grok how Grid works.  If you work on web apps or any kind of richly interactive website, you should try out CSS Grid.

About Josh Marinacci

I am an author, researcher, and recovering engineer. Formerly on the Swing Team at Sun, the webOS team at Palm, and Nokia Research. I spread the word of good user experiences. I live in sunny Eugene Oregon with my wife and genius Lego builder child.

More articles by Josh Marinacci…


  1. Hayk Saakian

    Do you think CSS Grid will make Flexbox obsolete?

    I see more and more news about designers moving away from it just as support for flexbox in browsers is getting mainstream

    February 14th, 2018 at 11:59

    1. Josh Marinacci

      No. Grid and Flexbox are good at different things. They will both be around for a long time.

      February 22nd, 2018 at 22:02

  2. Alberto

    This is great, so bad IE11 does not support it :(

    February 15th, 2018 at 14:26

    1. Josh Marinacci

      IE11 does support an older form of Grid. It might work for what you need.

      February 22nd, 2018 at 22:05

  3. llama

    Apologies if this is a simple question, but I’ve attempted to fork your codepen code into a github page and encounter the following issue:

    08:14:08.410 TypeError: elem is null 1 code.js:3:41
    on https://[url]/code.js:3:41

    The javascript code from your codepen is located in code.js and referenced with a simple script tag. I’ve also included the jQuery lib as well, thinking it was caused by a missing dependency.

    Thanks for any help you can provide! I am a big fan of the layout, especially using the min-width constraint for the sidebar size.

    February 21st, 2018 at 05:17

    1. Josh Marinacci

      Could you tell me more about the problem? Are you trying to use the script from the codepen directly from the site into another site?

      February 21st, 2018 at 14:00

      1. llama

        Apologies, I forgot to clarify how I achieved the error. It pops when I attempt to click on the sidebar toggle buttons (the arrows on the footer). The toggle fails to work, and the error I quoted shows up in console:

        08:14:08.410 TypeError: elem is null 1 code.js:3:41
        on https://[url]/code.js:3:41

        Line 3 of code.js is:

        const on = (elem, type, listener) => elem.addEventListener(type,listener)

        Yes, I pulled the code from the codepen: the HTML into an index page, the CSS into a .css and the JS into a .js – all successfully imported with the requisite link and script tags, into the HTML page. I checked your settings on that pen and noticed you didn’t have any external libraries included either (jQuery, jQueryUI, etc.) but I added an include for jQuery anyways in case. Still no bueno.

        February 22nd, 2018 at 05:43

        1. Josh Marinacci

          You don’t need jQuery or any other external libraries.. The example provides it’s own $ function for doing selectors. The error looks like the ‘on’ function was trying to use a null element. Check that your selector is correct. Did you misspell something like the selector in on($(“#foo”),’type’,()=>())

          February 22nd, 2018 at 22:08

  4. öküz”


    February 22nd, 2018 at 05:15

  5. david

    I’d like to see the game that appears in the screenshots :) reminds me of skifree for windows 95

    February 22nd, 2018 at 15:54

    1. Josh Marinacci

      Ha hah. Here’s the game. https://9bit.io/xmas2017/

      February 22nd, 2018 at 22:09

      1. david

        Great! thank you very much. I really think that layout mechanisms should be conceived as if they were going to be used for game development. There is nothing in web pages that is not present in zelda, a link to the past.

        February 23rd, 2018 at 06:51

  6. anonymous

    I’m not sure “emulating” jquery is a good practice.

    February 22nd, 2018 at 16:44

  7. Camilo Reyes

    Great article, thanks! I’ve spent a lot of time looking at CSS Grid and this the first time it “clicks” for me. A 2D layout versus the Flexbox one dimensional layout, brilliant!

    TBF, “emulating” jQuery is okay. I’d rather put on little weight, like two or three lines of functional programming, rather than gain a 50KB dependency.

    February 25th, 2018 at 11:13

  8. Robert


    February 25th, 2018 at 16:45

  9. secretboot

    I have a bootstrap. Simple web pages are made with bootstrap. I’m not a designer. Do you really need to learn CSS grid layout? Who needs a grid layout? Who needs a bootstrap?

    March 1st, 2018 at 22:07

    1. Josh Marinacci

      With CSS grid there is much less need for bootstrap. You can build complex layouts with just a very small amount of code.

      March 2nd, 2018 at 11:38

Comments are closed for this article.