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

# Image QR code

> Show one image or a gallery of up to 10 images with a scan.

An Image QR code shows pictures you upload to GetQR. Upload one image to open it directly, or up to 10 images to show them as a gallery.

## Before you start

* Have your images ready. Each image can be up to 5 MB.
* PNG, JPG, GIF and WEBP work. iPhone HEIC photos are converted to JPG automatically when you upload them.

## Create it

<Steps>
  <Step title="Open the QR code builder">
    Click **Create QR** in the sidebar.
  </Step>

  <Step title="Choose Image">
    In **Choose QR type**, click **Image**.
  </Step>

  <Step title="Upload your images">
    Click the upload area or drag your images onto it. You can select several at once.
  </Step>

  <Step title="Add more images (optional)">
    Click **Add more images** to add up to 10 in total.
  </Step>

  <Step title="Put the images in order (2+ images)">
    Drag the image tiles to reorder them. This is the order people see.
  </Step>

  <Step title="Choose a gallery layout (2+ images)">
    Under **Gallery layout**, pick **Grid**, **Collage** or **Feed**.
  </Step>

  <Step title="Add a gallery title (2+ images, optional)">
    Type a title in **Gallery title (optional)**, for example "Summer collection 2026".
  </Step>

  <Step title="Name your QR code (optional)">
    Type a name in **Name your QR Code**. Only you see it.
  </Step>

  <Step title="Go to the design step">
    Click **Next** once all images finish uploading.
  </Step>

  <Step title="Design and create">
    Customize the design (see [Design overview](/design/overview)), then click **Create QR**.
  </Step>
</Steps>

<Tip>
  With 2 or more images, tap any image in the preview to see the full view, the same way people will.
</Tip>

## Settings

| Setting | What it does |
| - | - |
| **Images** | Required. Up to 10 images, up to 5 MB each. PNG, JPG, GIF and WEBP; HEIC photos are converted to JPG. |
| **Gallery layout** | Shown when you upload 2 or more images. **Grid**, **Collage** or **Feed**. Default: **Grid**. |
| **Gallery title (optional)** | Shown when you upload 2 or more images. Up to 40 characters. If empty, the page is titled **Gallery**. |
| **Name your QR Code** | Optional, up to 40 characters. Only you see it. Default: **My Image QR Code**. |
| **Custom short link** | Optional. Lets you choose the end of the short link, 3–15 characters. You can't change it after the QR code is created. |

## What people see when they scan

* **One image.** The image opens directly in the phone's browser.
* **Two or more images.** A gallery page opens with your title, the number of images and your chosen layout. People tap an image to see the full view and move to the previous or next image. They can **Download** one image or **Download all**.

Scans go through a GetQR short link, so they're counted in [analytics](/analytics/overview), and you can replace the images later without reprinting the code.

## Use cases

* Product photos or a lookbook on a shop window or catalog.
* Event and wedding photos shared on a table card.
* A portfolio on a business card or flyer.
* Before/after photos at a salon or clinic.
* Floor plans or maps at a venue.

## Common issues

<AccordionGroup>
  <Accordion title="Image file size must be less than 5MB">
    One of your images is over 5 MB. Resize or compress it, then upload it again. Oversized files are skipped and listed under the upload area.
  </Accordion>

  <Accordion title="A file was skipped as 'not an image'">
    Only image files are accepted. Save the file as PNG, JPG, GIF or WEBP first.
  </Accordion>

  <Accordion title="We couldn't read this image">
    The file may be damaged or in a format the browser can't open. Try a PNG, JPG, SVG, WebP or HEIC file.
  </Accordion>

  <Accordion title="Too many files. Remove some images to continue.">
    You can add up to 10 images. Remove some, or split them across two QR codes.
  </Accordion>

  <Accordion title="I don't see the gallery options">
    **Gallery layout** and **Gallery title (optional)** only appear when you upload 2 or more images.
  </Accordion>

  <Accordion title="We couldn't reach our upload server">
    Check your internet connection. If you use an ad blocker, antivirus or VPN, allow getqr.com and try again.
  </Accordion>
</AccordionGroup>

## What's next

<CardGroup cols={2}>
  <Card title="Design your QR code" href="/design/overview" />

  <Card title="Print your QR code" href="/downloads/printing" />

  <Card title="Share documents instead" href="/qr-types/pdf" />

  <Card title="Share a video" href="/qr-types/video" />
</CardGroup>


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