Home>Widgets Bundle>Button Grid

Button Grid

Add multiple buttons in one go, customize individually, and present them in a neat grid layout.


To make use of this widget, go to PluginsSiteOrigin Widgets to activate the SiteOrigin Button Grid Widget.

The Button Grid Widget is ready to be used anywhere:

Page Builder: Insert widgets in Page Builder by SiteOrigin in either the Classic Editor or Page Builder Layout Block in the Block Editor.
Block Editor: 100% Block Editor compatible. Insert widgets using the SiteOrigin Widgets Block featuring a live widget search form.
Theme and Plugin Widget Areas: Insert widgets into any theme or plugin widget area.



Click Add to insert your first button. The following settings are available per button:

Button Text:
Enter the text that’ll be displayed in the button.

Destination URL:
Enter the button link. Use the Select Content button on the right to select a page or post in your WordPress installation.

Open in a new window:
Enable to open the button link in a new window.

The Destination URL will be downloaded when a user clicks on the button.

Next, you’ll see three sections; each contains a list of settings:

  • Icon
  • Design and Layout
  • Other attributes and SEO


Visually select an icon from several different icon libraries.

Icon Color
Set the selected icon’s color.

Image Icon
Replaces the icon with your own image icon. Use the Choose Media button to choose an image from your WordPress media library or click the Image Search button to search for royalty-free images on Pixabay.

Icon Placement
Choose between Top, Right, Left, or Bottom.

Design and Layout

Leave blank to let the button resize according to content. Alternatively, insert a width value. Use the drop-down field next to the width field to select a unit of measurement. The default unit is pixels (px).

Align the entire button on the page. Defaults to Center. Choose between Left, Right, Center, or Justify.

Mobile Align
Set the button alignment on mobile devices. Defaults to Center.

Button Theme
Select a button theme. Choose between Atom, Flat or Wire. Atom has a rounded effect which Flat removes. Wire removes the background color and only uses a border.

Button Color
Select the button background color.

Text Color
Select the button text color.

Use Hover Effects
For the Atom and Flat themes, hover effects will lighten the background slightly, for the Wire theme, the background will be added on hover.

Hover Background Color
Select the button hover background color.

Hover Text Color
Select the button hover text color.

Select the button font family.

Font Size
Set the button font size. Defaults to 1em.

Padding is the distance between the text and the edge of the button. Defaults to 1em.

Set the button rounding. Defaults to 0.25em for the top, right, bottom, and left corners.

Other Attributes and SEO

This section contains optional fields that some users will find useful.

Button ID
An ID attribute allows you to target this button in JavaScript.

Button Classes
Additional CSS classes added to the button link.

Title Attribute
Adds a title attribute to the button link.

Run this JavaScript when the button is clicked—ideal for tracking.

Rel Attribute
Adds a rel attribute to the button link.


Button Grid layout settings are separated into a Desktop and Mobile section. The mobile breakpoint can be adjusted from PluginsSiteOrigin WidgetsButton Grid: SettingsResponsive Breakpoint.


Buttons Per Line
Enter the number of buttons to be displayed per line.

Button Alignment
Select the button alignment within the grid. Choose between Left, Center, or Right.

Enter the Row and Column gap. Defaults to 20px.


Buttons Per Line
Enter the number of buttons to be displayed per line on mobile.

Button Alignment
Select the button alignment within the grid on mobile. Choose between Left, Center, or Right.

Enter the Row and Column gap on mobile. Defaults to 20px.

Get The Most Out of SiteOrigin with SiteOrigin Premium

Find Out More