Skip to main content
Documentation/Elements & Controls Reference/Elements/Basics/Button

Button

Button displays a styled link or link action. Use it for a clear next step, such as viewing a service or opening a contact page.

Add and configure Button

  1. Click Add, choose Button, and place it in the container.
  2. Set Content > Content > Text and Link.
  3. Choose Design > Button > Style and configure the settings shown for that style.
  4. Adjust the button's size, typography, icon, effects, and spacing as needed.
  5. Save your changes.
Button controls in the Breakdance editor
Button controls in the Breakdance editor

This element has no children; use its own controls.

Controls

Responsive varies by breakpoint; Hover has a hover value; Shared applies across both. Linked controls have their own reference. In conditions, = means “is” and ≠ means “is not.”

Content > Content

Setting Purpose and options Behavior
Text Visible text. Shared
Link Destination and link options. Shared

Design > Button

Setting Purpose and options Behavior
Style Primary, Secondary, Custom, Text. Shared

Shown when Style = Text.

Setting Purpose and options Behavior
Text > Typography typography controls. See linked controls
Text > Padding spacing controls. See linked controls
Text > Fancy Underline Style 1, Style 2, Style 3, Style 4, Style 5, Style 6, Style 7, Style 8. Shared
Text > Underline Color Color or supported fill. Hover
Text > Arrow > Arrow Arrow 1, Arrow 2, Arrow 3, Custom. Shared
Setting Purpose and options Behavior
Text > Arrow > Custom Arrow Icon. When: Style = Text and Arrow = Custom. Shared
Text > Arrow > Space Before Space before and unit. When: Style = Text. Shared
Text > Arrow > Hover Transform Hover transform and unit. When: Style = Text and Arrow ≠ Arrow 3. Shared
Text > Arrow > Arrow Size Arrow size and unit. When: Style = Text. Shared
Custom Type Custom, Preset. When: Style = Custom. Shared
Custom > Size > Size Custom, Small, Default, Large. When: Style = Custom and Custom Type = Custom or Style = Custom and Custom Type is unset. Responsive
Custom > Size > Padding Padding. When: Style = Custom and Custom Type = Custom or Style = Custom and Custom Type is unset and Size = Custom. Responsive

Shown when Style = Custom and Custom Type = Custom or Style = Custom and Custom Type is unset.

Setting Purpose and options Behavior
Custom > Size > Override Width Override width and unit. Shared
Custom > Size > Full Width At Breakpoint. Shared
Custom > Background Color or supported fill. Hover
Custom > Outline On/off. Shared

Shown when Style = Custom and Custom Type = Custom or Style = Custom and Custom Type is unset and Outline is set.

Setting Purpose and options Behavior
Custom > Color Color or supported fill. Hover
Custom > Width Width. Shared
Custom > No Fill On Hover On/off. Shared
Setting Purpose and options Behavior
Custom > Typography typography controls. When: Style = Custom and Custom Type = Custom or Style = Custom and Custom Type is unset. See linked controls
Custom > Corners Square, Round, Custom. When: Style = Custom and Custom Type = Custom or Style = Custom and Custom Type is unset. Shared
Custom > Corner Radius Corner radius and unit. When: Style = Custom and Custom Type = Custom or Style = Custom and Custom Type is unset and Corners = Custom. Responsive

Shown when Style = Custom and Custom Type = Custom or Style = Custom and Custom Type is unset.

Setting Purpose and options Behavior
Custom > Icon > Icon Icon. Shared
Custom > Icon > Position Before, After. Shared
Custom > Icon > Size Size and unit. Responsive
Custom > Icon > Color Color or supported fill. Hover
Custom > Icon > Space Before Space before and unit. Responsive
Custom > Icon > Space After Space after and unit. Responsive
Custom > Icon > Hover Transform Hover transform and unit. Shared
Custom > Effects > Transition Duration Transition duration. Responsive
Custom > Effects > Scale On Hover Set scale on hover. Range: 0–3. Responsive
Custom > Effects > Shadow Shadow offset, blur, spread, color. Responsive, Hover
Setting Purpose and options Behavior
Preset Set preset. When: Style = Custom and Custom Type = Preset. Shared

Design > Lightbox

Setting Purpose and options Behavior
Lightbox lightbox controls. See linked controls

Design > Spacing

Setting Purpose and options Behavior
Spacing spacing controls. See linked controls

Troubleshooting

The custom button controls are hidden

Check Style. Text-style, preset, and custom-button choices expose different design settings.

The button does not fit the mobile layout

Check its width, padding, and Full Width At settings together with the parent container's width.