Typography

Change fonts

You can change fonts and other text styles for headings, code and all other components with the following theme properties:

• theme.fontFamily – controls font-family in all components except Title, Code and Kbd
• theme.fontFamilyMonospace – controls font-family of components that require monospace font: Code, Kbd and CodeHighlight
• theme.headings.fontFamily – controls font-family of h1-h6 tags in Title and TypographyStylesProvider components, fallbacks to theme.fontFamily if not defined

import { Button, Code, Title, MantineProvider } from '@mantine/core';

function Demo() {
  return (
    <MantineProvider
      theme={{
        fontFamily: 'Verdana, sans-serif',
        fontFamilyMonospace: 'Monaco, Courier, monospace',
        headings: { fontFamily: 'Greycliff CF, sans-serif' },
      }}
    >
      <Title order={3}>Greycliff CF or sans-serif title</Title>
      <Button>Verdana button</Button>
      <Code>Monaco, Courier Code</Code>
    </MantineProvider>
  );
}

System fonts

By default, Mantine uses system fonts. It means that different devices will display components based on available font, for example, macOS and iOS users will see San Francisco font, Windows users will see Segoe UI font, Android users will see Roboto font and so on. This approach provides a familiar experience to the users and allows avoiding common problems related to custom fonts loading (layout shift, invisible text, etc.), if you do not have strict requirements, it is recommended to use system fonts for better performance.

Default values for theme properties:

• Default value for theme.fontFamily and theme.headings.fontFamily is -apple-system, BlinkMacSystemFont, Segoe UI, Roboto, Helvetica, Arial, sans-serif, Apple Color Emoji, Segoe UI Emoji
• Default value for theme.fontFamilyMonospace is ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, Liberation Mono, Courier New, monospace

Font sizes

import { Text } from '@mantine/core';

function Demo() {
  return (
    <Text fz="md" lh="md">
      Paras is an orange, insectoid Pokémon that resembles the nymph stage of a cicada. Its ovoid
      body is segmented, and it has three pairs of legs. The foremost pair of legs is the largest
      and has sharp claws at the tips. There are five specks on its forehead and three teeth on
      either side of its mouth. It has circular eyes with large pseudopupils.
    </Text>
  );
}

theme.fontSizes property defines font-size values for all Mantine components:

import { MantineProvider, rem } from '@mantine/core';

function Demo() {
  return (
    <MantineProvider
      theme={{
        fontSizes: {
          xs: rem(10),
          sm: rem(11),
          md: rem(14),
          lg: rem(16),
          xl: rem(20),
        },
      }}
    >
      {/* Your app here */}
    </MantineProvider>
  );
}

Default theme.fontSizes values:

Line heights

theme.lineHeights property defines line-height values for Text component, most other components use theme.lineHeights.md by default:

import { MantineProvider } from '@mantine/core';

function Demo() {
  return (
    <MantineProvider
      theme={{
        lineHeights: {
          xs: '1.4',
          sm: '1.45',
          md: '1.55',
          lg: '1.6',
          xl: '1.65',
        },
      }}
    >
      {/* Your app here */}
    </MantineProvider>
  );
}

Default theme.lineHeights values:

h1-h6 styles

To customize headings styles in Title and TypographyStylesProvider components set theme.headings:

import { MantineProvider, rem } from '@mantine/core';

function Demo() {
  return (
    <MantineProvider
      theme={{
        headings: {
          // properties for all headings
          fontWeight: '400',
          fontFamily: 'Roboto',

          // properties for individual headings, all of them are optional
          sizes: {
            h1: {
              fontWeight: '100',
              fontSize: rem(36),
              lineHeight: '1.4',
            },
            h2: { fontSize: rem(30), lineHeight: '1.5' },
            // ...up to h6
            h6: { fontWeight: '900' },
          },
        },
      }}
    >
      {/* Your app here */}
    </MantineProvider>
  );
}

With theme.headings you can customize font-size, font-weight and line-height per heading level. If you need more control over styles, use :is selector with Styles API to target specific heading level:

import { Title, MantineProvider } from '@mantine/core';
import classes from './Demo.module.css';

function Demo() {
  return (
    <MantineProvider
      theme={{
        components: {
          Title: Title.extend({
            classNames: {
              root: classes.heading,
            },
          }),
        },
      }}
    >
      <Title order={1}>Heading 1</Title>
      <Title order={2}>Heading 2</Title>
      <Title order={3}>Heading 3</Title>
      <Title order={4}>Heading 4</Title>
      <Title order={5}>Heading 5</Title>
      <Title order={6}>Heading 6</Title>
    </MantineProvider>
  );
}