Button module overview
Note: This article describes the Button module as of Beaver Builder 2.2. For information on the new and changed features from earlier releases, see this article.
The Button module is an exactly that: an object that you insert into your layout that resembles a physical button. This article includes the following sections:
Uses of this module
- Traditionally, a web button is a pretty package for a link that sends visitors elsewhere when clicked.
- The Button module's button can also open a lightbox that displays a video or any other content that you can insert with shortcut or HTML.
Default button style
If you use the Beaver Builder Theme, by default the global color and hover color of buttons is the theme's accent color and accent hover color. This is set in Customize > General > Accent color. The button's default text color is white text for darker accent colors and black text for lighter colors. The default font family for the button text depends on the font family set for the
Custom button style
Here are some examples of the Button module's style options:
Here are the details of the settings for each button example shown in the screenshot.
- Default settings:
Width = Auto
Background style = Flat
Background animation = Disabled
- Padding = 30px
Typography: Font family = Montserrat Alternates; Weight = Medium; Size = 24 px; Line height = 1.2 em;
Background color = #003b51; Background style = Gradient
Border: Style = Solid; Color = #rgba(86,0,60,0.93); Width = 20px;
- Text color = #00185b
Background color: rgba(255,255,255,0) (i.e., transparent)
Border: Style = Solid; Color = #910026 Width = 2px
Border radius: Upper left = 15px; Lower right = 15px
Box shadow: Color = #66002c; X = 4px; Y = 4px; Blur = 8px
- Background color = rgba(0,93,127,0.50) (50% opacity); Background style = Gradient
Border box shadow: Color = #005d7f; Blur = 8px
- Width = Full width
Padding = 30px
Typography: Font family = Encode Sans Expanded; Weight = Semi-bold; Size = 24 px;
Background color = #009966; Background style = Flat
There are also options for setting different button hover styles, as described in the Style tab details below.
Click Action: Link or Lightbox
You can set the button's click action to either a link or a lightbox.
Set the click action to a link
When you set Click action to Link, a Link section opens.
- Enter the URL to the link or click Select to choose a page or post from your site.
- Set Link target to determine whether the linked page replaces your current page in the same tab ( Same window) or opens in a new tab (New window).
- The Link No Follow field tells search engines whether or not to follow the link. The default is No, which tells search engines to follow the link. Yes means "Yes don't follow the link." For more information about when to use
nofollow, see the Google webmaster article.
Set the click action to a lightbox
If you choose the Lightbox option, you next choose whether the lightbox content will be based on custom HTML content or a link to a video, as described in the following sections.
With the HTML content type option, an HTML editing box lets you enter custom HTML that will be displayed in the lightbox. This works great for adding shortcode. In the following screenshot, the shortcode for a saved row containing a Call to Action module was inserted into the HTML box to make an opt-in popup.
You could also add shortcode from third-party plugins. For example, a plugin that uses a shortcode to display PDF content on a web page could be used to display the PDF in a lightbox by using the same shortcode in the HTML box.
The video option works well as an alternative to embedding the video in the page. Insert the URL of the video you want to open in the lightbox, from a service such as Youtube or Vimeo.
This tab has the following settings.
The text that appears on the button.
Optional icon to appear on the button. If you select an icon, there are two additional fields:
Icon position: Before or after the button text.
Icon visibility: The icon can be always visible or appear on hover only.
- Click action
Link or Lightbox. With Link, there is a URL field. With Lightbox, there is a LIghtbox Content section with Content type to either embed content into an HTML field or provide a video link. See the click action examples in the previous sections.
The Style tab is shown in the screenshot and described below.
1 Top section
Auto width: Width adjusts to fit the text and icon.
Full width: The width expands to the content area minus the module's margin settings.
You can set a custom width in px, vw, or %. See the Related Articles below for more information about these units of measurement.
- Align (responsive)
See the Related Articles below for a description of how the alignment toggle settings work.
- Padding (responsive)
Set a specific padding value in pixels. Click the Link icon to automatically make all four padding values the same.
2 Text section
- Text color
Set the button text color in the resting state.
- Text hover color
Set the button color on hover. If this setting is left blank, the Text color setting applies for hover also.
- Typography section
See the Related Article below on the Typography section settings.
3 Background section
- Background color
Set the fill color for the button in the resting state.
- Background hover color
Set the button's fill color on hover. If this setting is left blank, the Background color setting applies to hover also.
- Background style
Flat: consistent fill color
Gradient: gradient of the background color, lighter on top and darker on the bottom.
- Background animation
Disabled by default. If set to Enabled, there's a 0.2-second linear transition from resting state to hover state.
4 Border section
See the Related Article below for more information about the settings in the Border section.
There are all the usual Advanced tab settings for margins, visibility, animations, and advanced HTML settings.
Other modules that include a button:
- Callout module
This module includes a heading, optional text, optional image (photo or icon), and optional button or link text. The link you provide works with any part of the Callout module, not just the button.
- Call to Action module
This module includes a heading, optional text, and a button. The link you provide works with any part of the Call to Action module, not just the button.
- Contact Form module
Special settings to set up a contact form, with a button to submit the form.
- Subscribe Form module
Special settings to set up a connection to any of a number of mail service providers, creating a form to subscribe with a button to submit the form.
Tip: You can configure a Gallery module to open its component images in a lightbox with the addition of some code. See the Related Article below.