---
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
---

```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.                 |