Skip to main content

Button - Migrated Version

The Button component is designed to attract the attention of a user and encourage them to take action. This action can take many forms, such as navigating to another page or submitting a form. 

How it Works

The author can insert a button on a page to allow the site user to complete an action. The button's functionality and style are easy to configure through the dialog box.

There are several style options for the author to choose from to change the look of the button.  These options can be configured through the style system icon (displays as paintbrush) of the component.

How to Use

The author can configure the functionality of the Button component by editing the following properties in the dialog box:


This field should include the text to display on the button.

This field should contain the link that the button takes the user to. This could be a content page within AEM, an external resource, or an anchor.  Use the Selection Dialog to choose a path within AEM.

This field hould include the icon you wish to display on the button. Please note that this field can be left blank.

This option allows control of the unique identifier of the component in the HTML and in the Data Layer.  If left blank, a unique ID is automatically generated for you and can be found by inspecting the resulting page.  If an ID is specified, it is the responsibility of the author to make sure that it is unique.  Changing the ID can have an impact on CSS, JS, and Data Layer tracking.

Accessibility Tab

On the Accessibility tab, values can be set for ARIA accessibility labels for the component.

  • Label - Value of an ARIA label attribute for the component

Button Style Variations


There are three style options that control how a button looks.  The first is the Button's theme.  There are two theme options - Dark and Light.  Examples of each are shown below.

Dark themed buttons have White Title Case text and live in your agency's chosen theme color rectangle. On this page, it is shown in Water Blue. Similarly, the dark themed links appear with dark text.

  • The Dark themed button or link option should be used when the page is white or light so that it stands out against the background.
  • The Hover State for the Primary Button • Dark Theme has a Water Blue Light bacgkround. 
Light themed buttons have Slate Gray Dark text and live in a White rectangle.  Similarly, the light themed links have white text.
  • The Light themed button or link option should be used when the page is dark so that it stands out against the background.
  • The Hover State for the Primary Button • Light Theme as a Pebble Gray background.


The second option is the Button's type.  The Button component types are Primary and Secondary. Examples of each are shown below.

The Primary button type is composed of text within a rectangle.

The secondary button is similar in structure with the addition of an icon which is placed to the left of the text.


The final option is the Button's variation.  A Button component can be a button which is a rectangle with text inside or a link which is where the text appears without a rectangle behind it  Examples of each are shown below.

Last Modified on Nov 18, 2020
Back to Top