Skip to main contenteBay Playbook
  • Get started
  • Foundations
  • Design system
  • Expressions
  • Resources
  • Articles

Design system

  • Overview
    • Design system definitions
    • Overview
    • Theming
    • Color
    • Dimension
    • Spacing
    • Typography
    • Breakpoints
    • Shadow
    • Shape
    • Opacity
    • Motion
    • Overview
    • Status
    • Accordion
    • Action bar
      • Overview
      • Inline notice
      • Page notice
      • Section notice
    • Avatar
    • Badge
    • Banner
    • Breadcrumb
      • Overview
      • CTA button
      • Icon button
      • Link button
    • Calendar
    • Card
    • Carousel
    • CCD
      • Overview
      • Filter chip
      • Input chip
      • Graphs
      • Metrics
      • Overview
      • Alert
      • Confirmation
      • Standard
    • Divider
    • Education notice
    • EEK rating and range
    • Expansion
      • Overview
      • Checkbox
      • Combobox
      • Date field
      • Dropdown
      • Numeric stepper
      • Password
      • Phone number
      • Radio button
      • Select list
      • Switch
      • Text area
      • Text field
    • Item tile
    • List row
      • Overview
      • Expressive loader
      • Skeleton loader
    • Media container
      • Top navigation bar
    • Pagination
    • Panel
    • Popover
    • Progress stepper
    • Search field
    • Section header
    • Segmented button
      • Overview
      • Context sheet
      • Focus sheet
    • Signal
    • Snackbar
    • State layer
    • Tab
    • Table
      • Overview
      • Tooltip
      • Tourtip
    • Toggle button group
    • Video player
    • Overview
    • Bulk editing
    • Empty states
    • Filtering
    • Uploading files
      • Overview
      • Text link

Card

v1.0

Cards display a distinct collection of content and actions in a flexible container.

Cardv1.0

On this page

  • Considerations
  • Anatomy
  • Properties
  • Common elements
  • Behavior
  • Screen size
  • Best practices
  • Specs

Anatomy

Properties

Common elements

Behavior

Screen size

Best practices

Specs

PreviousCalendar
Things.People.Love.
  • Get started
  • Foundations
  • Design system
  • Expressions
  • Resources
  • Articles
  • About eBay Design
  • Careers
  • Press
  • Privacy policy
© 2026 eBay. All rights reserved.

eBay Evo, the eBay trademark, and the eBay logo are the intellectual property of eBay Inc.

    Container

    The card container bounds all of the card’s content and manages its state. It can flex according to the amount of content inside the card and the space available in the surrounding UI.

    The card container is the only required element of a card. However, follow the standard placement of preview images, content areas, and actions.

    Style

    Cards are available as either filled or outlined. Choose a style that fits best in the page hierarchy. Outlined cards are generally more pronounced while filled cards are subtler.

    Filled cards use a light gray background to denote the card’s boundary. They generally work best on primary page backgrounds and in more relaxed page layouts.

    Outlined cards have a distinct border and white background. They generally work across various page backgrounds and in denser page layouts.

    Orientation

    Card contents can be oriented vertically or horizontally.

    For vertical cards, the preview image, content area, and footer all flex to fill the available space. The preview media can be square, 16:9, or 5:4. The default ratio is 5:4.

    For horizontal cards, the content area flexes to fill the available space, while the preview image maintains a fixed square ratio.

    Overline

    Optional. An overline provides context that helps users quickly understand the category, promotion, or program before reading the headline. Overlines are shown on every screen size.

    Overlines will appear above the headline and can also support a custom SVG. It can incorporate partner logos when relevant.

    • Use sentence case
    • No ending punctuation
    • Max character count: 33

    Headline

    Required. A strong headline leads with user benefit and uses bold, active language. Headlines are shown on every screen size.

    • Use sentence case
    • No ending punctuation
    • Max character count: 22

    Body copy

    Required. Body copy should expand on the headline with specific user-focused value. Body copy is shown on every screen size.

    • Use sentence case
    • Use conversational language
    • Max character count: 64 (2 lines)

    Action (Button label)

    A strong action uses verbs to make the next step and outcome immediately clear.

    • Use sentence case
    • No ending punctuation
    • Use a [verb] [noun] or [verb] [article] [noun] pattern
    • Max character count: 20

    Preview image

    Cards can have a preview image to enhance the visual impact of the card. Previews are aligned at the top of vertical cards and can be square, 16:9, or 5:4. The default ratio is 5:4

    Preview images in horizontal cards are square and aligned to the leading edge of the card.

    Content area

    The card content area contains the primary details and purpose of the card. This includes a title, subtitle, description, or overline. The content area can also include leading and trailing accessories, like avatars and buttons.

    Footer

    Cards can have a footer that holds buttons and other metadata related to the card content.

    Interactivity

    Cards are directly interactive or not. The entire card is interactive if no additional buttons are present. Otherwise, only the nested buttons are interactive.

    States

    Directly interactive cards use a state layer to indicate hovered, pressed, and focused states.

    Content overflow

    In uniform grid or carousel layouts, cards have fixed heights and truncate content that exceeds the following limits:

    • Body copy truncates at 3 lines (~96 characters)
    • Titles truncate at 1 line (~33 characters) 

    Translated content often runs longer than the source, so allow for text expansion when adapting cards for other languages.

    In masonry or mosaic layouts, cards have flexible heights and wrap titles and body copy to fit all content by default.

    Width

    Vertical cards have a minimum width of 200px and a maximum width of 400px.

    Horizontal cards have a min width of 300px and max with of 800px.

    Responsiveness

    To allow for a more readable experience on smaller screens, an inline card will shift to a stacked layout on screens below 360px wide.

    Small screens

    Cards on small screens can be standalone and extend the width of the grid. Cards within a carousel include one visible card and a peek of the second card.

    Medium & large screens

    Cards fill their container up to their maximum width. Cards in a grid will expand in width between their minimum and maximum width, wrapping to a new row as space allows.

    Consistency

    Do keep card heights and styles consistent when grouped in a carousel or grid.

    Don’t mix card styles when grouped in a carousel or grid.

    Cards vs cells

    Do use cards to display grouped content about a specific subject or theme.

    Don’t force content into cards when a simple list or whitespace and typography would create better hierarchy.

    Border color

    Do use “borderSubtle” when using the outlined card.

    Don’t change the border color when using the outlined card.

    A card container with an inner section showing that it is a slot component. The inner section has an instruction that says “Use a preset option or swap with local component.”
    Two cards, both in a vertical layout with an image of two people playing basketball followed by “Title”, “Subtitle”, and a primary CTA button labeled “Label”. The first card has a light grey background. The second card has a light grey border.
    2 card examples. The first card is in a vertical layout with the media area on top followed by the title, subtitle and lastly the footer action. The Second card is in a horizontal layout with the image on the left and the content area to the right, the content area is stacked top down with the title, subtile and footer.
    A vertical card with a light grey background and image on top. An annotation points to the overline which has a sneaker icon and the copy “sneakers”.
    A vertical card with a light grey background and image on top. An annotation points to the title. The copy reads “runners essentials”.
    A vertical card with a light grey background and image on top. An annotation points to the body. The copy reads “upgrade your run with essential running shoes, breathable apparel, and performance-driven accessories”.
    A vertical card with a light grey background and image on top. An annotation points to the action. The copy reads “shop now”.
    2 card layouts, the first is vertical and the second is horizontal. The card has a promotional image and below the image, text reads: 'Collect like a pro. View and manage your entire portfolio, list at lightning speed, and add to your collection with ease.' The same image and text appear again in a smaller, horizontally-aligned layout.
    A vertical card with a light grey background. The content includes a photo of runners, an overline with a sneaker icon labeled “Sneakers”, a title labeled “Runners essentials”, body copy, and a secondary CTA labeled “Shop now”.
    Two vertical cards, both in a vertical layout with an image of three people on a green background followed by a title labeled “Fuel your fashion inspiration”,  and body copy. The first card has a primary CTA labeled “Explore now”. The second card have an icon button on the right side with a right pointing arrow.
    Two vertical cards, both in a vertical layout with an image of four people holding bags followed by a title labeled “Luxury bags”,  and body copy. The first has a blue outline signaling the entire card is clickable. The second has a secondary CTA with a blue outline.
    A phone screen titled “Selling” with a vertical card with a light grey background. The card has a photo of two people taking a photo of a jacket, a title labeled “How to take great photos”, body copy, and a primary CTA button labeled “See photo guide”. Below is a section labeled “Drafts (3)” with two images.
    Two vertical cards with specs. The first is small with a label of 200 width. The second is large with a label of 400 width.
    Two horizontal cards with specs. The first is small with a label of 300 width. The second is large with a label of 800 width.
    A vertical and horizontal card.
    A phone screen with body copy, tabs labeled “Store”, “About”, and “Feedback”, a section labeled “Guides & articles”, and two cards with one view cut off in a carousel.
    A small desktop screen of an eBay storefront labeled “Fresh kicks”, body copy,  tabs labeled “Store”, “About”, and “Feedback”, a section labeled “Guides & articles”, and two cards with one view cut off in a carousel.
    A phone screen with a search bar and shopping cart icon. Below is a carousel titled “Collections for you” and a CTA titled “See all” with one full card with an image of tools titled “DIY starter kit”, subtitled “124 items”. To the right is a partially viewable card. Both have a filled light grey background.
    A phone screen with a search bar and shopping cart icon. Below is a carousel titled “Collections for you” and a CTA titled “See all” with one full card with an image of tools titled “DIY starter kit”, subtitled “124 items”. To the right is a partially viewable card. The full card has a light grey background, the second card has a white background with a border.
    A phone screen with a search bar and shopping cart icon. Below is a carousel titled “DIY like a pro” and a CTA titled “See all” with one full card with an illustration and copy and a partially viewable card.
    A phone screen with two CTAs titled “Make an offer” and “Add to cart”. Below is a carousel with cards. Both have an icon and copy.
    An outlined card with with a white background and border token color “Border/Subtle”.
    An outlined card with with a white background and border token color “Border/Accent”.
    A card with specs highlighted. The corner radius of the image is 16px and the corner radius of the card is 24px. The padding around the edge is 12px.
    A horizontal card with specs highlighted. The corner radius of the image is 16px and the corner radius of the card is 24px. The padding around the edge is 12px.

    Considerations

    Contained

    Each card is a standalone object, even within a card group. The actions and information within one card is distinct from others.

    Summarized

    A card focuses on high-level details to inform users of the card’s purpose and aid in deciding whether to interact with more content.

    Interactive

    Cards are implicitly interactive by nature whether they have nested buttons or not. They are never static or decorative.

    A card component example with various aspects called out using pointers. Number 1 points to the card container. Number 2 points to the media area with an illustration of auto parts. Number 3 points to an over line option that says “Installation”. Number  4 point to the title that says, “Find parts with installation”. Number 5 points to a Subtitle that says “Let AI do the work for you when it comes to finding the right parts and installation.”  Number 6 points to a CTA button that is labeled “Try it now”.
    1. Container
    2. Media
    3. Overline
    4. Title
    5. Body
    6. Actions
    • CSS
    • Marko
    • React