In this article, we're going to discuss the Grid Element and its child Cell Elements, which can be used to structure content across all builder environments. Let's dive in!

  1. Grid Element History
  2. Grid Spec vs. Flexbox
  3. Setting Up Your First Grid Layout
  4. Grid Setup Controls
  5. Cell Placement Controls
  6. Cell Layout Editor
  7. A Couple Layout Ideas
  8. Grid Context Menus
  9. Customize
  10. Video Tutorials
  11. Demo
  12. Summary

Grid Element History

Ever since the CSS Grid spec was announced some years ago, our entire team (but mostly Kory) has been incredibly excited about its implications for a couple reasons:

  • In addition to flexbox powered layouts, browsers would finally have a couple truly powerful layout engines at their disposal to explore designs and content structures unlike ever before.
  • We wanted to see if there was some way for us to take the power of this new layout paradigm and translate it into our builders.

We had to play the waiting game for a bit until the spec itself was finalized and implemented among the major browser vendors, but fast forward to today and here we arethe release of our brand new Grid Element! The Grid Element is a relatively pure abstraction of the CSS Grid spec itself that allows you to:

  • Define unique grid-template-column and grid-template-row layouts for any breakpoint.
  • Specify justify-* and align-* values on the grid as a whole.
  • Set grid-gap values across the X and Y axis.
  • Optionally place each Cell in the grid on any grid track for any breakpoint.
  • Optionally specify unique justify-self and align-self values for each Cell in the grid for any breakpoint.

The Grid Spec has a lot going on with it, so let's take a moment to review some basic terminology before we break it down so that we're all on the same page before reviewing its implementation in the Grid Element:

  • Grid The parent container where the overall layout template defines the structure of the grid tracks where Cells can be placed.
  • Cell A direct child of the grid that can be placed anywhere among the grid tracks defined by the layout template.
  • Layout Template Defines the overall structure of the grid and where Cells can be placed. Consists of grid-template-columns that creates tracks on the X axis and grid-template-rows that creates tracks on the Y axis.
  • Tracks The rows and columns of the layout template.
  • Grid Area Any specific combination of coordinates across the tracks.
  • Column Start / End Grid area coordinates along the X axis.
  • Row Start / End Grid area coordinates along the Y axis.
  • justify-* Placement of content along the X axis.
  • align-* Placement of content along the Y axis.
  • {{justify|align}}-content All content within the parent Element.
  • {{justify|align}}-items All content within their associated grid area.
  • {{justify|align}}-self The content of one specific grid area.

Grid Spec vs. Flexbox

The primary difference between Flexbox layouts and CSS Grid layouts is that Flexbox focuses on one dimensional relationships between Elements across a particular axis (e.g. having items grow to fill all available space on the main axis), while CSS Grid allows users to create two dimensional relationships among Cells across both the X and Y axis. For example, we can use grid-template-rows to define row tracks within our grid that all utilize the same height, keeping a uniform vertical order (the example below is shown with our grid editor overlay for easier visualization of the tracks):

Grid Example

Notice how the grid has an overall template and the Cells (colored orange) are placed amongst the layout. This particular example showcases another gigantic feature of CSS Grid that is easy to take advantage of with our Grid Element: source order independence. What this effectively means is that if we want to, we can place our Cells anywhere we want in the overall layout template irregardless of their actual placement in the physical markup. This means that for search engine optimization and accessibility reasons we can always ensure our primary content is first, but we can visually place it anywhere amongst our overall layout.

One other advantage that CSS Grid has going for it is being able to have multiple Cells occupy overlapping grid areas for easy layering of Elements. Notice in the example below how the background design to the right half of the section is placed specifically on the grid behind the main content. This is achieved by adding a blank Cell with a background image, which gives us the ability to place this Cell anywhere throughout the layout:

Grid Example

Setting Up Your First Grid Layout

A big paradigm shift for CSS Grids is that the overall layout of the Cells within the grid is defined on the grid itself as highly declarative CSS properties. For example, if you simply want a grid that has 100% wide Cells with each Cell appearing below the previous one on a new line, you could use this syntax in the Grid Layout control:

Grid Layout

The example above would be output to our dynamic CSS as:

.dynamic-grid-123 { grid-template-columns: 1fr; grid-template-rows: auto; }

The 1fr unit is a new value available for the CSS Grid syntax that effectively defines a "fractional" column that will take up as much space as is available. Since we only have a single 1fr value for our grid-template-columns property, this will force all Cells to span the entire width of the grid. The auto value for the grid-template-rows property simply allows for any new Cells to be added onto a new line.

So what if you wanted to add a grid with four columns? Well, all we would need to do is add three more 1fr units into our Columns Template input:

Grid Layout

The purple space above shows us an approximation of how the grid layout will behave over in the live preview. Now that we've defined our four column grid, lets say we added eight Cells to our Grid Element, they would be output as such:

Preview Cells

Notice how we get a new line after the fourth Cell due to the number of Cells exceeding the Column Layout defined on the Grid. As of right now these Cells are using auto placement, meaning that they will simply appear in the Grid in the order that they were added (similar to how Columns work within Rows). Later on we will explore layouts that utilize explicit placement for Cells on more complex grid templates.

Another handy way to write out the syntax above would be to use the repeat() CSS function, which takes a number as the first parameter to define how many times the values specified in the second parameter should be output. For example, if we wanted to output our 1fr 1fr 1fr 1fr value above, we would use:

Grid Layout

This can be particularly helpful for situations where we want to express complex repeated patterns, which we will explore in more detail later on.

Finally, take note that these templates can be defined uniquely for each breakpoint, meaning that your layouts can be completely custom to suit your needs at each specific breakpoint. Now that we've familiarized ourselves with how layouts work for CSS Grid, let's take a look at few additional setup controls on the Grid Element itself.

Grid Setup Controls

In addition to the Grid Layout control group explored previously, you'll find a Grid Setup control group similar to the setup box utilized on many of our other Elements:

Grid Setup

Some of these controls you will already be familiar with such as Font Size, Z-Index, Global Container, and Background found on other layout Elements. In addition to those we have our X & Y Content placement, X & Y Items placement, and X & Y Gap controls.

X & Y Content is output to justify-content and align-content respectively, and they handle the overall placement of all content within your Grid Element as a whole. To learn more about these CSS properties and how they work, it is strongly recommended that you do some reading on them from an official source such as the MDN web docs:

X & Y Items is output to justify-items and align-items respectively, and they handle the overall placement of all content within a Cell. To learn more about these CSS properties and how they work, it is strongly recommended that you do some reading on them from an official source such as the MDN web docs:

X & Y Gap control the amount of spacing between Cells in the grid along their corresponding axis. Adjust these values accordingly depending on the type of design you're going for.

Cell Placement Controls

When working with the Grid Element, any new Cells added to the layout will utilize auto placement, which you will see as a notice in the Cell Layout control group for any unplaced Cell:

Cell Layout

This auto placement behaves similarly to how Columns work within Rows in that each successive Cell will follow the overall structure of the Element that you have defined (i.e. if you have a relatively simple two column Grid and add three Cells to it, the third Cell will simply wrap to a new line). This is great and we can use it along with some cool tricks such as auto-fit to take advantage auto-responsive columns, but one of the greatest strenths of CSS Grid is being able to define complex base templates and then place your Cells anywhere throughout that layout. Once you've defined a base template you're happy with, one of the ways you can adjust a Cell's placement on that template is by clicking into this control group, which will reveal the following:

Cell Layout

This is where things start getting really fun, because it's these controls that really unleash the true power of CSS Grid layouts. The controls available here correspond to the following CSS properties (it is highly recommended you take some time to read through the official documentation on the MDN web docs linked out here):

For example, say that you had a grid template with eight defined columns and four defined rows and you wanted a particular Cell to start on the second grid column track and second grid row track. Then, say you wanted it to span two column and row tracks as well horizontally and vertically centering its content within that space. You could do that like so:

Cell Layout

As you can see, there is a fair amount of information you have to keep track of when wanting to place Cells throughout a Grid. We have to be mindful of our track counts for both rows and columns, specify multiple values to get our Cell just right, and then for every minor change we want to make we have to keep updating each of those coordinates one at a time. We wanted to help reduce this complexity to make Cell placement much simpler, which is why we introduced our Cell Layout Editor in the preview.

Cell Layout Editor

One of the things we're most excited about with our Grid Element is the introduction of the Cell Layout Editor, which is a toggleable interface in the preview that you can jump in and out of to easily adjust your Cell placement throughout the Grid. Let's take our "Shapes are Great" example from before and examine it once again:

Grid Example

The entire layout from this example has been created using the new Grid Element. For any Grid Element present on your page, hovering over it will reveal a small, purple icon in the upper-right corner of the Grid Element. Clicking on that button will enable the Cell Layout Editor:

Grid Example

One thing to take note of for this layout is that we have set all of our grid-gap values to 0px, and are inatead using the template as a whole to create the spacing we want to use between Cells. This is simply another way to explore spacing and layout using the Grid Element.

As you hover over the Cells in this editing mode, you will notice four carets appear in the corners of the Cell you are currently hovering over:

Cell Interaction

With your mouse over a particular Cell, you can then either click down on the center of the Cell to drag the entire Cell, or you can click down on one of the carets to resize the Cell. Either of these actions will focus the color on the Cell you are currently interacting with:

Cell Interaction

As mentioned before, one of the actions we could perform is a drag, which will maintain the Cell's overall volume. For example, you will notice in this particular Grid, the Cell being dragged has a 4x1 area, so it will keep that area in tact as you move it around the Grid (note that when doing this, your Cell may grow or shrink depending on the size of the tracks you're moving it to):

Cell Interaction

Additionally, you can resize this Cell as well by instead clicking and dragging one of the four carets in the corner of the Cell. Resizing allows you to alter the overall area of the Cell on the Grid:

Cell Interaction

If we were to drop our Cell into the area highlighted in the example above, we would end up with the following output:

Cell Interaction

Note how if we turn on our Cell Layout Editor again, you will see that the Cell has simply grown to fill the area specified from before:

Cell Interaction

Any movement of a Cell while the Cell Layout Editor is turned on will adjust the placement inputs mentioned in the previous section. The great thing about this is that if you drag or resize a Cell while the editor is turned on, not only do you get instant visual feedback in being able to see what works best, but the Editor will automatically take care of all the math in placing that Cell properly for you.

Additionally, you may have noticed the different usage of color and lines throughout this example. These are used as helpful indicators to give you a better sense of how your layout is behaving and represent different aspects of the grid template:

  • Dashed Lines Represent either an unoccupied grid area or the interior of a Cell that spans multiple tracks.
  • Solid Lines Represent the outer boundary of a Cell.
  • Purple Indicates either an unoccuped grid area or an auto placed Cell.
  • Orange Indicates a "placed" Cell on the Grid that is not using auto layout.

Finally, it is important to take note that any movement of a Cell using the Cell Layout Editor will only update that Cell's placement for the particular breakpoint you are currently viewing your site at. If you wish to have specific Cell placement at all breakpoints, you will need to explicitly do so yourself.

A Couple Layout Ideas

As mentioned previously, one of the greatest things about CSS Grid is its ability to more clearly define the expected behavior of a layout and explicitly place Cells exactly where you want them to go. This can be particularly useful for situations where maybe you want to have two overlapping Cells to give a layered effect (perhaps a large image to one side with some text from the other laying on top of that image). A really neat way to go about this would be using a layout like the following:

Overlapping Cells Example

If we turn on our Cell Layout Editor, we can see more clearly what's going on here:

Overlapping Cells Example

And then if we take a look at our Grid Layout control grouping, we can see even more clearly what's happening:

Overlapping Cells Example

Basically, we're using our Column Template of 1fr 4rem 1fr to define a three column layout with two equal width column tracks to the outside and one fixed width in the middle. That middle value of 4rem is used to specify exactly how much of an overlap we want to have between our two Cells. Then, each Cell is simply placed to the edge of the grid and spanning over that middle column track.

Additionally, the Row Template of 4rem 1fr 4rem is used to define our second Cell's top and bottom spacing from the edge of the Grid. The 1fr in the middle allows ensures that both Cells vertically align as they should.

The great thing about all of this is once you set it up, you can go back and adjust your overlap values or gap values from one place on the Grid parent, rather than having to manage it in multiple places across each Cell, greatly simplifying the exploration process of finding the perfect dimensions to use for your design. And of course, it's all fully response, so we might wish to have this layout for our LG and XL breakpoints, but using something completely different for our smaller breakpoints:

Overlapping Cells ExampleOverlapping Cells ExampleOverlapping Cells Example

Takng this responsive template idea to a completely new level, here's a quick example of just how far we can take our Grid templates and Cell placement within a design across multiple breakpoints:

Responsive Layout ExampleResponsive Layout ExampleResponsive Layout Example

Take note of how the overall Grid column and row track counts change, in addition to the placement of each Cell for each breakpoint. This is true flexibility unlike anything you've ever seen before with a layout tool. We will be exploring more layout possibilities with you all on our YouTube channel in the coming months, so definitely make sure to subscribe over there if you haven't already to keep up with our latest content!

Grid Context Menus

A shiny new builder wouldn't be complete without some shiny new Context Menu actions, would it? Right-clicking on any Cell in the preview or the Layout Pane will reveal the following Context Menu:

Context Menu

You can use the Bring to Front, Bring Forward, Send Backward, and Send to Back, actions to update the order of the Cell within the Grid. Keep in mind that this only changes the placement of the Cell in the physical markup, but if you have a z-index value set for that Cell instead of auto, that value will always override the general markup order. Additionally, Use Auto Placement will quickly reset a Cell's positioning back to auto placement.

Furthermore, you can right-click on any of the Grid Layout or Cell Layout control boxes to copy a layout at a particular breakpoint and either paste it to a single breakpoint or apply it to all other breakpoints for quick layout changes.


The Customize pane consists of various features that allow you to take further control over your Element's styling and functionality:

  • ID Sets an HTML ID on the Element.
  • Class Sets an HTML Class on the Element.
  • Element CSS Use this feature for increased stylistic control of your Element, especially over nested markup. Click here for more detailed information on this feature, such as using $el to dynamically target the base tag, et cetera.
  • Hide During Breakpoints Hides the Element at different screen sizes when design alterations are needed. Click here for more information.
  • Conditions Adds / removes Elements from the page when certain criteria are met (e.g. If a featured image is set...). Click here for more information.
  • Custom Attributes Use this option to add custom HTML attributes to the root tag of the Element (e.g. data-info="123"). This can be particularly helpful when integrating with various scripts and libraries.
  • Looper Providers & Consumers Use these controls to access information in your WordPress installation and output it on the frontend of your website using Elements from across our Builders. Click here for more information.

Video Tutorials

Join Themeco lead developer Kory Wakefield as he walks you through this exciting new Element on YouTube. This 7-part series will take you from beginner to Grid Pro in no time. Even better, several Grid Templates have been added to Design Cloud to help you get up and running quickly!


To see a live demo of the Grid Element click here.


To sum up, we've discussed Pro's exclusive Grid Element. We've discussed that a Grid Element is an easy tool for adding grids to a page, and we've learned how to change its content, design, and settings.

See something inaccurate? Let us know