---
title: QrCode
description: "`QrCode` is a component that displays a QR code."
links:
  - style: https://github.com/yamada-ui/yamada-ui/tree/main/packages/react/src/components/qr-code/qr-code.style.ts
  - source: https://github.com/yamada-ui/yamada-ui/tree/main/packages/react/src/components/qr-code
  - storybook: https://yamada-ui.github.io/yamada-ui?path=/story/components-qr-code--basic
---

```tsx
<QrCode.Root value="https://yamada-ui.com" />
```

## Usage

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

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

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

```tsx
<QrCode.Root>
  <QrCode.Frame>
    <QrCode.Pattern />
  </QrCode.Frame>
  <QrCode.Overlay />
</QrCode.Root>
```

### Change Size

```tsx
<VStack>
  <For each={["2xs", "xs", "sm", "md", "lg", "xl", "2xl", "3xl", "4xl"]}>
    {(size, index) => (
      <QrCode.Root key={index} size={size} value="https://yamada-ui.com" />
    )}
  </For>
</VStack>
```

### Change Color Scheme

```tsx
<Wrap gap="md">
  <For each={["red", "orange"]}>
    {(colorScheme, index) => (
      <QrCode.Root
        key={index}
        colorScheme={colorScheme}
        value="https://yamada-ui.com"
      />
    )}
  </For>
</Wrap>
```

### Change Color

```tsx
<Wrap gap="md">
  <For each={["blue", "green"]}>
    {(color, index) => (
      <QrCode.Root key={index} color={color} value="https://yamada-ui.com" />
    )}
  </For>
</Wrap>
```

### Change Error Correction Level

To change the error correction level, set `ecc` to `L`, `M`, `Q`, or `H`.

```tsx
<Wrap gap="md">
  <For each={["L", "M", "Q", "H"]}>
    {(ecc, index) => (
      <QrCode.Root key={index} ecc={ecc} value="https://yamada-ui.com" />
    )}
  </For>
</Wrap>
```

### Use Overlay

`QrCode.Overlay` can be used to place an icon on the QR code.

```tsx
<QrCode.Root size="xl" value="https://yamada-ui.com">
  <QrCode.Frame>
    <QrCode.Pattern />
  </QrCode.Frame>

  <QrCode.Overlay>
    <Icon boxSize="14" color="currentColor" viewBox="0 0 196 196">
      <path
        d="M95.4499 0H100.521C105.565 0.195483 109.752 0.567222 113.081 1.11522C117.34 1.81383 122.177 2.9659 127.593 4.57143C130.711 5.49437 133.747 6.60798 136.702 7.91227C154.221 15.6291 168.393 27.3741 179.218 43.1474C181.599 46.618 184.065 50.9859 186.616 56.2512C188.055 59.2283 189.282 62.183 190.298 65.1152C197.921 87.1087 197.901 109.088 190.235 131.052C189.165 134.116 187.922 137.108 186.505 140.027C176.43 160.803 161.028 176.252 140.297 186.376C137.362 187.808 134.449 189.037 131.559 190.063C109.412 197.898 87.2703 197.978 65.1333 190.303C57.6684 187.712 50.0784 183.78 43.6661 179.569C39.5771 176.884 35.4705 173.618 31.3463 169.773C19.6465 158.874 11.1112 145.992 5.74036 131.129C4.4938 127.678 3.26486 123.238 2.05354 117.809C-0.133561 108.013 -0.460424 97.5574 0.539393 87.6166C1.0361 82.6975 2.10802 77.2384 3.75515 71.2393C5.75478 63.9519 8.62926 56.9674 12.3786 50.2857C13.7854 47.7829 15.1777 45.5172 16.5557 43.4887C20.9139 37.0633 25.8985 31.2437 31.5097 26.0297C34.9754 22.8139 38.9122 19.7086 42.7192 17.0455C44.8149 15.581 47.4266 13.9787 50.5543 12.2385C56.316 9.02749 62.1739 6.48781 68.128 4.6195C77.0334 1.82184 86.1407 0.282009 95.4499 0ZM154.074 37.4367C146.57 30.5339 137.572 24.6598 127.905 21.0401C121.589 18.6719 115.63 17.0872 110.029 16.286C96.0251 14.2831 82.3129 15.7412 68.8923 20.6604C66.1331 21.6746 63.6192 22.9389 60.9947 24.1598C58.4038 25.3664 56.1302 26.8806 53.6595 28.3323C52.7334 28.8771 51.8249 29.4795 50.934 30.1397C48.7421 31.7693 46.43 33.3844 44.4352 35.1534C43.288 36.1724 42.0991 37.2332 40.8685 38.3356C38.2056 40.7246 35.9608 43.5511 33.6199 46.2815C33.6059 46.2986 33.5959 46.3188 33.591 46.3403C33.586 46.3618 33.5861 46.384 33.5913 46.4052C33.5964 46.4263 33.6065 46.4458 33.6207 46.4619C33.6349 46.478 33.6527 46.4903 33.6727 46.4978L148.161 89.3423C148.265 89.3813 148.375 89.3963 148.484 89.3863C148.594 89.3763 148.698 89.3416 148.791 89.2847L176.238 72.3882C176.294 72.3545 176.336 72.3028 176.359 72.2417C176.382 72.1806 176.383 72.1136 176.363 72.0517C173.376 63.2133 169.166 55.1904 163.731 47.9832C160.943 44.2914 157.506 40.5949 154.074 37.4367ZM131.717 99.7927C131.836 99.719 131.829 99.6565 131.698 99.6052L25.0301 59.6833C24.9243 59.6449 24.8474 59.6769 24.7994 59.7795C24.1104 61.244 23.4022 62.7133 22.6748 64.1875C22.0242 65.5046 21.4042 66.9787 20.8145 68.6099C19.1257 73.2854 17.8455 77.7864 16.9739 82.1127C15.1954 90.9415 14.955 100.137 16.2529 109.7C16.6855 112.895 17.3376 116.035 18.2092 119.122C19.4398 123.461 20.6239 126.978 21.7615 129.673C23.806 134.512 26.2478 139.13 29.087 143.526C29.9619 144.882 31.2085 146.59 32.8267 148.651C33.8682 149.981 34.9465 151.25 36.0617 152.458C37.1929 153.682 38.3049 154.93 39.3977 156.202C39.4625 156.276 39.5508 156.325 39.6468 156.34C39.7429 156.355 39.8403 156.335 39.9216 156.284L131.717 99.7927ZM73.401 176.815C79.5377 178.712 86.2881 179.906 93.6521 180.396C96.7606 180.604 99.9699 180.587 103.28 180.343C107.561 180.026 111.336 179.532 114.605 178.863C119.466 177.866 124.584 176.251 129.958 174.017C133.01 172.743 136.197 171.335 139.024 169.595C141.119 168.311 143.278 167.1 145.272 165.643C148.051 163.618 149.908 162.198 150.844 161.384C156.368 156.59 160.866 151.857 164.336 147.185C167.086 143.486 169.665 139.248 172.075 134.47C174.286 130.081 176.18 124.818 177.459 120.395C180.458 110.003 181.298 99.3328 179.978 88.3857C179.962 88.2383 179.89 88.2031 179.761 88.28L52.5154 166.6C52.4875 166.616 52.4642 166.639 52.448 166.667C52.4319 166.695 52.4234 166.726 52.4234 166.759C52.4234 166.791 52.4319 166.822 52.448 166.85C52.4642 166.878 52.4875 166.901 52.5154 166.917C55.2313 168.494 57.7933 170.21 60.6149 171.59C65.3096 173.891 69.5716 175.632 73.401 176.815Z"
        fill="currentColor"
      />
    </Icon>
  </QrCode.Overlay>
</QrCode.Root>
```

## Props

### QrCode.Root

| 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`         | `"md"`  | `"2xl" \| "2xs" \| "3xl" \| "4xl" \| "lg" \| "md" \| "sm" \| "xl" \| "xs" ...`                                            | The size of the component.                                                                                                                                                                                     |
| `value`        | -       | `string`                                                                                                                  | The value to encode as a QR code.                                                                                                                                                                              |
| `boostEcc`     | `false` | `boolean`                                                                                                                 | The error correction level to boost the error correction level to the maximum allowed by the version and size.                                                                                                 |
| `border`       | `1`     | `number`                                                                                                                  | The border width around the QR code.                                                                                                                                                                           |
| `ecc`          | `"L"`   | `"H" \| "L" \| "M" \| "Q"`                                                                                                | The error correction level. - `L` allows for up to 7% error correction, - `M` allows for up to 15% error correction, - `Q` allows for up to 25% error correction, - `H` allows for up to 30% error correction. |
| `frameProps`   | -       | `QrCodeFrameProps`                                                                                                        | Props for the frame component.                                                                                                                                                                                 |
| `invert`       | `false` | `boolean`                                                                                                                 | Inverts the black and white of the QR code.                                                                                                                                                                    |
| `maskPattern`  | `-1`    | `number`                                                                                                                  | The mask pattern to use.                                                                                                                                                                                       |
| `maxVersion`   | `40`    | `number`                                                                                                                  | The maximum version of the QR code (1-40).                                                                                                                                                                     |
| `minVersion`   | `1`     | `number`                                                                                                                  | The minimum version of the QR code (1-40).                                                                                                                                                                     |
| `onEncoded`    | -       | `(qr: QrCodeGenerateResult) => void`                                                                                      | Callback function to receive the generated QR Code.                                                                                                                                                            |
| `patternProps` | -       | `QrCodePatternProps`                                                                                                      | Props for the pattern component.                                                                                                                                                                               |
| `pixelSize`    | `10`    | `number`                                                                                                                  | The pixel size of the QR code.                                                                                                                                                                                 |

### QrCode.Frame

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

### QrCode.Overlay

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

### QrCode.Pattern

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