The Divi Button Module

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

How To Add A Button Module To Your Page

Before you can add a button module to your page, you will first need to jump into the Divi Builder. Once the Divi Theme has been installed on your website, you will notice a Use Divi Builder button above the post editor every time you are building a new page. Clicking this button will enable the Divi Builder, giving you access to all of the Divi Builder’s modules. Next, click the Use Visual Builder button to launch the builder in Visual Mode. You can also click the Use Visual Builder button when browsing your website on the front end if you are logged in to your WordPress Dashboard.

Once you have entered the Visual Builder, you can click the gray plus button to add a new module to your page. New modules can only be added inside of Rows. If you are starting a new page, don’t forget to add a row to your page first. We have some great tutorials about how to use Divi’s row and section elements.

Locate the button module within the list of modules and click it to add it to your page. The module list is searchable, which means you can also type the word “button” and then click enter to automatically find and add the button module! Once the module has been added, you will be greeted with the module’s list of options. These options are separated into three main groups: Content, Design and Advanced.

Use Case Example: Adding a CTA Button to the Hero Section of a Landing Page.

There are countless ways to use the Button Module. For this example, I’m going to show you how to add a “learn more” button to the hero section of a landing page.

Let’s get started.

Use the visual builder to add a Standard Section with a fullwidth (1 column) layout. Add a Text Module to add and style the Headline and Subheadline. Then add the Button Module directly under the Text Module.

Update the Module Settings as follows:

Content tab

Button Text: Learn More
Button URL: [enter URL]

Design tab
Button alignment: Center
Text Color: Light
Use Custom Styles for Button: YES
Button Text Size: 20px
Button Text Color: #ffffff
Button Background Color: #0065cb
Button Border Width: 9px
Button Border Color: #0065cb
Button Border Radius: 100px
Button Letter Spacing: 2px
Button Font: Source Sans, Bold, Uppercase
Button Hover Letter Spacing: 2px

That’s it! This is just one of the countless ways you can use the button module.

Button Content Options

Within the content tab you will find all of the module’s content elements, such as text, images and icons. Anything that controls what appears in your module will always be found within this tab.

Button Text

Input your desired button text.

Button URL

Input the destination URL for your button.

URL Opens

Here you can choose whether or not your link opens in a new window.

Admin Label

This will change the label of the module in the builder for easy identification. When using WireFrame view in the Visual Builder, these labels will appear within the module block in the Divi Builder interface.

Button Design Options

Within the design tab you will find all of the module’s styling options, such as fonts, colors, sizing and spacing. This is the tab you will use to change how your module looks. Every Divi module has a long list of design settings that you can use to change just about anything.

Button Alignment

Here you can choose to have your button aligned to the left, right or center.

Text Color

Here you can choose whether your text should be light or dark. If you are working with a dark background, then your text should be light. If your background is light, then your text should be set to dark.

Use Custom Styles for Button

Enabling this option will reveal various button customization settings that you can use to change the appearance of your module’s button.

Button Text Size

This setting can be used to increase or decrease the size of the text within the button. The button will scale as the text size is increased and decreased.

Button Text Color

By default, buttons assume your theme accent color as defined in the Theme Customizer. This option allows you to assign a custom text color to the button in this module. Select your custom color using the color picker to change the button’s color.

Button Background Color

By default, buttons have a transparent background color. This can be changed by selected your desired background color from the color picker.

Button Border Width

All Divi buttons have a 2px border by default. This border can be increased or decreased in size using this setting. Borders can be removed by inputting a value of 0.

Button Border Color

By default, button borders assume your theme accent color as defined in the Theme Customizer. This option allows you to assign a custom border color to the button in this module. Select your custom color using the color picker to change the button’s border color.

Button Border Radius

Border radius affects how rounded the corners of your buttons are. By default, buttons in Divi has a small border radius that rounds the corners by 3 pixels. You can decrease this to 0 to create a square button or increase it significantly to create buttons with circular edges.

Button Letter Spacing

Letter spacing affects the space between each letter. If you would like to increase the space between each letter in your button text, use the range slider to adjust the space or input your desired spacing size into the input field to the right of the slider. The input fields supports different units of measurement, which means you can input “px” or “em” following your size value to change its unit type.

Button Font

You can change the font of your button text by selecting your desired font from the dropdown menu. Divi comes with dozens of great fonts powered by Google Fonts. By default, Divi uses the Open Sans font for all text on your page. You can also customize the style of your text using the bold, italic, all-caps and underline options.

Add Button Icon

Disabled this setting will remove icons from your button. By default, all Divi buttons display an arrow icon on hover.

Button Icon

If icons are enabled, you can use this setting to pick which icon to use in your button. Divi has various icons to choose from.

Button Icon Color

Adjusting this setting will change the color of the icon that appears in your button. By default, the icon color is the same as your buttons’ text color, but this setting allows you to adjust the color independently.

Button Icon Placement

You can choose to have your button icon display on the left or the right side of your button.

Only Show Icon On Hover for Button

By default, button icons are only displayed on hover. If you would like the icon to always appear, disable this setting.

Button Hover Text Color

When the button is hovered over by a visitor’s mouse, this color will be used. The color will transition from the base color defined in the previous settings.

Button Hover Background Color

When the button is hovered over by a visitor’s mouse, this color will be used. The color will transition from the base color defined in the previous settings.

Button Hover Border Color

When the button is hovered over by a visitor’s mouse, this color will be used. The color will transition from the base color defined in the previous settings.

Button Hover Border Radius

When the button is hovered over by a visitor’s mouse, this value will be used. The value will transition from the base value defined in the previous settings.

Button Hover Letter Spacing

When the button is hovered over by a visitor’s mouse, this value will be used. The value will transition from the base value defined in the previous settings.

Button Advanced Options

Within the advanced tab, you will find options that more experienced web designers might find useful, such as custom CSS and HTML attributes. Here you can apply custom CSS to any of the module’s many elements. You can also apply custom CSS classes and IDs to the module, which can be used to customize the module within your child theme’s style.css file.

CSS ID

Enter an optional CSS ID to be used for this module. An ID can be used to create custom CSS styling, or to create links to particular sections of your page.

CSS Class

Enter optional CSS classes to be used for this module. A CSS class can be used to create custom CSS styling. You can add multiple classes, separated with a space. These classes can be used in your Divi Child Theme or within the Custom CSS that you add to your page or your website using the Divi Theme Options or Divi Builder Page Settings.

Custom CSS

Custom CSS can also be applied to the module and any of the module’s internal elements. Within the Custom CSS section, you will find a text field where you can add custom CSS directly to each element. CSS input into these settings are already wrapped within style tags, so you need only enter CSS rules separated by semicolons.

Button Relationship

Here you can define a custom rel attribute for the button, such as rel=”nofollow.” Divi lets you pick from all of the most common link attributes.

Visibility

This option lets you control which devices your module appears on. You can choose to disable your module on tablets, smart phones or desktop computers individually. This is useful if you want to use different modules on different devices, or if you want to simplify the mobile design by eliminating certain elements from the page.