Skip to content
Material Design 1
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

Material Design

Environment

Material properties

Elevation & shadows

What's new

Motion

Material motion

Duration & easing

Movement

Transforming material

Choreography

Creative customization

Style

Color

Icons

Imagery

Typography

Writing

Layout

Principles

Units & measurements

Metrics & keylines

Structure

Responsive UI

Split screen

Components

Bottom navigation

Bottom sheets

Buttons

Buttons: Floating Action Button

Cards

Chips

Data tables

Dialogs

Dividers

Expansion panels

Grid lists

Lists

Lists: Controls

Menus

Pickers

Progress & activity

Selection controls

Sliders

Snackbars & toasts

Steppers

Subheaders

Tabs

Text fields

Toolbars

Tooltips

Widgets

Patterns

Confirmation & acknowledgement

Data formats

Empty states

Errors

Fingerprint

Gestures

Help & feedback

Launch screens

Loading images

Navigation

Navigation drawer

Navigational transitions

Notifications

Offline states

Permissions

Scrolling techniques

Search

Selection

Settings

Swipe to refresh

Growth & communications

Introduction

Onboarding

Feature discovery

Gesture education

Usability

Accessibility

Bidirectionality

Platforms

Platform adaptation

Android

Resources

Color palettes

Devices

Layout templates

Roboto & Noto fonts

Sticker sheets & icons

Shadows

On this page

Data tables ​

Data tables display sets of raw data. They usually appear in desktop enterprise products.

Data tables may be embedded on a surface, such as a card. They can include:

  • A corresponding visualization
  • The ability to query and manipulate data

Data tables on cards may display navigation and data manipulation tools at the top and bottom.

Supported interactions

Row hover (desktop)
Row selection
Column sorting
Column hover (desktop)
Long header titles
Text editing
Menus


Related components

Cards

Material Design data tables for displaying raw data

Structure ​

A data table contains a header row at the top that lists column names, followed by rows for data.

Checkboxes should accompany each row if the user needs to select or manipulate data.

Data tables may include:

  • Three or more columns of data
  • A corresponding visualization
  • The ability for users to query and manipulate data
Material Design basic data table
Basic data table

Table content

13sp Roboto Regular
87% black

Column headers

12sp Roboto Medium
54% black

Text alignment

Right-aligned numeric columns
Left-aligned text columns

Interaction ​

Row hover (Desktop)

Display a background in a table row if a user hovers over any part of that row. If there are separate hover states on individual table cells, display both the hover state of the cell and row at the same time.

Hover background

  • Grey 200 (#EEEEEE)
Hovering over a row in Material Design data tables
Hovering over a row

Row selection

When a row is selected, display a background color on the row.

Selected row background

  • Grey 100 (#F5F5F5)

Checkbox

  • Use secondary app color
A selected row in a Material Design data table
A selected table row

Sorted column

If column sorting is enabled, sort the most important data by default and display a sorted state in the column header. If the user clicks on a column that is already sorted, reverse the sort order and rotate the sort icon.

Sorted column name

  • 12sp Roboto Medium
  • 87% black

Sort icon

  • 16dp container
  • 87% black
A table with an ascending sorted column in Material Design data tables
Table with an ascending sorted column

Column name hover (Desktop)

If there is a need to provide definitions to column headers, display a tooltip on hover. If sorting is enabled, display a light sort icon upon hover, which indicates that the column is sortable.

Tooltip

  • Follow the guidelines for Tooltips

Sort icon

  • 16dp container
  • 38% black
Hovering over a column header in Material Design data tables
Hovering over a column name

Long header titles

Sometimes, column names don’t fit in a container with the recommended 56dp of padding in between columns. There are two options to handle this:

  • Display the full column name and enable horizontal scrolling in the table container
  • Shorten the column name and display it in full on hover
Long column names truncated with ellipses in Material Design data tables
Long column names truncated with an ellipse

Hovering over a truncated column header in Material Design data tables
Hovering over a truncated column name

Inline text editing

Tables may require basic text editing (e.g. for editing existing text content, or adding comments). Include editable fields within a table and denote them using placeholder text. You can use a simple edit dialog with just a text field, or display a full dialog component on click.

Placeholder text

  • 13sp Roboto Regular
  • 38% black
  • No divider line on text field
Editable table cell with placeholder text in Material Design
An editable table cell with placeholder text

Small edit dialog

  • Align edges of dialog with nearest divider lines, or table edges
  • 24dp of left and right padding
  • Include a single text field, applying the app theme where applicable
  • User confirms text by pressing Enter
Simple Material Design one-field edit dialog
A simple, one-field edit dialog

Large edit dialog

  • Align edges of dialog with nearest divider lines, or table edges
  • Follow the dialog guidelines, applying the app theme where applicable
  • User confirms text by clicking the Save button
Flexible edit dialog with Material Design
A complex, flexible edit dialog

Inline edit icon

  • 18dp container
  • 54% black
Material Design icon edit affordance at cell edges
(Optional) Icon-based edit affordance. Include icons at the edge of the cell on the opposite side of the content.

Inline menus

Instead of editing text, users may need to select from a predefined list of options. In this scenario, embed a menu component directly in the table.

Inline menu

  • 13sp Roboto Regular
  • 87% black
  • Follow spacing and sizing guidelines for menus
Table with inline menus in Material Design
A table with inline menus

Expanded inline menu in Material Design
An expanded inline menu

Tables within cards ​

Tables may be embedded within a card, with table navigation and data manipulation tools displayed at the top and bottom.

Material Design table card with header and footer
Table card with header and footer

Card title

20sp Roboto Regular
87% black

Card action icons (header and footer)

24dp container
54% black

Footer pagination labels

12sp Roboto Regular
54% black

Alternative headers ​

Some table cards may require headers with actions instead of titles. In this case you may either:

  • Display persistent actions
  • Display a contextual header that activates when items are selected
Material Design alternate headers for table card
Alternate headers for a table card

Action buttons

Use borderless buttons
Enable upon item selection

Colored header

Use 50-value of secondary app color for background fill
Display the number of items selected
Display available contextual icons upon item selection

Specs ​

Vertical spacing ​


Vertical spacing of a Material Design data table card
Vertical spacing of a data table card and its last row
  • 64dp card header height
  • 56dp height for last row
  • 48dp data row height

Header & footer padding ​


Horizontal padding in a Material Design table card
Horizontal padding between elements in a table card
  • 24dp of padding around the perimeter of table cards
  • 32dp in between footer control sets
  • 40dp in between the footer row count and its label

Column padding ​


Material Design data table column padding
Padding in between columns
  • Use a minimum of 56dp of padding in between columns. The widest item in the column (including data and column name) should delineate the column border.
  • Checkbox icons have a width and height of 18dp within a 24dp icon container
Pager
Previous pageChips
Next pageDialogs

Released under the Apache-2.0

Copyright © 2014-Present Google

https://m1.material.io/components/data-tables.html

Released under the Apache-2.0

Copyright © 2014-Present Google