---
title: Heading
description: "`Heading` is a component that represents section headings. By default, it renders an `h1` element."
links:
  - style: https://github.com/yamada-ui/yamada-ui/tree/main/packages/react/src/components/heading/heading.style.ts
  - source: https://github.com/yamada-ui/yamada-ui/tree/main/packages/react/src/components/heading
  - storybook: https://yamada-ui.github.io/yamada-ui?path=/story/components-heading--basic
---

# Heading

`Heading` is a component that represents section headings. By default, it renders an `h1` element.

```tsx
<Heading>ギャルのパンティーおくれーーーっ！！！！！</Heading>
```

## Usage

```tsx
import { Heading } from "@yamada-ui/react"
```

```tsx
import { Heading } from "@/components/ui"
```

```tsx
import { Heading } from "@workspaces/ui"
```

```tsx
<Heading />
```

## Change Size

```tsx
<VStack>
  <For
    each={[
      { as: "h1", size: "4xl" },
      { as: "h2", size: "3xl" },
      { as: "h2", size: "2xl" },
      { as: "h3", size: "xl" },
      { as: "h3", size: "lg" },
      { as: "h4", size: "md" },
      { as: "h5", size: "sm" },
      { as: "h6", size: "xs" },
    ]}
  >
    {({ as, size }, index) => (
      <Heading key={index} as={as} size={size} truncated>
        ギャルのパンティーおくれーーーっ！！！！！
      </Heading>
    )}
  </For>
</VStack>
```

## Add Gradient

```tsx
<Heading
  size="2xl"
  bgClip="text"
  bgGradient="linear(to-l, #7928CA, #FF0080)"
  truncated
  w="full"
>
  クリリンのことか……クリリンのことかーーーっ！！！！！
</Heading>
```

## Props

| Prop          | Default | Type                                                                                                                      | Description                                |
| ------------- | ------- | ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
| `as`          | -       | `As`                                                                                                                      | The HTML element to render.                |
| `asChild`     | -       | `boolean`                                                                                                                 | Merges its props onto its immediate child. |
| `css`         | -       | `CSSObject \| CSSObject[]`                                                                                                | The CSS object.                            |
| `colorScheme` | -       | `"amber" \| "black" \| "blackAlpha" \| "blue" \| "cyan" \| "danger" \| "emerald" \| "error" \| "flashy" \| "fuchsia" ...` | Set color scheme variables.                |
| `size`        | `"4xl"` | `"2xl" \| "3xl" \| "4xl" \| "5xl" \| "6xl" \| "7xl" \| "8xl" \| "9xl" \| "lg" \| "md" ...`                                | The size of the component.                 |

## Similar Components

- [Blockquote](https://yamada-ui.com/docs/components/blockquote.md): `Blockquote` is a component that represents a quotation. By default, it renders a `blockquote` element.
- [Code](https://yamada-ui.com/docs/components/code.md): `Code` is a component that represents a code block. By default, it renders a `code` element.
- [Em](https://yamada-ui.com/docs/components/em.md): `Em` is a component that represents emphasized text. By default, it renders a `em` element.
- [Highlight](https://yamada-ui.com/docs/components/highlight.md): `Highlight` is a component that highlights specified strings within text. By default, it renders a `p` element.
- [Kbd](https://yamada-ui.com/docs/components/kbd.md): `Kbd` is a component that represents keyboard input.
- [Mark](https://yamada-ui.com/docs/components/mark.md): `Mark` is a component that emphasizes a specific part of the text.
- [Text](https://yamada-ui.com/docs/components/text.md): `Text` is a component that represents a paragraph of text. By default, it renders a `p` element.
- [Link](https://yamada-ui.com/docs/components/link.md): `Link` is a component for creating hyperlinks to different web pages, locations within the same page, or other URLs.