All Collections
Divi Documentation
Using The Builder
Divi Rows & Row Options
Divi Rows & Row Options

Rows are the builder's second largest building blocks, and can be used in various ways.

Mitch avatar
Written by Mitch
Updated over a week ago

Rows are the various column layouts that can placed inside of sections.

Like modules, Rows have various settings that can be accessed by clicking the settings icon on the top left of the row.

Rows settings, in particular, can greatly increase the variety of layouts built with the Divi Builder since they create the structure in which your modules are housed.

How To Add A Row To Your Page

  1. Edit or Create a new Page from WordPress Dashboard → Pages → All Pages.

  2. If the page:

    1. Already has the Divi Builder enabled, click on Edit with Divi link:

      Edit page with Divi

      This will launch the Visual Builder.

    2. If you don't have the Divi Builder enabled, open the page with the WordPress default editor by clicking on the Edit Link and enable the Divi Builder by clicking on the Use The Divi Builder button.

      Enable the Visual Builder

  3. Click the Green + button to add a new Row.

You will be greeted with a popup that allows you to choose the Row's columns layout:

Column Configuration

Proportions

1 Column

100% width

2 Columns

1/2 + 1/2 Columns equally spaced

3 Columns

1/3 + 1/3 + 1/3 Columns equally spaced

4 Columns

1/4 + 1/4 + 1/4 + 1/4 Column equally spaced

5 Columns

1/5 + 1/5 + 1/5 + 1/5 + 1/5 Columns equally spaced

6 Columns

1/6 + 1/6 + 1/6 + 1/6 + 1/6 + 1/6 Columns equally spaced

2 Columns

2/5 + 3/5 Columns

2 Columns

3/5 + 2/5 Columns

2 Columns

1/3 + 2/3 Columns

2 Columns

2/3 + 1/3 Columns

2 Columns

1/4 + 3/4 Columns

2 Columns

3/4 + 1/4 Columns

3 Columns

1/4 + 1/2 + 1/4 Columns

3 Columns

1/5 + 3/5 + 1/5 Columns

3 Columns

1/4 + 1/4 + 1/2 Columns

3 Columns

1/2 + 1/4 + 1/4 Columns

3 Columns

1/5 + 1/5 + 3/5 Columns

3 Columns

3/5 + 1/5 + 1/5 Columns

4 Columns

1/6 + 1/6 + 1/6 + 1/2 Columns

4 Columns

1/2 + 1/6 + 1/6 + 1/6 Columns

Once the Row has been added, you will be greeted with the Row's list of options. These options are separated into three main tabs:

  • Content

  • Design

  • Advanced

Content Tab

You will find all of the section's content elements within the content tab. For sections, the Content Tab's elements are limited to:

  • Column Structure

  • Link

  • Background

  • Admin Label

Column Structure

The Column Structure options can be used to quickly add or remove columns. We can add up to 6 Columns.

  • To add a new column, click on the Add New Column button.

  • To remove a column, click on the Trashcan icon.

Link

  • Row Link URL - Define a link. The URL used here will be used when the user clicks on the Section

  • Row Link Target - Define how the link opens:

    • In The Same Window - The link will open in the same browser Tab.

    • In A New Tab - The link will open in a new browser Tab.

Background

In the Background option group, the following options can be set:

  • Background Color

  • Background Gradient

  • Background Image

  • Background Video

  • Background Pattern

  • Background Mask

How to Add a Background Color

  1. Click the first tab, the Paint Bucket icon.

  2. Click Add Background Color and choose from your site's color palette, or use the eyedropper icon to find a new color.

How to Add a Background Gradient

  1. Click the second tab, the Gradient icon

  2. Click Add Background Gradient


    To change the gradient colors, click on the gradient stops and select a color from your site’s color palette or use the eyedropper icon to choose a new color. Gradient stops allow you to add more colors to the gradient. Click anywhere on the range slider to add a new stop.

Background Gradient Options

  • Gradient Type - You can change the gradient type by clicking the dropdown menu and selecting the desired gradient type.

  • Gradient Direction - You can change the direction of the gradient by dragging the range slider or typing in a numerical value.

  • Repeat Gradient - Toggle this option to yes if you want the gradient to repeat.

  • Gradient Unit - The gradient unit changes how the gradient stop points are calculated. Select the dropdown to change the unit.

  • Place Gradient Above Background Image - If a background image is applied, you can place the gradient above the background image by toggling this option to yes.

How to Add a Background Image

  1. Click the third tab, the Image icon.

  2. Click the Gray + icon to bring up the Media Library, where you can select an already uploaded photo from your library or upload a new one.

Background Image Options

  • Use Parallax Effect - To apply a parallax effect to the image (where the image scrolls faster than the foreground content, giving the illusion of a 3D effect), then toggle this option to on. By default, this setting is set to off.

  • Background Image Size - Choose the size of your background image by selecting a size from the dropdown menu.

  • Background Image Position - Choose the position of the background image by selecting a position from the dropdown menu.

  • Background Image Repeat - Choose if and how the background image repeats by selecting an option from the dropdown menu.

  • Background Image Blend - Choose how the background blends with other layers in the module by selecting an option from the dropdown menu.

How To Add a Background Video

  1. Click the fourth tab, the Video icon.

  2. Click the gray + sign to bring up the media library, where you can select an already uploaded photo from your library or upload a new one.

Background Video Options

  • Mp4 vs Webm. - We recommend uploading both mp4 version and webm version of the video because not all browsers support webm video formats. Uploading both file types ensures your video will play on all devices and browsers.

  • Background Video Width - Set the video's width by typing in a numerical value.

  • Background Video Height - Se the height of the video by typing in a numerical value.

  • Pause Video When Another Video Plays - If you’d like the background video to pause when another video is playing, toggle that option to yes. By default, the video will pause when not in view. If you want the video to continue playing, toggle this option to no.

How to Add a Background Pattern

  1. Click the 5th tab, the Pattern icon

  2. Click Add Background Pattern
    Choose the pattern type you want from the dropdown.

Background Pattern Options

  • Pattern Color - Select the pattern color from your site’s color palette or use the eyedropper icon to find a new color.

  • Pattern Transform - This is where you can transform the pattern horizontally, vertically, rotate it, or invert it.

  • Pattern Size - Pattern size is where you can select the pattern size: the actual size, cover, fit, stretch to fill or custom size. If you select custom size, the following options will appear: pattern width and pattern height. Drag the range slider or type in a numerical value to define those options.

  • Pattern Repeat Origin - Here, you can select the origin from which the pattern repeats.

  • Pattern Horizontal and Vertical Offset - You can also adjust the horizontal and vertical offsets for the pattern.

  • Pattern Repeat - Here, you can choose how the pattern repeats – horizontally, vertically, and more.

  • Pattern Blend Mode - This defines how the pattern layer interacts with the layers beneath it. Select from one of the 16 blend modes available from the dropdown.

How to Add a Background Mask

  1. Click the 6th tab, the Mask icon,

  2. Click Add Background Mask. Select the mask type you want via the dropdown menu.

Background Mask Options

  • Mask Color - Choose the mask color from your site’s color palette, or use the eyedropper icon to find a new color.

  • Mask Transform - Here, you can transform the mask horizontally, vertically, rotate it, or invert it.

  • Mask Aspect Ration - Here, you can set the aspect ratio of the mask. The aspect ratio of an image is the ratio of its width to its height.

  • Mask Size - This is where you can select the mask size: the actual size, cover, fit, stretch to fill or custom size. If you select custom size, the following options will appear: mask width and mask height. Drag the range slider or type in a numerical value to define those options.

  • Mask Blend Mode - This defines how the mask layer interacts with the layers beneath it. Select from one of the 16 blend modes available from the dropdown.

Admin Label

In this dropdown, you can add an admin label that will appear in the back-end builder, in Wireframe and the Layers View.

This is quite useful, especially when working with large layouts. Labeling all the Rows helps you quickly identify them with ease.

Design Tab

Within the design tab, you will find all of the Row's styling options, such as:

  • Sizing

  • Spacing

  • Border

  • Box Shadow

  • Filter

  • Transform

  • Animation

The Design Tab is where all the main styling options can be found. Every Row has a long list of design settings that you can use to change just about anything.

Sizing

This option group defines the sizing (width and height) of the Row. You can set a max-width, a max-height and a min-height for the Row.

Click the arrows to choose the module alignment (left, center, or right). By default, a Row is left-align .

  • Use Custom Gutter Width - You can set the Gutters' size (the space between each column) when enabled.

  • Equalize Column Heights - When enabled, each column will have the same height, regardless of the content. The tallest column height will be used.

  • Width - Defines the width of the Row. By default, the width is 80% of the Row's width. For more information, please check out the official documentation.

  • Max Width - Defines the maximum width of the Row. By default, the maximum width is 1080px. For more information, please check out the official documentation.

  • Row Alignment - If a Width or a Max Width value is set, the Row's alignment can be set using the three options:

    • Left Aligned

    • Center Aligned

    • Right Aligned

  • Min Height - Defines the minimum value for the Row's height. For more information, please check out the official documentation.

  • Height - Define the height of the section. For more information, please check out the official documentation.

  • Max Height - Defines the max-height value the Section can have. For more information, please check out the official documentation.

Spacing

You can add margins or spacing to this module by typing in numerical values.

Margin adds space outside the Section, and padding adds space inside the Row. To lock in ratios and keep the values the same, click the chainlink icon between the values you want to always be identical (e.g., top and bottom).

Default margin values for a Row are 0.

Default padding values for a Row are as follows:

  • Top Padding: 27px

  • Bottom Padding: 27px

  • Left Padding: 0px

  • Right Padding: 0px

Border

Add a border to the module. You can add a complete border or a border to only one side of the module. Adjust the width via the range slider and select a color. Choose a border style by clicking the dropdown.

  • Rounded Corners – Type in a numerical value for round border corners. The higher the number, the rounder the corners will be. The corner values are automatically linked (as seen by the highlighted blue chainlink in the middle); however, if you’d like to have different values for each corner, click the blue chainlink to unlink the values. If the values are automatically linked, they will always have the same value and update automatically if one value is changed.

  • Border Styles – Here, you can add a border to all sides of the module or individual sides (top, right, bottom, and left).

  • Border Width - This is where you set the width of the border. For a thicker border, increase the number. The border width must be at least 1px to show.

  • Border Color – This is where you can pick the border's color. You can select a color from your default site color palette that is already displayed or click on the eyedropper icon to find a new color.

  • Border Style – Here, you can select what border style you’d like: solid, dashed, dotted, double, groove, ridge, inset, outset, or none.

Box Shadow

Here, you can add a drop shadow to the entire module.

Once a shadow style is clicked, you can customize the following options:

  • Box Shadow Horizontal Position - Defines the horizontal position of the drop shadow.

  • Box Shadow Vertical Position - Defines the vertical position of the drop shadow.

  • Box Shadow Blur Strength - Defines the strength of the shadow's blur. The higher the value, the bigger the blur and the wider and lighter the shadow becomes.

  • Box Shadow Spread Strength - Defines the spread strength of the blur. Increasing the spread strength will increase the density of the box shadow. Higher density results in a more intense shadow.

  • Shadow Color - Defines the shadow's color.

  • Box Shadow Position - Defines the shadow's position. It can be inside the module or outside the module.

Filters

You can adjust the Row:

  • Hue - Defines the hue angle of a color.

  • Saturation- Defines how intense the color saturation should be.

  • Brightness - Defines how bright the colors should be.

  • Contrast - Defines how distinct bright and dark areas should be.

  • Invert - Invert the hue, saturation, and brightness by the specified value.

  • Sepia - Defines a warmer, more yellow/brown appearance.

  • Opacity - Defines how transparent or opaque the background (color, gradient, image, etc.) should be.

  • Blur - Defines the amount of Gaussian Blur applied to the module.

The Blend Mode refers to how the module blends with the layers beneath it. By default, normal will be selected.

Note: Any of the above filters will also impact the Row's inner elements: Columns and Modules.

Transform

  • Scale

  • Translate

  • Rotate

  • Skew

  • Origin points.

Tab through to access each option. Configure each option by inputting numerical values or dragging and expanding the box or circle.

You can lock in these values to always be identical by clicking the chain link icon at the bottom right.

Animation

Here, you can apply animation to the module. Once you choose a style, you can adjust the following options:

  • Animation Duration - Defines the length of time that an animation takes to complete one cycle.

  • Animation Delay - Define the amount of time to wait from applying the animation to an element before beginning to perform the animation. The animation can start later, immediately from its beginning, or immediately and partway through the animation.

  • Animation Starting Opacity - Define the starting opacity value.

  • Animation Speed Curve - Define the easing method of your animation. Easing your animation in and out will create a smoother effect than a linear speed curve.

  • Animation Repeat - By default, animations will only play once. If you want to loop your animation continuously, choose the Loop option here.

Advanced Tab

Within the Advanced tab, you will find options that more experienced web designers might find useful, such as custom CSS.

Here, you can apply custom CSS to your module. You can also apply custom CSS classes and IDs to the module, which can be used to customize the module's styles with more advanced CSS properties or to apply custom CSS code using the module's CSS class.

CSS ID & Classes

Assign a specific CSS ID or Class to this module. This is helpful when applying custom CSS to a module by using your child theme's stylesheet.

Custom CSS

  • Free-Form CSS - Write free-form css using the keyword selector to target this module. Example: selector h1 {color: red;}

  • Module Elements - You can also apply custom CSS to this module by pasting it in this tab. When you click on the Module Elements tab, you'll see individual sections where you can add custom CSS properties.

Conditions

This tab allows you to choose when to display the Section based on a set of conditions, like when a user is visiting the page if they’ve already purchased from your company before, what browser they are using, what operating system they’re using, and more.

You can add one condition or multiple conditions.

Conditional Display Rules

Visibility

  • Disable on - Defines the visibility of the row. You can disable it (hide it from view) when the display window is a Phone, Tablet, or Desktop by clicking the corresponding checkbox.

  • Horizontal Overflow - Defines what shows when content overflows a block-level element's left and right edges. This may be:

    • Visible - The content will show if the row's content overflows its height.

    • Scroll - If the row's content overflows its height, a vertical scroll bar will be used to scroll through its content.

    • Hidden - If the row's content overflows its height, the part of the content that overflows will be hidden.

    • Auto - The browser will decide whether a scroll bar will be shown.

  • Vertical Overflow - Defines what shows when content overflows a block-level element's top and bottom edges. This may be:

    • Visible - The content will show if the row's content overflows its height.

    • Scroll - If the row's content overflows its height, a vertical scroll bar will be used to scroll through its content.

    • Hidden - If the row's content overflows its height, the part of the content that overflows will be hidden.

    • Auto - The browser will decide whether a scroll bar will be shown.

Transitions

This controls the hover animation's transition duration, delay, and speed curve.

  • Transition Duration - Defines the duration (in milliseconds) of the transition of the hover animation.

  • Transition Delay - Defines the transition delay of the hover animation (in milliseconds).

  • Transition Speed Curve - Defines the transition speed curve of the hover animation.

Position

  • Position - This defines the position of the Row:

    • Relative (default value) - The Row is positioned according to the normal flow of the document, and then offset values are relative to itself based on the values of Vertical Offset and Horizontal Offset. The offset does not affect the position of any other elements; thus, the space given for the Row in the page layout is the same as if the position were default (static).

    • Absolute - The Row is removed from the normal document flow, and no space is created for the element in the page layout. The Row is positioned relative to its closest positioned ancestor (if any) or the initial containing block. The Location options determine its final position

    • Fixed - The Row is removed from the normal document flow, and no space is created for the element in the page layout. The Row is positioned based on the location options in relation to the browser window. This can be used to create a sticky Row.

  • Vertical Offset - Defines the Row's vertical position.

  • Horizontal Offset - Defines the Row's horizontal position.

  • Z-index - Defines the order of the module in the page layout. Rows with a higher z-index number overlap Rows with a lower z-index.

Scroll Effects

This defines how the Section behaves upon scrolling. Make the Row sticky (to top, bottom, or top and bottom) and choose if the module transforms upon scrolling.

You can also enable vertical motion on this module, which allows you to adjust the speed at which this element scrolls (making it faster or slower) without affecting the surrounding elements.

The Motion Trigger Effect allows you to choose when the scroll effect you just applied is triggered: when the top of the element is in view, the middle, or the bottom.

Let's Give Some Settings A Test Drive

Now that we have gone over all the settings let's test out a few in combination to show you what's possible when each setting is used creatively.

In this example, I will be touching on the full-width row setting as an introduction. The option to make a row Fullwidth is one of the most versatile options in the set.

This will extend the row's width to the browser's edge, similar to a Fullwidth Section. Unlike a Fullwidth Section, however, Fullwidth Rows can have column structures and house any module.

In the example below, I have created a 4 column row and added a square image to each column.

docs image

Next, I reduced the Gutter Width size to 1 to remove the spacing between columns in the Row.

docs image

Finally, I removed the padding above and below the Row by setting the Top Padding and the Bottom Padding values to 0.

docs image

The result is a complete row transformation, turning our normal 4-column row of images into a full-width and full-bleed image gallery that looks stunning against the green section below it.

This same effect can be created using custom column background colors and text-based modules. The possibilities are endless.

Related Articles
Equalize Column Heights Isn't Working
Video Background With Gradient Background Over It
Background Masks And Patterns For Divi
Advanced Gradient Builder For Divi
An Overview Of Divi Sections
Did this answer your question?