Branded button

v3.1.0

Branded buttons tie eBay’s CTA to our marketing palette.

Considerations

Use sparingly

Branded buttons provide an extended palette for greater expression, but overuse can affect their prominence over time. Use branded buttons sparingly.

Theming

Branded buttons help maintain a cohesive theme to marketing placements using the broader marketing color palette.

Standard placement

Branded buttons are always paired with a marketing statement within a banner or card. They don’t appear alone and are rarely used in button groups.

Anatomy

A button’s anatomy. Number 1 is pointing to the title element. Number 2 is pointing to the container.
  1. Title
  2. Container

Properties

Title

Titles are short and sweet with a max character count of 20. Keep the title related to what the action will do.

A red banner containing a branded button in it’s theme with the title “Shop now”.

Color

Branded buttons inherit the expressive theme of their parent container. Learn more about using color within banners on the Banner component page and in Using color in marketing.

Two colored banners in violet and indigo. The branded buttons match each color theme.

Behavior

Width

In contrast to CTA buttons, branded buttons always hug their content. They don’t fill the width of their parent container.

Three buttons with different lengths of text all with the button hugging the text.

Minimum width

The minimum width for basic and destructive buttons is 2x the height of the button.

A medium button with a pink spec detailing it’s at its minimum suggested width of its height multiplied by 2.

Maximum width

The maximum width for buttons is 10x the height of the button.
While a wide button is possible, it is also rare. Expect to keep the button width to the size of it’s contents since there should be no more than 20 characters within.

A large and a small button with pink specs detailing they are at their maximum width of their height multiplied by 10.

Height

Branded buttons use the medium button size across branded contexts.

A medium-sized button with the description “Medium” to the side.

Text overflow

Titles that extend beyond the width of the button container will wrap to a new line to ensure the title remains visible for all languages.

A button title in German wrapping to a second line due to the button being too narrow for the title to fit on a single line.

State

Buttons use state layers for states. The available states are enabled, hover, pressed, and focused. The focused state outline should match the button’s color theme. Learn more about the state layer color values in Color tokens.

Four buttons detailing interaction states. From left to right is enabled, hover, pressed, and focused.

Best practices

Button color

Use the proper pre-selected foreground, background, and button color for the selected theme.

A banner using the violet color theme.

Don’t deviate from the pre-selected color palettes.

A banner using the violet theme, but with an out of place coral button.

Icons

Branded buttons are meant to clearly tie into our marketing campaigns. Icons are not currently recommended.

A slim banner using the yellow color theme. The button contains the text “Beat the buzzer”.

Icons are not supported within branded buttons. Refrain from using icons to avoid assigning arbitrary meaning to our iconography sets.

A slim banner using the yellow color theme. The button contains the text “Beat the buzzer” with a lightning bolt as the leading icon.

Button titles

Work closely with your content and marketing partners to deliver button titles that use an “Verb + noun” structure that is less than 20 characters.

A banner using the indigo theme. The button text is succinct with “Show me the deals”.

Don’t use ambiguous titles that make understanding the action being taken difficult or misleading. Don’t use more than 20 characters.

A banner using the indigo theme. The button text is long with “Get all of the best bargains now”.

Themes

Don’t mix colors from different themes.

A banner using the violet color theme with a branded button using the yellow color theme.

Don’t create your own color combinations.

A banner using grayish-blue color theme that is not found in the system.

Specs

Measurements of each button size and its contents.
Large buttons are 48px tall with 24px of horizontal padding.
Medium buttons are 40px tall with 20px of horizontal padding.
Small buttons are 32px tall with 16px of horizontal padding.
Title character range is a maximum of 20 for US-based text.

Change log

VersionDateNotes
3.1.0
Jun, 2024
  • Updated to eBay Evo
3.1.0
Mar, 2023
  • Updated “borderless” value to “text”
  • Converted Standalone Link component into Link button
  • Renamed “role” property into “type”
3.0.0
Dec, 2022
  • Added state-layer component to handle state logic
  • Removed hover and pressed state from button component after adding state-layer
  • Added borderless button variant
  • Staged update for split button (currently testing)
  • Cleaned up component property and value labels
  • Renamed “label” layer to “title”
  • Renamed “icon” layer to “leading-icon”
2.0.0
Jun, 2022
  • Updated to use new component properties feature
  • Updated tertiary button style to improve contrast and accessibility
  • Added 32px size for use in components
  • Updated 40px size label to md
  • Added 48px size icon button to match other buttons
  • Combined destructive and default buttons together as a “role” property
  • Updated interactive states to use new state-layer logic
1.6.0
Aug, 2021
  • Added B5 for hover states
  • Added R5 and R6 for destructive button hover and active states
  • Updated button component architecture to use variants
  • Added tertiary button option
  • Added icon button
  • Added destructive button with all hierarchy levels