Concepts

Application

Buttons

Data display

Disclosure

Feedback

Layout

Media

Navigation

Overlay

Typography

Utilities

QR Code

Used to generate a QR code based on the provided data

Recipe

import { QrCode } from '@chakra-ui/react'

export const QrCodeBasic = () => {
  return (
    <QrCode.Root value="https://saas-ui.dev">
      <QrCode.Frame>
        <QrCode.Pattern />
      </QrCode.Frame>
    </QrCode.Root>
  )
}

Anatomy

import { QrCode } from '@chakra-ui/react'

<QrCode.Root value="...">
  <QrCode.Frame>
    <QrCode.Pattern />
  </QrCode.Frame>
  <QrCode.Overlay />
  <QrCode.DownloadTrigger fileName="..." mimeType="image/png" />
</QrCode.Root>

Examples

Sizes

Use the size prop to set the size of the QR code.

import { For, QrCode, Stack } from '@chakra-ui/react'

export const QrCodeWithSizes = () => {
  return (
    <Stack>
      <For each={['2xs', 'xs', 'sm', 'md', 'lg', 'xl', '2xl']}>
        {(size) => (
          <QrCode.Root key={size} size={size} value="https://saas-ui.dev">
            <QrCode.Frame>
              <QrCode.Pattern />
            </QrCode.Frame>
          </QrCode.Root>
        )}
      </For>
    </Stack>
  )
}

Logo Overlay

Pass the children prop to the QrCode.Overlay component to add a logo or overlay to the QR code.

import { QrCode } from '@chakra-ui/react'

export const QrCodeWithOverlay = () => {
  return (
    <QrCode.Root value="https://saas-ui.dev">
      <QrCode.Frame>
        <QrCode.Pattern />
      </QrCode.Frame>
      <QrCode.Overlay>
        <Logo />
      </QrCode.Overlay>
    </QrCode.Root>
  )
}

const Logo = () => {
  return (
    <svg
      width="40"
      height="40"
      viewBox="0 0 40 40"
      fill="none"
      xmlns="http://www.w3.org/2000/svg"
    >
      <path
        fillRule="evenodd"
        clipRule="evenodd"
        d="M10 0C15.5228 0 20 4.47715 20 10V0H30C35.5228 0 40 4.47715 40 10C40 15.5228 35.5228 20 30 20C35.5228 20 40 24.4772 40 30C40 32.7423 38.8961 35.2268 37.1085 37.0334L37.0711 37.0711L37.0379 37.1041C35.2309 38.8943 32.7446 40 30 40C27.2741 40 24.8029 38.9093 22.999 37.1405C22.9756 37.1175 22.9522 37.0943 22.9289 37.0711C22.907 37.0492 22.8852 37.0272 22.8635 37.0051C21.0924 35.2009 20 32.728 20 30C20 35.5228 15.5228 40 10 40C4.47715 40 0 35.5228 0 30V20H10C4.47715 20 0 15.5228 0 10C0 4.47715 4.47715 0 10 0ZM18 10C18 14.4183 14.4183 18 10 18V2C14.4183 2 18 5.58172 18 10ZM38 30C38 25.5817 34.4183 22 30 22C25.5817 22 22 25.5817 22 30H38ZM2 22V30C2 34.4183 5.58172 38 10 38C14.4183 38 18 34.4183 18 30V22H2ZM22 18V2L30 2C34.4183 2 38 5.58172 38 10C38 14.4183 34.4183 18 30 18H22Z"
        fill="currentColor"
      ></path>
    </svg>
  )
}

Fill

Set the fill style on the QrCode.Frame component to change the color of the QR code pattern.

import { Flex, For, QrCode } from '@chakra-ui/react'

export const QrCodeWithFill = () => {
  return (
    <Flex gap="4">
      <For each={['#5417D7', '#FF0000']}>
        {(fill) => (
          <QrCode.Root key={fill} value="https://saas-ui.dev">
            <QrCode.Frame style={{ fill }}>
              <QrCode.Pattern />
            </QrCode.Frame>
          </QrCode.Root>
        )}
      </For>
    </Flex>
  )
}

Download

Use the QrCode.DownloadTrigger to download the QR code.

The fileName and the mimeType props are required.

import { Button, QrCode } from '@chakra-ui/react'

export const QrCodeWithExport = () => {
  return (
    <QrCode.Root value="https://saas-ui.dev">
      <QrCode.Frame>
        <QrCode.Pattern />
      </QrCode.Frame>

      <QrCode.DownloadTrigger
        asChild
        fileName="qr-code.png"
        mimeType="image/png"
      >
        <Button variant="outline" size="xs" mt="3">
          Download
        </Button>
      </QrCode.DownloadTrigger>
    </QrCode.Root>
  )
}

Error Correction

In cases where the link is too long or the logo overlay covers a significant area, the error correction level can be increased.

Use the encoding.ecc or encoding.boostEcc property to set the error correction level:

L: Allows recovery of up to 7% data loss (default)
M: Allows recovery of up to 15% data loss
Q: Allows recovery of up to 25% data loss
H: Allows recovery of up to 30% data loss

LMQH

'use client'

import { useState } from 'react'

import { QrCode, SegmentGroup, Stack } from '@chakra-ui/react'

type ErrorLevel = 'L' | 'M' | 'Q' | 'H'

export const QrCodeWithErrorLevel = () => {
  const [errorLevel, setErrorLevel] = useState<ErrorLevel>('L')
  return (
    <Stack align="flex-start">
      <QrCode.Root
        value="https://saas-ui.dev"
        size="xl"
        encoding={{ ecc: errorLevel }}
      >
        <QrCode.Frame>
          <QrCode.Pattern />
        </QrCode.Frame>
      </QrCode.Root>
      <SegmentGroup.Root
        size="sm"
        defaultValue="L"
        onValueChange={(e) => setErrorLevel(e.value as ErrorLevel)}
      >
        <SegmentGroup.Indicator />
        <SegmentGroup.Items items={['L', 'M', 'Q', 'H']} />
      </SegmentGroup.Root>
    </Stack>
  )
}

Input

Here's an example of how to use the QrCode component with an Input component.

'use client'

import { useState } from 'react'

import { Input, QrCode, Stack } from '@chakra-ui/react'

export const QrCodeWithInput = () => {
  const [value, setValue] = useState('https://saas-ui.dev')
  return (
    <Stack maxW="240px" gap="4">
      <QrCode.Root value={value}>
        <QrCode.Frame>
          <QrCode.Pattern />
        </QrCode.Frame>
      </QrCode.Root>
      <Input value={value} onChange={(e) => setValue(e.target.value)} />
    </Stack>
  )
}

Props

Root

Prop	Default	Type
`colorPalette`	`'gray'`	`'base' \| 'gray' \| 'zinc' \| 'neutral' \| 'stone' \| 'red' \| 'orange' \| 'amber' \| 'yellow' \| 'lime' \| 'green' \| 'emerald' \| 'teal' \| 'cyan' \| 'sky' \| 'blue' \| 'indigo' \| 'violet' \| 'purple' \| 'fuchsia' \| 'pink' \| 'rose' \| 'sidebar' \| 'sidebar.accent' \| 'interaction' \| 'accent' \| 'presence' \| 'status' \| 'slate'` The color palette of the component
`size`	`'md'`	`'2xs' \| 'xs' \| 'sm' \| 'md' \| 'lg' \| 'xl' \| '2xl' \| 'full'` The size of the component
`asChild`		`boolean` Use the provided child element as the default rendered element, combining their props and behavior. For more details, read our Composition guide.
`defaultValue`		`string` The initial value to encode when rendered. Use when you don't need to control the value of the qr code.
`encoding`		`QrCodeGenerateOptions` The qr code encoding options.
`id`		`string` The unique identifier of the machine.
`ids`		`Partial<{ root: string; frame: string }>` The element ids.
`onValueChange`		`(details: ValueChangeDetails) => void` Callback fired when the value changes.
`pixelSize`		`number` The pixel size of the qr code.
`value`		`string` The controlled value to encode.

DownloadTrigger

Prop	Default	Type
`fileName` *		`string` The name of the file.
`mimeType` *		`DataUrlType` The mime type of the image.
`asChild`		`boolean` Use the provided child element as the default rendered element, combining their props and behavior. For more details, read our Composition guide.
`quality`		`number` The quality of the image.

Introduction