Call to action
On this page
Guidelines
Use a call to action to entice users to make a selection.
When to use a call to action
Use a call to action to highlight a link on its own so it stands out to users. Most of the time, calls to action are arranged last in a group of elements so users can read about something first and then proceed further if they are interested.
Call to action vs. button
Here is guidance on when to use a call to action vs. button.
Element | Intended action | Frequency |
---|---|---|
Call to action | Direct users to another page when selected | Always |
Button | Perform an action when selected | Depending on the action, users may or may not be directed to another page as the result of the action |
Using styles or variants
Some calls to action can be used more than once per page depending on their messaging and placement.
Style or variant | How to use |
---|---|
Primary | Try to use only once per page for the most important link |
Secondary | Use several times on the same page for important links |
Tertiary | Use several times on the same page for less important links |
Brick | Use to group several links together in a grid |
Video | Use to trigger a video within a dialog |
Desaturated | Use only in the dark scheme if other styles are duplicative or violate accessibility guidelines |
Bricks
UI icons can be used in the Brick variant to add visual interest to various topics.
Writing content
General text
When writing text, be specific and communicate the action you want users to take by doing the following:
- Make sure text is unique and easily understood especially when screen readers announce text to users
- Always start with a verb, do not use more than 1 verb
- Use simple words and phrases
- Keep word counts as short as possible, delete words if needed
- Do not use any punctuation
- Do not add extra icons
- Be aware that text might get longer when translated to certain languages
Clarity of language
Generic or vague text does not help users make informed decisions.
Long text
Most users do not want to spend more time reading than necessary, so keep text as short as possible.
Behavior
Placement
Calls to action can be placed in just about any layout or interface. For normal environments, using any style is acceptable. For small environments, use the Tertiary style.
Hierarchy
Calls to action follow a hierarchy with the Primary style being the most important.
Bricks
Brick variants are the only calls to action that can resize to fit various column arrangements. However, the width of other styles and variants is determined by what content is inside.
Grouping
Calls to action are grouped by hierarchy with the Primary style always being first.
Space when grouped
If calls to action need to be grouped, spacing between them should use the --rh-space-2xl
token.
Spacing between Brick variants is flexible and should be the same as grid gutters.
Responsive design
Calls to action are arranged horizontally in 1 row by default. As viewports get smaller, they will stack.
Best practices
Using the primary style
Use the Primary style to indicate the most important action.
Do not use the Primary style more than once in the same area.
Grouping
Use a combination of Primary and Secondary styles.
Do not mix more than 2 styles together.
Number of actions
Use 3 calls to action max, this helps avoid choice paralysis.
Do not use more than 3 calls to action in the same area.
Other libraries
To learn more about our other libraries, visit this page.
Feedback
To give feedback about anything on this page, contact us.