--- productId: material-ui title: React Typography component components: Typography githubLabel: 'scope: typography' materialDesign: https://m2.material.io/design/typography/the-type-system.html githubSource: packages/mui-material/src/Typography --- # Typography Use typography to present your design and content as clearly and efficiently as possible. ## Roboto font Material UI uses the [Roboto](https://fonts.google.com/specimen/Roboto) font by default. Add it to your project via Fontsource, or with the Google Fonts CDN. ```bash npm npm install @fontsource/roboto ``` ```bash pnpm pnpm add @fontsource/roboto ``` ```bash yarn yarn add @fontsource/roboto ``` Then you can import it in your entry point like this: ```tsx import '@fontsource/roboto/300.css'; import '@fontsource/roboto/400.css'; import '@fontsource/roboto/500.css'; import '@fontsource/roboto/700.css'; ``` :::info Fontsource can be configured to load specific subsets, weights, and styles. Material UI's default typography configuration relies only on the 300, 400, 500, and 700 font weights. ::: ### Google Web Fonts To install Roboto through the Google Web Fonts CDN, add the following code inside your project's `` tag: ```html ``` ## Component ### Usage The Typography component follows the [Material Design typographic scale](https://m2.material.io/design/typography/#type-scale) that provides a limited set of type sizes that work well together for a consistent layout. ```tsx import Box from '@mui/material/Box'; import Typography from '@mui/material/Typography'; export default function Types() { return ( h1. Heading h2. Heading h3. Heading h4. Heading h5. Heading h6. Heading subtitle1. Lorem ipsum dolor sit amet, consectetur adipisicing elit. Quos blanditiis tenetur subtitle2. Lorem ipsum dolor sit amet, consectetur adipisicing elit. Quos blanditiis tenetur body1. Lorem ipsum dolor sit amet, consectetur adipisicing elit. Quos blanditiis tenetur unde suscipit, quam beatae rerum inventore consectetur, neque doloribus, cupiditate numquam dignissimos laborum fugiat deleniti? Eum quasi quidem quibusdam. body2. Lorem ipsum dolor sit amet, consectetur adipisicing elit. Quos blanditiis tenetur unde suscipit, quam beatae rerum inventore consectetur, neque doloribus, cupiditate numquam dignissimos laborum fugiat deleniti? Eum quasi quidem quibusdam. button text caption text overline text ); } ``` ### Theme keys In some situations you might not be able to use the Typography component. Hopefully, you might be able to take advantage of the [`typography`](/material-ui/customization/default-theme/?expand-path=$.typography) keys of the theme. ```tsx import { styled } from '@mui/material/styles'; const Div = styled('div')(({ theme }) => ({ ...theme.typography.button, backgroundColor: (theme.vars || theme).palette.background.paper, padding: theme.spacing(1), })); export default function TypographyTheme() { return
{"This div's text looks like that of a button."}
; } ``` ## Customization ### Adding & disabling variants In addition to using the default typography variants, you can add custom ones, or disable any you don't need. See the [Adding & disabling variants](/material-ui/customization/typography/#adding-disabling-variants) page for more info. ### Changing the semantic element The Typography component uses the `variantMapping` prop to associate a UI variant with a semantic element. It's important to realize that the style of a typography component is independent from the semantic underlying element. To change the underlying element for a one-off situation, like avoiding two `h1` elements in your page, use the `component` prop: ```jsx h1. Heading ``` To change the typography element mapping globally, [use the theme](/material-ui/customization/typography/#adding-disabling-variants): ```js const theme = createTheme({ components: { MuiTypography: { defaultProps: { variantMapping: { h1: 'h2', h2: 'h2', h3: 'h2', h4: 'h2', h5: 'h2', h6: 'h2', subtitle1: 'h2', subtitle2: 'h2', body1: 'span', body2: 'span', }, }, }, }, }); ``` ### sx prop Use the [`sx` prop](/system/getting-started/the-sx-prop/) to quickly customize any Typography instance using a superset of CSS that has access to all the style functions and theme-aware properties exposed in the MUI System package. Below is an example of how to apply margin using this prop: ```jsx ``` ## Accessibility Key factors to follow for an accessible typography: - **Color**. Provide enough contrast between text and its background, check out the minimum recommended [WCAG 2.2 color contrast ratio](https://www.w3.org/WAI/WCAG22/Understanding/contrast-minimum.html) (4.5:1). - **Font size**. Use [relative units (rem)](/material-ui/customization/typography/#font-size), instead of pixels, to accommodate the user's browser settings. - **Heading hierarchy**. Based on [the W3 guidelines](https://www.w3.org/WAI/tutorials/page-structure/headings/), don't skip heading levels. Make sure to [separate the semantics from the style](#changing-the-semantic-element). # Typography API ## Demos For examples and details on the usage of this React component, visit the component demo pages: - [Breadcrumbs](https://mui.com/material-ui/react-breadcrumbs/) - [Menubar](https://mui.com/material-ui/react-menubar/) - [Typography](https://mui.com/material-ui/react-typography/) ## Import ```jsx import Typography from '@mui/material/Typography'; // or import { Typography } from '@mui/material'; ``` ## Props | Name | Type | Default | Required | Description | |------|------|---------|----------|-------------| | align | `'center' \| 'inherit' \| 'justify' \| 'left' \| 'right'` | `'inherit'` | No | | | children | `node` | - | No | | | classes | `object` | - | No | Override or extend the styles applied to the component. | | color | `'primary' \| 'secondary' \| 'success' \| 'error' \| 'info' \| 'warning' \| 'textPrimary' \| 'textSecondary' \| 'textDisabled' \| string` | - | No | | | component | `elementType` | - | No | | | gutterBottom | `bool` | `false` | No | | | noWrap | `bool` | `false` | No | | | sx | `Array \| func \| object` | - | No | The system prop that allows defining system overrides as well as additional CSS styles. | | variant | `'body1' \| 'body2' \| 'button' \| 'caption' \| 'h1' \| 'h2' \| 'h3' \| 'h4' \| 'h5' \| 'h6' \| 'inherit' \| 'overline' \| 'subtitle1' \| 'subtitle2' \| string` | `'body1'` | No | | | variantMapping | `object` | `{ h1: 'h1', h2: 'h2', h3: 'h3', h4: 'h4', h5: 'h5', h6: 'h6', subtitle1: 'h6', subtitle2: 'h6', body1: 'p', body2: 'p', inherit: 'p', }` | No | | > **Note**: The `ref` is forwarded to the root element (HTMLParagraphElement). > Any other props supplied will be provided to the root element (native element). ## Theme default props You can use `MuiTypography` to change the default props of this component with the theme. ## CSS ### Rule name | Global class | Rule name | Description | |--------------|-----------|-------------| | - | alignCenter | Styles applied to the root element if `align="center"`. | | - | alignJustify | Styles applied to the root element if `align="justify"`. | | - | alignLeft | Styles applied to the root element if `align="left"`. | | - | alignRight | Styles applied to the root element if `align="right"`. | | - | body1 | Styles applied to the root element if `variant="body1"`. | | - | body2 | Styles applied to the root element if `variant="body2"`. | | - | button | Styles applied to the root element if `variant="button"`. | | - | caption | Styles applied to the root element if `variant="caption"`. | | - | gutterBottom | Styles applied to the root element if `gutterBottom={true}`. | | - | h1 | Styles applied to the root element if `variant="h1"`. | | - | h2 | Styles applied to the root element if `variant="h2"`. | | - | h3 | Styles applied to the root element if `variant="h3"`. | | - | h4 | Styles applied to the root element if `variant="h4"`. | | - | h5 | Styles applied to the root element if `variant="h5"`. | | - | h6 | Styles applied to the root element if `variant="h6"`. | | - | inherit | Styles applied to the root element if `variant="inherit"`. | | - | noWrap | Styles applied to the root element if `nowrap={true}`. | | - | overline | Styles applied to the root element if `variant="overline"`. | | - | root | Styles applied to the root element. | | - | subtitle1 | Styles applied to the root element if `variant="subtitle1"`. | | - | subtitle2 | Styles applied to the root element if `variant="subtitle2"`. | ## Source code If you did not find the information on this page, consider having a look at the implementation of the component for more detail. - [/packages/mui-material/src/Typography/Typography.js](https://github.com/mui/material-ui/tree/HEAD/packages/mui-material/src/Typography/Typography.js)