> ## Documentation Index
> Fetch the complete documentation index at: https://dub.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom QR codes

> Learn how custom QR codes work on Dub.

With Dub you customize your short link QR codes, giving you many options to make it your own. This can be done during link creation or editing your link later.

<Frame>
  <img src="https://mintcdn.com/dub/pckRVvXJzJuR6SQM/images/dub-partners/qrcode.png?fit=max&auto=format&n=pckRVvXJzJuR6SQM&q=85&s=3ff885267e1eb9ef45cffc70c3d18967" alt="Default QR Code editor" width="2014" height="1712" data-path="images/dub-partners/qrcode.png" />
</Frame>

## Logo controls

<Tip>
  This feature is only available on [Pro plans and
  above](https://dub.co/pricing).
</Tip>

With a paid plan, Dub gives you the ability to hide or show your logo on the QR code. For free users, the Dub logo will be shown by default and cannot be removed.

<Frame>
  <img src="https://mintcdn.com/dub/pckRVvXJzJuR6SQM/images/dub-partners/qrcode-logo.png?fit=max&auto=format&n=pckRVvXJzJuR6SQM&q=85&s=33caeb5de41b31bc5d42eece60ecfa9c" alt="QR Code logo controls" width="2014" height="1092" data-path="images/dub-partners/qrcode-logo.png" />
</Frame>

If you'd like to remove the Dub logo/upload your own, please consider [upgrading to a Pro plan](https://dub.co/pricing#how-to-upgrade-to-pro) to support us. Thank you!

### Setting a custom QR code logo

There are two ways to set a custom QR code logo:

* [For your entire workspace](#set-a-custom-qr-code-logo-for-your-entire-workspace) – applies to all short links under your workspace
* [For a specific domain](#set-a-custom-qr-code-logo-for-a-specific-domain) – applies to all short links under this domain

<Tip>
  If a custom QR code logo is set for both your workspace and a domain, the
  custom QR code logo for the domain will take precedence.
</Tip>

#### Option 1: Set a custom QR code logo for your entire workspace

To set a custom QR code logo for your entire workspace, you'll need to set your workspace's logo first by following the steps below:

1. Go to your [workspace settings page](https://app.dub.co/settings) by clicking on the **Settings** tab in the sidebar.
2. Scroll down to the **Workspace Logo** section and upload your company's logo. We recommend using a square image for the best results.

<Frame>
  <img src="https://mintcdn.com/dub/pckRVvXJzJuR6SQM/images/dub-partners/qrcode-workspace-logo.png?fit=max&auto=format&n=pckRVvXJzJuR6SQM&q=85&s=498b8cae018caef0e954baf01faf26cd" alt="Workspace Logo section" width="2014" height="1556" data-path="images/dub-partners/qrcode-workspace-logo.png" />
</Frame>

Once you've set your workspace's logo, your QR code will automatically update to use your workspace's logo.

#### Option 2: Set a custom QR code logo for a specific domain

If you manage multiple brands/products on Dub, you can set custom QR code logos for each of them for better brand recognition.

<Frame>
  <img src="https://assets.dub.co/changelog/custom-qr-code-logo.jpg" alt="Set custom QR code logos for your domains" />
</Frame>

To set a custom QR code logo for a specific domain, you'll need to follow the steps below:

1. Go to your [workspace Domains settings tab](https://app.dub.co/domains).
2. Click on the `⋮` button next to the domain you want to set a custom not found URL for.
3. Select **Edit Domain** to edit the domain settings.
4. Toggle the **Custom QR code logo** switch to enable it.
5. Upload your custom QR code logo. We recommend using a square image for the best results.
6. Click on the **Save changes** button to save the changes.

<Frame>
  <img src="https://assets.dub.co/help/domain-custom-qr-code-logo.png" alt="Setting a custom QR code logo for a custom domain" />
</Frame>

## QR code styling

Dub gives you the ability to customize the style of your QR code. You can customize the dot style, marker center, marker border, and colors of your QR code.

### Dot style

To change the dot style of your QR code, click on one of the three options below the QR code preview. You can choose between square, circles, and joined dot styles. The default dot style is square.

<Frame>
  <img src="https://mintcdn.com/dub/pckRVvXJzJuR6SQM/images/dub-partners/qrcode-dot.png?fit=max&auto=format&n=pckRVvXJzJuR6SQM&q=85&s=514ba77dc6bfc415badaf669c7009afd" alt="QR code dot style options" width="2014" height="1712" data-path="images/dub-partners/qrcode-dot.png" />
</Frame>

### Marker center

To change the marker center style of your QR code, click on one of the two options below the QR code preview. You can choose between square, or circle center styles. The default marker center style is square.

<Frame>
  <img src="https://mintcdn.com/dub/pckRVvXJzJuR6SQM/images/dub-partners/qrcode-markercenter.png?fit=max&auto=format&n=pckRVvXJzJuR6SQM&q=85&s=78d704a32c9b92325bf7312cd93a3989" alt="QR code marker center style options" width="2014" height="1712" data-path="images/dub-partners/qrcode-markercenter.png" />
</Frame>

### Marker border

To change the marker border style of your QR code, click on one of the three options below the QR code preview. You can choose between square, rounded, or circle border styles. The default marker border style is square.

<Frame>
  <img src="https://mintcdn.com/dub/pckRVvXJzJuR6SQM/images/dub-partners/qrcode-markerborder.png?fit=max&auto=format&n=pckRVvXJzJuR6SQM&q=85&s=e351529de41a3c70e7dabab2ad2e894d" alt="QR code marker border style options" width="2014" height="1712" data-path="images/dub-partners/qrcode-markerborder.png" />
</Frame>

### Colors

Dub gives you the ability to edit both the dot and marker colors of your QR code. To change the colors of your QR code, you can either enter a custom hex color code or use the color palette picker. The default dot and marker color is black (#000000).

<Frame>
  <img src="https://mintcdn.com/dub/pckRVvXJzJuR6SQM/images/dub-partners/qrcode-color.png?fit=max&auto=format&n=pckRVvXJzJuR6SQM&q=85&s=013b2d8fa85f20d9474f90ea88758a2f" alt="QR code color options" width="2014" height="1712" data-path="images/dub-partners/qrcode-color.png" />
</Frame>

By default, the dot and marker colors will be synced, but if you select a different color for the marker, they will be unsynced. If you want to sync the colors again, simply click on the **Match dot color** button above the marker color picker.

<Frame>
  <img src="https://mintcdn.com/dub/pckRVvXJzJuR6SQM/images/dub-partners/qrcode-colormatch.png?fit=max&auto=format&n=pckRVvXJzJuR6SQM&q=85&s=bfbc3c7257bef9526b1a71dbb0e4faeb" alt="QR code color match" width="2014" height="1712" data-path="images/dub-partners/qrcode-colormatch.png" />
</Frame>

## Programmatically creating QR codes

Once you've set a custom QR code logo, you can use our [QR Code API](/docs/api-reference/endpoint/retrieve-a-qr-code) to create QR codes programmatically as well.

On our Pro plans and above, you can choose to include your logo in the generated QR codes or hide it if you want.

* If your workspace has a logo set, your QR codes will automatically have that logo as well, but you can choose to hide it using the `hideLogo` prop ([example](https://api.dub.co/qr?url=https://d.to/try?qr=1))
* If your workspace has no logo set, your QR codes will have no logo.
* Alternatively, you can also pass a custom logo in your QR codes using the `logo` prop ([example](https://api.dub.co/qr?url=https://d.to/try?qr=1\&logo=https://assets.dub.co/wordmark-square.png)).

## Downloading you QR code

To download your QR code, click the **Download** button in the top right of the editor and select your format. You're able to download your QR code in SVG, PNG, or JPG formats.

<Frame>
  <img src="https://mintcdn.com/dub/pckRVvXJzJuR6SQM/images/dub-partners/qrcode-download.png?fit=max&auto=format&n=pckRVvXJzJuR6SQM&q=85&s=90cdb998d1a6500e5a211dd95ba36ebc" alt="Downloading your QR code" width="1112" height="624" data-path="images/dub-partners/qrcode-download.png" />
</Frame>

## Copying your QR code

To copy your QR code, click the **Copy** button in the top right of the editor. You're able to copy the image version of your QR code, or the URL of the QR code image.

<Frame>
  <img src="https://mintcdn.com/dub/pckRVvXJzJuR6SQM/images/dub-partners/qrcode-copy.png?fit=max&auto=format&n=pckRVvXJzJuR6SQM&q=85&s=aaee248c5479f5fcee0e441b17734f94" alt="Copying your QR code" width="1112" height="624" data-path="images/dub-partners/qrcode-copy.png" />
</Frame>
