Skip to Content
DocumentationBlocksButton

Button Block

Use Button for standalone calls to action inside containers, editorial sections, campaign layouts, and reusable content groups.

Setup Order

  1. Write the labelUse a short action label that tells customers what happens next, such as Shop new arrivals, View size guide, or Contact us.
  2. Add the linkChoose the destination and enable new-tab behavior only when leaving the store or opening a supporting resource.
  3. Choose a button tierUse primary for the main action, secondary for supporting actions, and alternative for intentional campaign styling.
  4. Use custom style only when neededCustomize typography, colors, border, hover states, and width when the global button tiers do not fit the local design need.
  5. Preview long labelsCheck the longest expected label on mobile before publishing.

Key Settings

Setting groupWhat it controls
LabelVisible button text.
LinkDestination and optional new-tab behavior.
StylePrimary, secondary, alternative, or custom styling.
Custom typographyFont, size, case, weight, decoration, and letter spacing.
Custom colorsText, background, transparency, blur, border, and hover colors.
Custom borderBorder thickness and radius.
WidthDesktop and mobile fit or custom width.

Button Tier Guidance

TierUse
PrimaryThe main action in the current section or content group.
SecondaryA supporting action that should remain quieter than the primary action.
AlternativeA deliberate campaign or section-specific style defined in global settings.
CustomA one-off style where local typography, color, border, hover, or width must differ from global tiers.

QA Checklist

StateWhat to confirm
Missing linkThe button is not published as a dead action.
Long labelText fits on mobile without crowding or overflow.
Custom colorsNormal, hover, and focus states remain readable.
New-tab behaviorNew-tab opening is intentional for the destination.
Multiple buttonsPrimary and secondary actions have a clear hierarchy.