---
title: Cards
description: Bootstrap’s cards provide a flexible and extensible content container with multiple variants and options.
toc: true
---

import { getData } from '@libs/data'

## About

A **card** is a flexible and extensible content container. It includes options for headers and footers, a wide variety of content, contextual background colors, and powerful display options. If you’re familiar with Bootstrap 3, cards replace our old panels, wells, and thumbnails. Similar functionality to those components is available as modifier classes for cards.

## Example

Cards are built with as little markup and styles as possible, but still manage to deliver a ton of control and customization. Built with flexbox, they offer easy alignment and mix well with other Bootstrap components. They have no `margin` by default, so use [spacing utilities]([[docsref:/utilities/spacing]]) as needed.

Below is an example of a basic card with mixed content and a fixed width. Cards have no fixed width to start, so they’ll naturally fill the full width of its parent element. This is easily customized with our various [sizing options](#sizing).

<Example code={`
    <Placeholder width="100%" height="180" class="card-img-top" text="Image cap" />

Card title
      
Some quick example text to build on the card title and make up the bulk of the card’s content.
      Go somewhere

`} />

## Content types

Cards support a wide variety of content, including images, text, list groups, links, and more. Below are examples of what’s supported.

### Body

The building block of a card is the `.card-body`. Use it whenever you need a padded section within a card.

<Example code={`
    
      This is some text within a card body.

`} />

### Titles, text, and links

Card titles are used by adding `.card-title` to a `<h*>` tag. In the same way, links are added and placed next to each other by adding `.card-link` to an `<a>` tag.

Subtitles are used by adding a `.card-subtitle` to a `<h*>` tag. If the `.card-title` and the `.card-subtitle` items are placed in a `.card-body` item, the card title and subtitle are aligned nicely.

<Example code={`

Card title
      
Card subtitle
      
Some quick example text to build on the card title and make up the bulk of the card’s content.
      Card link
      Another link

`} />

### Images

`.card-img-top` and `.card-img-bottom` respectively set the top and bottom corners rounded to match the card’s borders. With `.card-text`, text can be added to the card. Text within `.card-text` can also be styled with the standard HTML tags.

<Example code={`
    <Placeholder width="100%" height="180" class="card-img-top" text="Image cap" />

Some quick example text to build on the card title and make up the bulk of the card’s content.

`} />

### List groups

Create lists of content in a card with a flush list group.

<Example code={`

- An item
      
- A second item
      
- A third item

`} />

<Example code={`
    
      Featured

- An item
      
- A second item
      
- A third item

`} />

<Example code={`

- An item
      
- A second item
      
- A third item

      Card footer

`} />

### Kitchen sink

Mix and match multiple content types to create the card you need, or throw everything in there. Shown below are image styles, blocks, text styles, and a list group—all wrapped in a fixed-width card.

<Example code={`
    <Placeholder width="100%" height="180" class="card-img-top" text="Image cap" />

Card title
      
Some quick example text to build on the card title and make up the bulk of the card’s content.

- An item
      
- A second item
      
- A third item

      Card link
      Another link

`} />

### Header and footer

Add an optional header and/or footer within a card.

<Example code={`
    
      Featured

Special title treatment
      
With supporting text below as a natural lead-in to additional content.
      Go somewhere

`} />

Card headers can be styled by adding `.card-header` to `<h*>` elements.

<Example code={`
    
Featured

Special title treatment
      
With supporting text below as a natural lead-in to additional content.
      Go somewhere

`} />

<Example code={`
    
      Quote

A well-known quote, contained in a blockquote element.

          Someone famous in Source Title

`} />

<Example code={`
    
      Featured

Special title treatment
      
With supporting text below as a natural lead-in to additional content.
      Go somewhere

      2 days ago

`} />

## Sizing

Cards assume no specific `width` to start, so they’ll be 100% wide unless otherwise stated. You can change this as needed with custom CSS, grid classes, grid Sass mixins, or utilities.

### Using grid markup

Using the grid, wrap cards in columns and rows as needed.

<Example code={`

Special title treatment
          
With supporting text below as a natural lead-in to additional content.
          Go somewhere

Special title treatment
          
With supporting text below as a natural lead-in to additional content.
          Go somewhere

`} />

### Using utilities

Use our handful of [available sizing utilities]([[docsref:/utilities/sizing]]) to quickly set a card’s width.

<Example code={`

Card title
      
With supporting text below as a natural lead-in to additional content.
      Button

Card title
      
With supporting text below as a natural lead-in to additional content.
      Button

`} />

### Using custom CSS

Use custom CSS in your stylesheets or as inline styles to set a width.

<Example code={`

Special title treatment
      
With supporting text below as a natural lead-in to additional content.
      Go somewhere

`} />

## Text alignment

You can quickly change the text alignment of any card—in its entirety or specific parts—with our [text align classes]([[docsref:/utilities/text#text-alignment]]).

<Example code={`

Special title treatment
      
With supporting text below as a natural lead-in to additional content.
      Go somewhere

Special title treatment
      
With supporting text below as a natural lead-in to additional content.
      Go somewhere

Special title treatment
      
With supporting text below as a natural lead-in to additional content.
      Go somewhere

`} />

## Navigation

Add some navigation to a card’s header (or block) with Bootstrap’s [nav components]([[docsref:/components/navs-tabs]]).

<Example code={`

-           Active

-           Link

-           Disabled

Special title treatment
      
With supporting text below as a natural lead-in to additional content.
      Go somewhere

`} />

<Example code={`

-           Active

-           Link

-           Disabled

Special title treatment
      
With supporting text below as a natural lead-in to additional content.
      Go somewhere

`} />

## Images

Cards include a few options for working with images. Choose from appending “image caps” at either end of a card, overlaying images with card content, or simply embedding the image in a card.

### Image caps

Similar to headers and footers, cards can include top and bottom “image caps”—images at the top or bottom of a card.

<Example code={`
    <Placeholder width="100%" height="180" class="card-img-top" text="Image cap" />

Card title
      
This is a wider card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.
      
Last updated 3 mins ago

Card title
      
This is a wider card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.
      
Last updated 3 mins ago
    
    <Placeholder width="100%" height="180" class="card-img-bottom" text="Image cap" />
  
`} />

### Image overlays

Turn an image into a card background and overlay your card’s text. Depending on the image, you may or may not need additional styles or utilities.

<Example code={`
    <Placeholder width="100%" height="270" class="bd-placeholder-img-lg card-img" text="Card image" />

Card title
      
This is a wider card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.
      
Last updated 3 mins ago

`} />

<Callout>
Note that content should not be larger than the height of the image. If content is larger than the image the content will be displayed outside the image.
</Callout>

## Horizontal

Using a combination of grid and utility classes, cards can be made horizontal in a mobile-friendly and responsive way. In the example below, we remove the grid gutters with `.g-0` and use `.col-md-*` classes to make the card horizontal at the `md` breakpoint. Further adjustments may be needed depending on your card content.

<Example code={`

        <Placeholder width="100%" height="250" text="Image" class="img-fluid rounded-start" />

Card title
          
This is a wider card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.
          
Last updated 3 mins ago

`} />

## Card styles

Cards include various options for customizing their backgrounds, borders, and color.

### Background and color

<AddedIn version="5.2.0" />

Set a `background-color` with contrasting foreground `color` with [our `.text-bg-{color}` helpers]([[docsref:helpers/color-background]]). Previously it was required to manually pair your choice of [`.text-{color}`]([[docsref:/utilities/colors]]) and [`.bg-{color}`]([[docsref:/utilities/background]]) utilities for styling, which you still may use if you prefer.

<Example code={getData('theme-colors').map((themeColor) => `
    
Header

${themeColor.title} card title
      
Some quick example text to build on the card title and make up the bulk of the card’s content.

`)} />

<Callout name="warning-color-assistive-technologies" />

### Border

Use [border utilities]([[docsref:/utilities/borders]]) to change just the `border-color` of a card. Note that you can put `.text-{color}` classes on the parent `.card` or a subset of the card’s contents as shown below.

<Example code={getData('theme-colors').map((themeColor) => `
    
Header
    <div class="card-body${themeColor.contrast_color ? '' : ` text-${themeColor.name}`}">
      
${themeColor.title} card title
      
Some quick example text to build on the card title and make up the bulk of the card’s content.

`)} />

### Mixins utilities

You can also change the borders on the card header and footer as needed, and even remove their `background-color` with `.bg-transparent`.

<Example code={`
    
Header

Success card title
      
Some quick example text to build on the card title and make up the bulk of the card’s content.

Footer
  
`} />

## Card layout

In addition to styling the content within cards, Bootstrap includes a few options for laying out series of cards. For the time being, **these layout options are not yet responsive**.

### Card groups

Use card groups to render cards as a single, attached element with equal width and height columns. Card groups start off stacked and use `display: flex;` to become attached with uniform dimensions starting at the `sm` breakpoint.

<Example code={`
    
      <Placeholder width="100%" height="180" class="card-img-top" text="Image cap" />

Card title
        
This is a wider card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.
        
Last updated 3 mins ago

      <Placeholder width="100%" height="180" class="card-img-top" text="Image cap" />

Card title
        
This card has supporting text below as a natural lead-in to additional content.
        
Last updated 3 mins ago

      <Placeholder width="100%" height="180" class="card-img-top" text="Image cap" />

Card title
        
This is a wider card with supporting text below as a natural lead-in to additional content. This card has even longer content than the first to show that equal height action.
        
Last updated 3 mins ago

`} />

When using card groups with footers, their content will automatically line up.

<Example code={`
    
      <Placeholder width="100%" height="180" class="card-img-top" text="Image cap" />

Card title
        
This is a wider card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.

        Last updated 3 mins ago

      <Placeholder width="100%" height="180" class="card-img-top" text="Image cap" />

Card title
        
This card has supporting text below as a natural lead-in to additional content.

        Last updated 3 mins ago

      <Placeholder width="100%" height="180" class="card-img-top" text="Image cap" />

Card title
        
This is a wider card with supporting text below as a natural lead-in to additional content. This card has even longer content than the first to show that equal height action.

        Last updated 3 mins ago

`} />

### Grid cards

Use the Bootstrap grid system and its [`.row-cols` classes]([[docsref:/layout/grid#row-columns]]) to control how many grid columns (wrapped around your cards) you show per row. For example, here’s `.row-cols-1` laying out the cards on one column, and `.row-cols-md-2` splitting four cards to equal width across multiple rows, from the medium breakpoint up.

<Example code={`

        <Placeholder width="100%" height="140" class="card-img-top" text="Image cap" />

Card title
          
This is a longer card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.

        <Placeholder width="100%" height="140" class="card-img-top" text="Image cap" />

Card title
          
This is a longer card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.

        <Placeholder width="100%" height="140" class="card-img-top" text="Image cap" />

Card title
          
This is a longer card with supporting text below as a natural lead-in to additional content.

        <Placeholder width="100%" height="140" class="card-img-top" text="Image cap" />

Card title
          
This is a longer card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.

`} />

Change it to `.row-cols-3` and you’ll see the fourth card wrap.

<Example code={`

        <Placeholder width="100%" height="140" class="card-img-top" text="Image cap" />

Card title
          
This is a longer card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.

        <Placeholder width="100%" height="140" class="card-img-top" text="Image cap" />

Card title
          
This is a longer card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.

        <Placeholder width="100%" height="140" class="card-img-top" text="Image cap" />

Card title
          
This is a longer card with supporting text below as a natural lead-in to additional content.

        <Placeholder width="100%" height="140" class="card-img-top" text="Image cap" />

Card title
          
This is a longer card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.

`} />

When you need equal height, add `.h-100` to the cards. If you want equal heights by default, you can set `$card-height: 100%` in Sass.

<Example code={`

        <Placeholder width="100%" height="140" class="card-img-top" text="Image cap" />

Card title
          
This is a longer card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.

        <Placeholder width="100%" height="140" class="card-img-top" text="Image cap" />

Card title
          
This is a short card.

        <Placeholder width="100%" height="140" class="card-img-top" text="Image cap" />

Card title
          
This is a longer card with supporting text below as a natural lead-in to additional content.

        <Placeholder width="100%" height="140" class="card-img-top" text="Image cap" />

Card title
          
This is a longer card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.

`} />

Just like with card groups, card footers will automatically line up.

<Example code={`

        <Placeholder width="100%" height="180" class="card-img-top" text="Image cap" />

Card title
          
This is a wider card with supporting text below as a natural lead-in to additional content. This content is a little bit longer.

          Last updated 3 mins ago

        <Placeholder width="100%" height="180" class="card-img-top" text="Image cap" />

Card title
          
This card has supporting text below as a natural lead-in to additional content.

          Last updated 3 mins ago

        <Placeholder width="100%" height="180" class="card-img-top" text="Image cap" />

Card title
          
This is a wider card with supporting text below as a natural lead-in to additional content. This card has even longer content than the first to show that equal height action.

          Last updated 3 mins ago

`} />

### Masonry

In `v4` we used a CSS-only technique to mimic the behavior of [Masonry](https://masonry.desandro.com/)-like columns, but this technique came with lots of unpleasant [side effects](https://github.com/twbs/bootstrap/pull/28922). If you want to have this type of layout in `v5`, you can just make use of Masonry plugin. **Masonry is not included in Bootstrap**, but we’ve made a [demo example]([[docsref:/examples/masonry]]) to help you get started.

## CSS

### Variables

<AddedIn version="5.2.0" />

As part of Bootstrap’s evolving CSS variables approach, cards now use local CSS variables on `.card` for enhanced real-time customization. Values for the CSS variables are set via Sass, so Sass customization is still supported, too.

<ScssDocs name="card-css-vars" file="scss/_card.scss" />

### Sass variables

<ScssDocs name="card-variables" file="scss/_variables.scss" />
