Skip to content
Material Design 3
Main Navigation
v3
v2
v1

English

简体中文
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
한국어
Italiano
Polski
Türkçe
čeština
magyar

English

简体中文
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
한국어
Italiano
Polski
Türkçe
čeština
magyar

Appearance

Sidebar Navigation

Foundations

Accessibility

Overview: Principles

Overview: Assistive technology

Designing: Overview

Designing: Color contrast

Designing: Structure

Designing: Flow

Designing: Elements

Writing and text: Best practices

Writing and text: Text truncation

Writing and text: Text resizing

Building for all: User needs

Building for all: Co-design

Content design

Overview

Alt text

Global writing: Overview

Global writing: Word choice

Notifications

Style guide: UX writing best practices

Style guide: Word choice

Style guide: Grammar and punctuation

Customizing Material

Devices

Watches: Overview

Watches: Foundations

Watches: Styles

Watches: Layout

XR

Design: Overview

Design: Interaction

Design: Layout

Design: Accessibility

Components: Overview

Components: App bars

Components: Dialogs

Components: Nav bar

Components: Nav rail

Components: Toolbars

Design tokens: Overview

Design tokens: How to use tokens

Interaction

Gestures

Inputs

Selection

States: Overview

States: State layers

States: Applying states

Layout

Overview: Overview

Overview: Parts of layout

Overview: Adaptive design

Scaffold: Overview

Scaffold: Bars

Scaffold: Rails

Scaffold: Panes

Grids & spacing: Overview

Grids & spacing: Grids

Grids & spacing: Spacing

Grids & spacing: Density

Breakpoints: Overview

Breakpoints: Compact

Breakpoints: Medium

Breakpoints: Expanded

Breakpoints: Large & extra-large

Bidirectionality & RTL

Canonical examples: Overview

Canonical examples: Feed

Canonical examples: List-detail

Canonical examples: Supporting pane

Usability: Overview

Usability: Applying M3 Expressive

Material A-Z

Styles

Color

Color system: Overview

Color system: How the system works

Color roles

Color schemes

Choosing a scheme

Static: Baseline

Static: Custom brand

Dynamic: Choosing a source

Dynamic: User-generated source

Dynamic: Content-based source

Advanced: Overview

Advanced: Apply colors

Advanced: Define new colors

Advanced: Adjust existing colors

Color resources

Elevation: Overview

Elevation: Applying elevation

Elevation: Tokens

Icons: Overview

Icons: Designing icons

Icons: Applying icons

Motion

Motion physics system: How it works

Motion physics system: Specs

Easing and duration: Applying easing and duration

Easing and duration: Tokens & specs

Transitions: Transition patterns

Transitions: Applying transitions

Shape: Overview & principles

Shape: Corner radius scale

Shape: Shape morph

Spacing: Overview

Spacing: Applying spacing

Spacing: Tokens

Typography: Overview

Typography: Fonts

Typography: Type scale & tokens

Typography: Applying type

Typography: Editorial treatments

Components

App bars: Overview

App bars: Specs

App bars: Guidelines

App bars: Accessibility

Badges: Overview

Badges: Specs

Badges: Guidelines

Badges: Accessibility

Buttons

All buttons

Button groups: Overview

Button groups: Specs

Button groups: Guidelines

Button groups: Accessibility

Buttons: Overview

Buttons: Specs

Buttons: Guidelines

Buttons: Accessibility

Extended FABs: Overview

Extended FABs: Specs

Extended FABs: Guidelines

Extended FABs: Accessibility

FAB menu: Overview

FAB menu: Specs

FAB menu: Guidelines

FAB menu: Accessibility

FABs: Overview

FABs: Specs

FABs: Guidelines

FABs: Accessibility

Icon buttons: Overview

Icon buttons: Specs

Icon buttons: Guidelines

Icon buttons: Accessibility

Segmented buttons: Overview

Segmented buttons: Specs

Segmented buttons: Guidelines

Segmented buttons: Accessibility

Split button: Overview

Split button: Specs

Split button: Guidelines

Split button: Accessibility

Cards: Overview

Cards: Specs

Cards: Guidelines

Cards: Accessibility

Carousel: Overview

Carousel: Specs

Carousel: Guidelines

Carousel: Accessibility

Checkbox: Overview

Checkbox: Specs

Checkbox: Guidelines

Checkbox: Accessibility

Chips: Overview

Chips: Specs

Chips: Guidelines

Chips: Accessibility

Date & time pickers

Date pickers: Overview

Date pickers: Specs

Date pickers: Guidelines

Date pickers: Accessibility

Time pickers: Overview

Time pickers: Specs

Time pickers: Guidelines

Time pickers: Accessibility

Dialogs: Overview

Dialogs: Specs

Dialogs: Guidelines

Dialogs: Accessibility

Divider: Overview

Divider: Specs

Divider: Guidelines

Divider: Accessibility

Lists: Overview

Lists: Specs

Lists: Guidelines

Lists: Accessibility

Loading & progress

Loading indicator: Overview

Loading indicator: Specs

Loading indicator: Guidelines

Loading indicator: Accessibility

Progress indicators: Overview

Progress indicators: Specs

Progress indicators: Guidelines

Progress indicators: Accessibility

Menus: Overview

Menus: Specs

Menus: Guidelines

Menus: Accessibility

Navigation

Navigation bar: Overview

Navigation bar: Specs

Navigation bar: Guidelines

Navigation bar: Accessibility

Navigation drawer: Overview

Navigation drawer: Specs

Navigation drawer: Guidelines

Navigation drawer: Accessibility

Navigation rail: Overview

Navigation rail: Specs

Navigation rail: Guidelines

Navigation rail: Accessibility

Radio button: Overview

Radio button: Specs

Radio button: Guidelines

Radio button: Accessibility

Search: Overview

Search: Specs

Search: Guidelines

Search: Accessibility

Sheets

Bottom sheets: Overview

Bottom sheets: Specs

Bottom sheets: Guidelines

Bottom sheets: Accessibility

Side sheets: Overview

Side sheets: Specs

Side sheets: Guidelines

Side sheets: Accessibility

Sliders: Overview

Sliders: Specs

Sliders: Guidelines

Sliders: Accessibility

Snackbar: Overview

Snackbar: Specs

Snackbar: Guidelines

Snackbar: Accessibility

Switch: Overview

Switch: Specs

Switch: Guidelines

Switch: Accessibility

Tabs: Overview

Tabs: Specs

Tabs: Guidelines

Tabs: Accessibility

Text fields: Overview

Text fields: Specs

Text fields: Guidelines

Text fields: Accessibility

Toolbars: Overview

Toolbars: Specs

Toolbars: Guidelines

Toolbars: Accessibility

Tooltips: Overview

Tooltips: Specs

Tooltips: Guidelines

Tooltips: Accessibility

On this page

Carousel: Guidelines ​

Carousels show a collection of items that can be scrolled on and off the screen


Carousel items adapting dynamically to device size by shrinking and reducing in number.
Carousel items adapt dynamically based on breakpoint

Usage ​

Carousels display a scrollable list of items. Carousel items emphasize visuals, but can also contain brief text that adapts to the item size.

There are four carousel layouts:

  • Multi-browseThe multi-browse carousel layout shows at least one large, medium, and small carousel item at a time.
  • UncontainedThe uncontained carousel layout show items that scroll to the edge of the container.
  • HeroThe hero carousel layout shows at least one large and one small item at a time.
  • Full-screenThe full-screen carousel layout shows one edge-to-edge large item at a time and scrolls vertically.

All of these layouts can be centered, though center-aligned heroThe center-aligned hero carousel layout shows at least one large and two small items at a time. The large item is centered. is the most common centered carousel.

Carousels can scroll in two ways:

  • Default: Standard scrolling. Recommended for uncontained layouts.
  • Snap-scrolling: Scrolled items snap to the carousel's layout. Recommended for multi-browse, hero, and full-screen layouts
Contained carousel with a large, medium, and small item. Text is hidden on the small item.
A carousel can contain different sized items

Choose the best carousel layout for your product. Some layouts are more visual-focused, while others are more customizable.

LayoutBest used for
Multi-browseBrowsing many visual items at once (like photos), dynamic designs
UncontainedHighly-customized or text-heavy carousels, stacked imaged and text, traditional carousel behavior
HeroSpotlighting very large visual items (like a movie or featured app)
Center-aligned heroCentered, large visual items
Full-screenVertically-scrolling video or image feeds, immersive experiences

Carousel items must be fully visible on-screen (except for the uncontained layoutThe uncontained carousel layout show items that scroll to the edge of the container.). When scrolled, items automatically change size and snap into place to maintain the same layout.

Multi-browse carousel with all images and text easily legible.
Do Set the large carousel item size to ensure the images and text are easy to read and recognize
Multi-browse carousel with a very thin small item, making the image unrecognizable.
Don’t Avoid setting carousel items so small that the image isn't recognizable

Accessibility requirements on scrolling pages

On vertically-scrolling pages, carousels require an accessible way to view all the items without horizontally scrolling. (This requirement doesn't apply to full-screen carouselsThe full-screen carousel layout shows one edge-to-edge large item at a time and scrolls vertically..)

Material recommends adding a Show all button below the carousel, which opens a dedicated vertically-scrolling page of all carousel items.

If the carousel has a header, you can use an arrow icon button instead.

View the accessibility tab for more details and alternate solutions.

Make sure users can scroll vertically through all carousel items

Multi-browse

The multi-browse layoutThe multi-browse carousel layout shows at least one large, medium, and small carousel item at a time. is best for browsing many items at once, like photos or event feeds. Snap-scrolling is recommended to ensure items are recognizable and consistently sized.

On larger screens, more large and medium items are visible in this layout.

Avoid using this layout if the carousel items need lots of text or have complicated imagery.

A multi-browse layout has different sized items within the carousel

At compact breakpointsWindow widths smaller than 600dp, such as a phone in portrait orientation.More on compact breakpoints, only show up to three carousel items if they have text.

If you need to show more than three items, make sure the images and content are easy to understand and recognize.

Carousel on a phone. 2 large, 1 medium, and 1 small item are fully visible but thin. The items don't have text.
Caution At compact breakpoints, only show more than three items if the items are easy to understand and recognize

Uncontained

The uncontained layoutThe uncontained carousel layout show items that scroll to the edge of the container. is most similar to a traditional carousel, where items are a single size and flow past the edge of the screen.

Both default scrolling and snap-scrolling work well with this layout.

Since items don't change size, this layout can be customized to show more text or other UI above or below each item without the text being masked or cropped.

Carousel items are all the same size in an uncontained layout

Uncontained multi-aspect ratio

The uncontained multi-aspect ratioThe uncontained multi-aspect ratio layout shows carousel items of various widths. carousel has the same layout as the uncontained carousel but contains items of various sizes.

Item widths can range anywhere between 9:16 for min width size to 16:9 for max width.

Only use this carousel layout if the items have various widths.

Carousel items are of various sizes in an uncontained multi-aspect ratio layout

Hero

The hero layoutThe hero carousel layout shows at least one large and one small item at a time. is best for spotlighting content that needs more attention, like movie, shows, or other media thumbnails. It highlights one large image to focus on, while providing a sneak peek of what’s next.

On larger screens, more large items are visible.

Use snap-scrolling so users can easily cycle through items one at a time.

A hero carousel at a compact breakpoint should show one large item and one small item

Center-aligned hero

When the hero layoutThe hero carousel layout shows at least one large and one small item at a time. is center-aligned, it adds an additional previewed item on the leading edge, making the large carousel item centered.

A centered hero carousel has two small carousel items, with a large item centered

Full-screen

The full-screen layoutThe full-screen carousel layout shows one edge-to-edge large item at a time and scrolls vertically. is best used for immersive experiences like video articles, featured headlines, or items that are visually rich. It can contain text and other UI elements on top of the image.

This layout works best with content that is taller than it is wide, and scrolls vertically. It only works in portrait orientation in compact and medium breakpointsWindow widths from 600dp to 839dp, such as a tablet or foldable in portrait orientation.More on medium breakpoints. Don't use this layout in landscape orientation.

Use snap-scrolling for full-screen layouts. Don't use default scrolling.

Full-screen carousels fill the entire content area of the screen

Anatomy ​

4 elements of a carousel.

Multi-browse carousel (left) and hero carousel (right):

  1. Container
  2. Large carousel item
  3. Medium carousel item
  4. Small carousel item

Container

The carousel container holds all carousel items. The number of carousel items visible in the container can change based on the carousel layoutLayout is the visual arrangement of elements on the screen.More on layout and breakpointBreakpoints are opinionated window sizes where a layout changes to match available space, device conventions, and ergonomics (previously window size classes).More on breakpoints.

An empty rectangle representing a carousel container.
The carousel container is a rectangle. It can be used in many ways and stretched to any size.

Carousel items

Carousel items hold content. A carousel item has no fixed width; it changes width depending on the breakpoint or its position in the carousel's layout. There are three dynamic widths an item can be: large, medium, and small.

3 sizes of carousel items.
  1. Large carousel item
  2. Medium carousel item
  3. Small carousel item

Large items have a max width that can be adjusted. This changes how all other large, medium, and small carousel items fit on screen. Large items must remain big enough to be easy to understand and recognize.

Medium items adjust width dynamically to the carousel size and available space.

Small items have a width range of 40–56dp.

2 sizes of carousel items for hero layouts.
  1. Large item
  2. Small item

When the large item's max width is narrow enough, more items can be shown on screen at once. At compact breakpoints, this is only recommended for carousels with simple imagery.

3 sizes of carousel items for multi-browse layouts. 2 large items are visible.
  1. Large item
  2. Medium item
  3. Small item

Item text (optional)

Carousel items are primarily visual. Item text is optional and should be brief.

If your carousel items require a lot of text, consider using the uncontained layoutThe uncontained carousel layout show items that scroll to the edge of the container., which can show more information, or use a series of cardsCards display content and actions about a single subject.More on cards instead.

Contained carousel items with 5 lines of content: a title, a description, and a label.
Caution Avoid exceeding two lines of text in carousel items at compact breakpoints unless the background is simple, like a single color

Content within a carousel item can adapt dynamically based on the container and breakpoint.

Text should always be understandable at each size. Consider adapting the text to use brief labels on smaller carousel items.

A carousel item at 3 different sizes to show  how text changes at each size.
  1. Large carousel item with the full title and label text
  2. Medium carousel item hiding the title text
  3. Small carousel item abbreviating the label text

Adaptive design ​

As the carousel container size increases, so do the number of carousel items visible at a time.

At compact breakpointsWindow widths smaller than 600dp, such as a phone in portrait orientation.More on compact breakpoints, carousels can comfortably show up to three carousel items at once.

At larger breakpoints, more carousel items are added and scale in size.

Full-screen carouselsThe full-screen carousel layout shows one edge-to-edge large item at a time and scrolls vertically. only ever show one item at once.

8 carousel items visible at once on a tablet in landscape orientation.
Carousels can show more items at once on larger screens

Behavior ​

Scrolling

Carousel items have a parallax effect when they're scrolled.

The default scrolling behavior doesn't snap items to a layout grid. They can stop anywhere in the container. Only use this for the uncontained layoutThe uncontained carousel layout show items that scroll to the edge of the container..

The snap-scrolling behavior aligns carousel items to the layout grid after they're scrolled. Items snap to the grid when released. Use this for multi-browseThe multi-browse carousel layout shows at least one large, medium, and small carousel item at a time., heroThe hero carousel layout shows at least one large and one small item at a time., and full-screen layoutsThe full-screen carousel layout shows one edge-to-edge large item at a time and scrolls vertically..

Carousel items with snap-scrolling maintain the same layout when released

In full-screen layouts, make sure the carousel items snap to the edges of the carousel container. Avoid letting them scroll freely or stop halfway.

Full-screen layouts must use snap-scrolling.

Full-screen carousel with items stopping halfway off screen once scrolled.
Don’t Avoid scrolling freely on full-screen carousels
Pager
Previous pageCarousel: Specs
Next pageCarousel: Accessibility

Released under the Apache 2.0 or CC BY 4.0

Copyright © 2018-Present Google

https://m3.material.io/components/carousel/guidelines

Released under the Apache 2.0 or CC BY 4.0

Copyright © 2018-Present Google