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 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.

{ {< example >} }

{ {< /example >} }

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 >} }

{ {< /example >} }

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 >} }

{ {< /example >} }

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 >} }

{ {< /example >} }

List groups#

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

{ {< example >} }

{ {< /example >} }

{ {< example >} }

{ {< /example >} }

{ {< example >} }

{ {< /example >} }

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 >} }

{ {< /example >} }

Header and footer#

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

{ {< example >} }

{ {< /example >} }

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

{ {< example >} }

{ {< /example >} }

{ {< example >} }

{ {< /example >} }

{ {< example >} }

{ {< /example >} }

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 >} }

{ {< /example >} }

Using utilities#

Use our handful of available sizing utilities to quickly set a card's width.

{ {< example >} }

{ {< /example >} }

Using custom CSS#

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

{ {< example >} }

{ {< /example >} }

Text alignment#

You can quickly change the text alignment of any card—in its entirety or specific parts—with our text align classes.

{ {< example >} }

{ {< /example >} }

Navigation#

Add some navigation to a card's header (or block) with Bootstrap's nav components.

{ {< example >} }

{ {< /example >} }

{ {< example >} }

{ {< /example >} }

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 >} }

{ {< /example >} }

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 >} }

{ {< /example >} }

{ {< callout info >} } 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 >} }

{ {< /example >} }

Card styles#

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

Background and color#

{ {< added-in "5.2.0" >} }

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

{ {< example >} } { {< card.inline >} } { {- range (index $.Site.Data "theme-colors") } }

{ {- end -} } { {< /card.inline >} } { {< /example >} }

{ {< callout info >} } { {< partial "callouts/warning-color-assistive-technologies.md" >} } { {< /callout >} }

Border#

Use border utilities 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 >} } { {< card.inline >} } { {- range (index $.Site.Data "theme-colors") } }

{ {- end -} } { {< /card.inline >} } { {< /example >} }

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 >} }

{ {< /example >} }

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 >} }

{ {< /example >} }

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

{ {< example >} }

{ {< /example >} }

Grid cards#

Use the Bootstrap grid system and its .row-cols classes 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 >} }

{ {< /example >} }

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

{ {< example >} }

{ {< /example >} }

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 >} }

{ {< /example >} }

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

{ {< example >} }

{ {< /example >} }

Masonry#

In v4 we used a CSS-only technique to mimic the behavior of Masonry-like columns, but this technique came with lots of unpleasant side effects. 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 to help you get started.

CSS#

Variables#

{ {< added-in "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.

{ {< scss-docs name="card-css-vars" file="scss/_card.scss" >} }

Sass variables#

{ {< scss-docs name="card-variables" file="scss/_variables.scss" >} }