Skip to main content
The Divi Button Module

How to add, configure and customize the Divi button module.

Updated over 6 months ago

The Divi Button Module is versatile and can be used across your website. Create fun hover styles, use custom icons, and guide visitors through your website with the interactive button module.

How to Add the Divi Button Module to Your Page

  1. Add a new page or edit an existing page.
    By default, the Standard Gutenberg Editor loads whenever a new post or page is added to WordPress.

  2. Click the purple button underneath the page title. Use The Divi Builder.

Enable Visual Builder

Once clicked, the page will be reloaded with the Divi Visual Builder.

As your page reloads, you'll notice three options:

  • Build From Scratch

  • Choose A Premade Layout

  • Build with AI

Build From Scratch

This option loads the Divi Builder with a blank page design. Choose this option if you'd like to start your page design from Scratch.

Choose a Premade Layout

This option lets you choose from our large library of pre-designed Divi layouts. You can choose from premade layouts by Divi, which you've designed and saved to your Divi Library, and existing pages on your website that you can clone.

Build with AI

This option allows you to create an entire page layout using Divi AI. Using your text prompt and information about your website, you can create the perfect page outline, then build it and fill it with content and imagery, bringing it all to life in no time.

Add The Divi Button Module

  1. Click the green + icon to insert a Row.

  2. Click the gray + icon inside the Row to open the Divi Module Library, which contains all the modules included with the Divi theme.

  3. Find the Button module and click on it to load the module.
    The module library is also searchable. Type the module name you want in the search bar at the top.

How to add the Button module

All Divi Button Module Options Explained

Once you’ve added the Divi Button module, the module settings automatically pop up. This is where this module's content and design styles are configured. These settings are organized into three groups via the tabs at the top of the module: Content, Design, and Advanced.

How to use the Divi Button Module

Content Tab

Inside this tab, you’ll find the Content options available for the Divi Button module.

Button's Content Tab

Text

  • Button - Type the text you'd like the button to display here.

Button's Text content settings

Link

This is where you paste the URL link you'd like the button to point towards.

  • Button Link URL - Paste the URL you want to apply to the button here. When clicked, visitors will be taken to that web link.

  • Button Link Target - Defining a link target determines whether the link, when clicked, opens in a new tab or the same window.

    • In The Same Window - if you want the link to open in the same window

    • In The New Tab - if you want that link to open in a new tab.

Button's Link settings

Admin Label

The Admin Label is where you can give the module a name only visible to you to assist in keeping things organized and easy to understand on the back end. By default, the admin label will be the name of the module. You can change the text of the admin label to reflect what you’d like.

Button's Admin Label

Design Tab

Inside this tab, you’ll find all the design styles and options for the Divi Button module.

Button's Design Tab

Alignment

  • Button Alignment - Choose how you'd like the button to align:

    • Left

    • Center

    • Right

Button's Alignment settings

Text

  • Text Color - Select this module's default text color palette: light or dark. The default light color palette and dark color palettes can be configured in the Divi Theme Options.

Button's Text settings

Button

By default, buttons inherit the global design styles set in the WordPress Customizer. However, you can apply custom design styles to buttons here.

  • Use Custom Styles For Button - To design a custom style for this button, toggle this option to Yes. Then, the following options will appear.

  • Button Text Size - Choose the size of the button font here. Drag the range slider to adjust the size or type a numerical value in the textbook.

  • Button Text Color - Choose the color of the button font here. Select a color from your site's palette, or use the dropper icon to find a new color.

  • Button Background - Choose the background color of the button here. Select a color from your site's palette, or use the dropper icon to find a new color.

  • Button Border Width - Set the button border width here. Drag the range slider to adjust the width or type a numerical value in the textbox.

  • Button Border Color - Choose the color of the border here. Select a color from your site's palette, or use the dropper icon to find a new color.

  • Button Border Radius - Set the button's border-radius here. The radius refers to how round the corners are. The higher the number, the more round the corners are. Drag the range slider to adjust the radius or type a numerical value in the textbox.

  • Button Letter Spacing - Choose the letter spacing of the title text by dragging the range slider or by typing in a numerical value. Letter spacing is the space between each letter. The higher the number, the more space.

  • Button Font - Choose the font you want for the button text. The default font is automatically selected; however, you can choose a different font or upload a custom font by clicking the dropdown box.

  • Button Font Weight - Click the dropdown to select the boldness of the button font.

  • Button Font Style - Choose the style of the button font: italicized, capitalized, small capitals, underlined, or strike-through.

  • Show Button Icon - Toggle this option yes or no to show or hide a button icon.

  • Button Icon - You can select the button icon here if the previous option is yes.

  • Button Icon Color - Choose the color of the icon here. Select a color from your site's color palette, or use the dropper icon to find a new color.

  • Button Icon Placement - Choose where you want the button icon to be: to the right or left of the button text.

  • Only Show Icon On Hover For Button - This option is set to yes by default, meaning the icon will only appear on hover. If you'd like the icon to always be visible, toggle this option to no.

  • Button Text Shadow - You can apply a drop shadow to the button text here. Choose the style of drop shadow you'd like to use, and you can customize it using the following options.

  • Button Text Shadow Horizontal Length - Adjusts the horizontal positioning of the text shadow.

  • Button Text Shadow Vertical Length - Adjusts the vertical positioning of the text shadow.

  • Button Text Shadow Blur Strength - Adjusts the shadow blur strength of the shadow applied to the text. The higher the number, the more blur.

  • Button Text Shadow Color - Choose the color of the text-shadow. Select a color from your site's color palette, or use the dropper icon to find a new color.

Button's Design settings

Spacing

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

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

  • Default margin values for the Button module are 0.

  • Default padding values for the Button module are:

    • Top Padding: 0.3em (6px)

    • Bottom Padding: 0.3em (6px)

    • Left Padding: 1em(20px)

    • Right Padding: 1em(20px)

Button's Spacing settings

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 the wider and lighter the shadow.

  • 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.

Button's Box Shadow settings

Filters

Adjust the module's filters:

  • 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.

Button's Filters settings

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.

Button's Transform settings

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.

Button's Animation settings

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.

Button's Advanced Tab

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.

Button's CSS ID and Classes

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.

Button's Custom CSS settings

Attributes

  • Button Relationship - This defines the button link’s relationship between the source you are linking to and the page you are linking from.

Button's Attributes

Conditions

This tab allows you to choose when to display this module 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.

Button's Display Conditions settings

Visibility

  • Disable on - Defines the visibility of the module. 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 module's content overflows its height.

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

    • Hidden - If the module'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 module's content overflows its height.

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

    • Hidden - If the module'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.

Button's Visibility settings

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.

Button's Transitions

Position

  • Position - This defines the position of the module:

    • Relative (default value) - The module 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 module in the page layout is the same as if the position were default (static).

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

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

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

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

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

Button's Position settings

Scroll Effects

This defines how the module behaves upon scrolling. You can make the module 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.

Button's Scroll Effects

Save Your Design

Once you are finished styling and configuring the module, click the green arrow at the bottom right of the module to save your design. If you close the module without saving, your work will be lost.

Next, Save the Page Design

To save the page design, you can type CMD + S on a Mac or CTRL + S on a PC. You can also use the bottom Divi toolbar to save your page design by clicking the circle purple icon with the three dots to expand the toolbar and then clicking the green Save button at the bottom right.

Exit the Visual Builder

Now that all your changes are saved, click Exit Visual Builder on the admin toolbar at the top to exit the Visual Builder.

Exit Visual Builder

Continue Learning

Did this answer your question?