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

# QR code design options in ShortPen

> Every QR code design option in ShortPen: colors, pattern shapes, eyes, logo, frame and text, the live preview and scan check, and what is on the Free plan vs paid plans.

**Short answer:** Open the **Design** section of any QR code to set the **Pattern**, **Eyes**, **Logo** and **Frame and text**. The **Real-time preview** updates as you edit, and a scan check under it tells you if the design will scan. Colors and logos are on every plan. All shapes, eyes and frames are on paid plans.

## Where to find the designer

The designer is the same everywhere you create a QR code:

* **QR Codes** → **New QR code** → **Design**
* **Links** → **New link** → **QR code** section, after you switch on **Enable QR code for this link**

It works the same for every content type (Link, PDF, Text, Wi-Fi, vCard and the others).

The **Design** section shows a **Templates** list first, then four cards: **Pattern**, **Eyes**, **Logo** and **Frame and text**.

> [!NOTE]
>
> **Learn more**: [How to save and use QR design templates in ShortPen](https://shortpen.com/docs/link-management/qr-code/qr-design-templates.md)

## Pattern

* **Main color**: the color of the code's pattern. Any color.
* **Background color**: any color, or **Transparent**.
* **Shape style**: the shape of the small modules that make up the code. 9 styles: Square, Smooth, Horizontal lines, Vertical lines, Rounded dots, Spaced squares, Classy, Diamonds, Faceted.

## Eyes

The eyes are the three big squares in the corners of the code.

* **Eye frame shape**: the outer square. 7 shapes: Square frame, Rounded frame, Circle frame, Drop frame, Leaf frame, Pointed frame, Soft frame.
* **Eye ball shape**: the inner square. 10 shapes: Square ball, Rounded ball, Circle ball, Drop ball, Leaf ball, Star ball, Diamond ball, Sunburst ball, Sparkle ball, Octagon ball.
* **Eye frame color** and **Eye ball color**: both start as **Match main color**, so they follow the main color. You can set each one to any color.

## Logo

* **No logo**
* **Organization logo**: the logo set in your [organization settings](https://shortpen.com/docs/organization-management/organization-settings.md).
* **Upload**: click **Add logo image** and pick a PNG, JPG or SVG file.

## Frame and text

* Frame: **No frame**, **Bottom label**, **Top label**, **Bottom banner**, **Top banner** or **Balloon**.
* **Frame phrase**: the text in the frame, up to 24 characters. The default is `SCAN ME`.
* **Frame color** and **Text color**.

## Default design

A new QR code starts with the plainest design: black square pattern, square eyes in the same color, white background, no logo and no frame.

## Live preview

The **Real-time preview** card updates while you edit.

> [!NOTE]
>
> For Link and PDF QR codes, the preview encodes a sample address, not your link. The real QR code exists only after you save.

## Scan check

Under the preview, a scan check rates the design:

| Result | What it means |
| - | - |
| **Scans reliably** | No issues found. |
| **Test before printing** | It should scan, but something is borderline. Test it with a few phones before you print. |
| **Won't scan reliably** | Fix the issue before you use the code. |

The check looks at the contrast between pattern and background, the pattern and eye shapes, the logo size, and the margin around the code. Each warning names the main issue in one sentence, for example:

* "Pattern and background are too close in color."
* "Logo covers 22% of the code. Small prints may not scan." (the number depends on your logo)
* "Light code on a dark background. Some scanners struggle."
* "This pattern is harder for some scanners."

Click the info icon next to the result to see the technical detail.

> [!NOTE]
>
> **Learn more**: [Best practices for QR Codes in offline campaigns](https://shortpen.com/docs/link-management/qr-code/qr-best-practices.md)

## Free plan vs paid plans

| Option | Free plan | Paid plans |
| - | - | - |
| Colors (main, background, eyes, frame, text) | All | All |
| Logo (none, organization, upload) | All | All |
| Shape style | Square, Smooth | All |
| Eye frame shape | Square frame, Rounded frame | All |
| Eye ball shape | Square ball, Rounded ball | All |
| Frame | No frame, Bottom label | All |

### What you see on the Free plan

* Paid options have a gold lightning badge. You can still select them and see them in the preview.
* When you select one, the card shows "This shape is on paid plans" (or "This style..." or "This frame...") with an **Upgrade** button.
* While the design has a paid option, the preview encodes a placeholder text instead of your content, so a screenshot of the preview doesn't work as a QR code.
* If you save with a paid option, the **This QR code uses paid styles** popup lists them under **Paid styles in this design:**. Click **Back** to change the design, or **Upgrade** to see the plans.

### After a downgrade to the Free plan

* Existing QR codes keep their design and keep working.
* When you edit one of them, it keeps the paid options it already has. You can't switch to a different paid option.

> [!NOTE]
>
> **Learn more**: [Understanding ShortPen plans and limits](https://shortpen.com/docs/account-billing-security/plans-and-limits/plans-and-limits.md)

## Downloads

Download the QR code as **SVG** (best for print, scales without loss) or **PNG** from the popup after you save, or from **Preview QR code** in the links and QR code lists. The design is part of the file.

If you change the design later, only new downloads change. The encoded link stays the same, so printed codes keep scanning.

> [!NOTE]
>
> **Learn more**: [How to download and use QR Codes in ShortPen](https://shortpen.com/docs/link-management/qr-code/qr-downloading.md)

## FAQ

> [accordion] Can I try paid shapes on the Free plan?
>
> Yes. Select any shape, eye or frame and preview it as much as you want. You need a paid plan to save the QR code with it.

> [accordion] Why doesn't a screenshot of the preview scan?
>
> For Link and PDF QR codes, the preview encodes a sample address until you save. On the Free plan, a design with a paid option encodes a placeholder text. Save the QR code and download it instead.

> [accordion] Do I need to reprint after changing the design?
>
> No. The design changes the look, not the encoded content. Reprint only if you want printed codes to match the new look.

> [accordion] Can I reuse a design on other QR codes?
>
> Yes, with a QR design template on a paid plan. See [How to save and use QR design templates in ShortPen](https://shortpen.com/docs/link-management/qr-code/qr-design-templates.md).

## Related links

* [How to create and customize QR Codes in ShortPen](https://shortpen.com/docs/link-management/qr-code/qr-creation.md)
* [How to save and use QR design templates in ShortPen](https://shortpen.com/docs/link-management/qr-code/qr-design-templates.md)
* [How to download and use QR Codes in ShortPen](https://shortpen.com/docs/link-management/qr-code/qr-downloading.md)
* [Best practices for QR Codes in offline campaigns](https://shortpen.com/docs/link-management/qr-code/qr-best-practices.md)
* [Understanding ShortPen plans and limits](https://shortpen.com/docs/account-billing-security/plans-and-limits/plans-and-limits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.