# QuiQR Codes > Full documentation content for QuiQR Codes --- # Default ## Getting started ### Overview **URL:** https://quiqrcodes.mantledocs.com/overview In this area, you’ll find guidance on how to install and configure QuiQR for use. --- ## Features ### Features Overview **URL:** https://quiqrcodes.mantledocs.com/features-overview In this area, you’ll find guidance on the available features within QuiQR and how to use them. --- ### QR code to a product page **URL:** https://quiqrcodes.mantledocs.com/qr-code-to-a-product-page ## Overview: create a QR code that opens a product page In **QuiQR Codes**, you can create a QR code that sends customers to a specific product in your Shopify store. This guide follows the in-app flow from the dashboard to selecting a product and downloading your QR code. ![QuiQR Codes dashboard showing stats tiles and the Setup Guide with a Create QR Code button](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/309dc7ba-2849-432f-b0bd-264d141fb1cf/frame_001.jpg) ## 1. Start from the Dashboard From your Shopify admin, open **Apps** → **QuiQR Codes** to land on the **Dashboard**. This screen shows quick stats like **Total QR Codes**, **Active Codes**, **Archived Codes**, and **Total Scans**. To begin creating a product QR code, select **Create QR Code** (top right). If you see a **Setup Guide** card on the dashboard, it also points you to **Create QR Code** and summarises what you’ll fill in (name, description, action, and preview). ## 2. Open the Create QR Code form You’ll be taken to **Manage Codes** → **Create QR Code**. The form is on the left, and a live **Preview** of the QR code is on the right. ![Create QR Code page with Name and Description fields, Action set to Product, Browse Products button, and a QR code preview](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/bf1d5fcd-3f96-46d1-925d-3a427973f406/frame_002.jpg) ## 3. Fill in the QR code details In **Name ***, enter a clear internal name (for example, `My Product QR Code`). This helps you find the code later in **Manage QR Codes**. Use **Description (Optional)** to note where you’ll use the code (flyer, product packaging, shelf tag). The field shows a character counter (up to 200). Use a naming convention like `Product – Location – Month` (for example, `Branded Baseball Cap – In-store display – Mar`) so scan results are easier to interpret later. ## 4. Choose “Product” and select what to link to In **Action ***, keep **Product** selected. This makes the QR code open a product page in your store when scanned. Under **Select Product ***, choose **Browse Products**, then pick the product you want the QR code to link to. After selection, the product appears in the form, and the button changes to **Change Product**. You can also use **Clear** to remove the selected product. ![Create QR Code form showing a selected product under Select Product and the QR preview on the right](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/8fb2aea0-4eaf-46d5-b12f-e8de2f217556/frame_004.jpg) ## 5. Save, then download your QR code Select **Save** in the top bar to store the QR code in QuiQR Codes. (If needed, you can select **Discard** to abandon changes.) In the **Preview** panel, choose a file type from **Format** (for example, **SVG**), then select **Download QR Code**. For reliable scanning, avoid low-contrast colour combinations. If you customise **Background colour** and **Foreground colour**, keep a strong contrast between them. ## Quick checks before you print - **Test scan:** scan the downloaded QR code with your phone to confirm it opens the correct product page. - **Right product:** verify the product shown under **Select Product** matches what you intended (use **Change Product** if not). - **Keep it readable:** if you change colours, re-test scanning after the change. ## If the QR code scans but the product doesn’t open - Confirm the product is **Active** (not draft/archived) and is available on the **Online Store** sales channel. - If your store has an **online store password** enabled, customers will be prompted for it when scanning. - Try scanning on a device that is **not logged into** your Shopify admin to simulate a customer experience. --- ### QR code to a collection page **URL:** https://quiqrcodes.mantledocs.com/qr-code-to-a-collection-page ## Overview: create a QR code that opens a collection page In **QuiQR Codes**, you can create a QR code that sends customers to a specific **collection** in your Shopify store. This guide follows the same flow you see in the app - from the **Dashboard** to saving and downloading your code. ![QuiQR Codes dashboard showing stats tiles and a Create QR Code button](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/2d84e0db-4d39-4ee3-8156-6da5ac7c8a5f/frame_001.jpg) ## 1) Start from the Dashboard From your Shopify admin, open **Apps** → **QuiQR Codes** to land on the **Dashboard**. This screen shows quick stats like **Total QR Codes**, **Active Codes**, **Archived Codes**, and **Total Scans**. To begin, select **Create QR Code** (top right). If you see the **Setup Guide** card on the dashboard, it also directs you to **Create QR Code** and outlines the fields you’ll complete. ## 2) Open the Create QR Code form You’ll be taken to **Manage Codes** → **Create QR Code**. The form is on the left and a live **Preview** of the QR code is on the right. ![Create QR Code page with Name and Description fields, Action dropdown, and a QR code preview panel](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/adcfa7d4-6555-4871-89b3-2bc3b2aa56b6/frame_002.jpg) ## 3) Add a name and (optional) description In **Name ***, enter a clear internal name (for example, `My Collection QR Code`). This helps you find it later in **Manage QR Codes**. Use **Description (Optional)** to note where you’ll use the code (poster, shelf sign, packaging). The field shows a character counter (up to 200). Use a consistent naming pattern like `Collection – Location – Month` so scan results are easier to interpret later. ## 4) Link the QR code to a collection Open the **Action *** dropdown and select **Collection**. The form updates to show **Select Collection ***. Under **Select Collection ***, select **Change Collection** to open the **Select collection** modal. ![Select collection modal with Search collections field and Select button](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/72f91ff8-7d02-4317-832a-d714fbe34e9f/frame_004.jpg) In the **Select collection** modal: - Use **Search collections** to find the collection (optional). - Tick the checkbox next to the collection you want. - Select **Select** to confirm. You’ll return to the Create QR Code page, and the chosen collection appears under **Select Collection**. The **Preview** updates to match your selection. ![Create QR Code form with Action set to Collection and a selected collection shown under Select Collection](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/61a8aae6-a0c7-431f-8026-f5d8cc4df5cf/frame_005.jpg) If you picked the wrong collection, select **Change Collection** to choose a different one, or use **Clear** to remove the current selection. ## 5) Save, then download your QR code Select **Save** in the top bar to create the QR code. (Use **Discard** if you don’t want to keep your changes.) In the **Preview** panel, choose a file type from **Format** (for example, **SVG**), then select **Download QR Code**. ![Edit QR Code page showing selected collection, QR preview, Format dropdown, and Download QR Code button](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/4ae4ec0c-ef2b-460f-973b-0583f8cce2f8/frame_006.jpg) For reliable scanning, keep strong contrast between **Background colour** and **Foreground colour**. If you customise colours, always re-test the QR code before printing. ## Quick checks before you print - **Test scan:** scan the downloaded QR code with your phone and confirm it opens the correct collection page. - **Confirm selection:** verify the collection name shown under **Select Collection** is correct (use **Change Collection** if not). - **Print size:** if you’re printing small labels, do a test print and scan from the expected distance. --- ### QR code to add to cart + discount **URL:** https://quiqrcodes.mantledocs.com/qr-code-add-to-cart-discount ## What you’ll build In **QuiQR Codes**, you can create a QR code that sends customers to your store with a product already added to their cart and an optional discount code applied. The steps below follow the same flow as the in-app walkthrough: start from the Dashboard, open **Create QR Code**, choose **Add to Cart**, select a product variant, then enter a discount and save. ## 1. Start from the QuiQR Codes dashboard In Shopify admin, open **Apps** → **QuiQR Codes**. The **Dashboard** shows quick stats (like **Total QR Codes** and **Total Scans**) and a **Setup Guide** with a shortcut to create your first code. ![QuiQR Codes dashboard showing Create QR Code button, statistics cards, and Setup Guide](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/4a43adff-9be4-4a71-93a9-b321091c0147/frame_001.jpg) ## 2. Create a new QR code From the Dashboard, click **Create QR Code**. (You can also find it from **Manage QR Codes**.) On the **Create QR Code** page, fill in: - **Name** (required) — used to identify the code in **Manage QR Codes**. - **Description (Optional)** — helpful for campaign notes, placement, or intent. As you edit, the **Preview** panel updates on the right. ![Create QR Code page with Name and Description fields and a QR Preview panel](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/fbe2e1f6-1714-4efa-ba1a-73db3cdd79c8/frame_002.jpg) ## 3. Choose the “Add to Cart” action In the **Action** dropdown, select **Add to Cart**. The **Action** menu includes options like **Product**, **Collection**, **Add to Cart**, and **Custom Page**. For this walkthrough, choose **Add to Cart** so scanning the QR code preloads a cart with the item. ## 4. Select the product variant to add Under **Select Product**, click **Browse Products** (or **Change Product** if one is already selected). In the **Select product** modal, you can search using **Search products**, then check the item you want and click **Select**. ![Select product modal with search field, product list, and Select button](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/ffeb66d9-16f2-419d-ac42-ccdfdff9f99e/frame_004.jpg) After selecting, the product appears in the form under **Select Product**. When using **Add to Cart**, the form may show the reminder **Only select one variant.** Make sure you choose a single product variant (not multiple variants) so the QR code adds the correct item. ![Create QR Code form showing Action set to Add to Cart, a selected product variant, and the Discount (Optional) field](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/5c819b9b-866a-48a6-a56b-be96d41fef60/frame_005.jpg) ## 5. Add a discount code (optional) In **Discount (Optional)**, enter the discount code you want applied when the QR code is scanned (for example, `50OFF`). Use a code that already exists in Shopify under **Discounts**, and double-check spelling and capitalisation so it applies correctly. ![Discount (Optional) field filled in and Save button visible in the top bar](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/4c8afb95-370c-43d0-adc9-23430aac2dac/frame_006.jpg) ## 6. Save the QR code When you’re done, click **Save** in the top bar. If you need to abandon changes, use **Discard**. After saving, you can return to **Manage QR Codes** to find your code later and track performance on the Dashboard (for example, **Total Scans**). ## What happens when customers scan - The QR code opens your store and adds the selected product variant to the cart (because **Action** is set to **Add to Cart**). - If you entered a value in **Discount (Optional)**, the code is included so the discount can be applied during the customer’s checkout flow (as long as it’s valid and eligible). - Confirm the code exists in Shopify under **Discounts** and is currently active. - Make sure the code exactly matches what you entered in **Discount (Optional)**. - Check discount eligibility rules (for example, minimum purchase requirements, product eligibility, usage limits, or expiration). - Verify the selected item under **Select Product** is the correct *variant*. - If needed, click **Change Product** to reselect. - Follow the in-form guidance: **Only select one variant.** --- ### QR code for a discount **URL:** https://quiqrcodes.mantledocs.com/qr-code-for-a-discount ## What this QR code does In QuiQR Codes, you can create a QR code that applies a discount when a customer scans it. To do this, choose **Discount code** in the **Action** dropdown, then enter the discount in the **Discount code** field. When the QR code is scanned, the customer is taken through a flow where the discount is added to their order. The **Discount code** action is only available to stores on the **Core** plan. ## Where to create it In Shopify admin, open **Apps** → **QuiQR Codes**. From the app dashboard, click **Create QR Code**. Or open **Manage QR Codes** and select an existing code to edit it. ![Create QR Code page in QuiQR Codes showing the Action dropdown set to Discount code and the Discount code field.](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/e0019ba2-db4f-471c-8986-5db7fcdf7742/Screenshot_2026-08-06_at_08.53.44.png) ## Create a discount QR code Go to QuiQR Codes and click **Create QR Code**. This opens the **Create QR Code** page. Fill in the basic details for the QR code: - **Name** — required. This is how the code appears in **Manage QR Codes**. - **Description (Optional)** — add internal notes about the campaign, placement, or offer. In the **Action** dropdown, select **Discount code**. As soon as you choose this option, QuiQR Codes shows an extra field for the discount. In the **Discount code** field, enter the Shopify discount code you want customers to use. Make sure the code is entered exactly as it exists in Shopify. Use the **Preview** panel on the right to confirm the QR code is being generated, then click **Save** in the top bar. If you do not want to keep your changes, click **Discard**. ## Edit an existing discount QR code If you already have a QR code and want to change its discount: 1. Open **Manage QR Codes**. 2. Select the QR code you want to update. 3. On the edit screen, set **Action** to **Discount code**. 4. Update the **Discount code** field. 5. Click **Save**. ## What customers experience When a customer scans the QR code, the discount code is applied to their order flow using the discount you entered in QuiQR Codes. The QR code only works as expected if the discount code is valid and active in your Shopify store. ## Tips for best results - Create the discount in Shopify first, then copy the exact code into QuiQR Codes. - Use a clear **Name** so you can find the code later in **Manage QR Codes**. - Check the **Preview** before saving, especially if you are creating multiple campaign codes. ## Troubleshooting Check that the discount code is active in Shopify and entered exactly the same way in QuiQR Codes. If the code was changed or expired in Shopify, update it in QuiQR Codes and save again. Review the fields you entered, especially the **Action** and **Discount code** fields. If needed, re-enter the discount code and confirm the preview updates before saving. --- ### QR code for a POS Discount **URL:** https://quiqrcodes.mantledocs.com/pos-discount-qr-codes ## What this action does The **POS Discount** action lets you create a QR code that applies a Shopify discount code to an eligible **Shopify POS** order when it is scanned. **POS Discount** is available on the **Core** plan only. When you select **POS Discount** in the **Action** dropdown, a **Discount code** field appears. Enter the Shopify discount code you want the QR code to apply at checkout. ## Before you start - Make sure your app is upgraded to the **Core** plan. - Create the discount first in Shopify under **Discounts**. - Confirm the discount is valid for the POS order you want to use it with. ## Create a POS Discount QR code In Shopify admin, go to **Apps** → **QuiQR Codes**. From the app, you can start on the **Dashboard** and click **Create QR Code**, or open **Manage QR Codes** and create a new code there. On the **Create QR Code** page, complete the **Name** field. You can also fill in **Description (Optional)** to note where the code will be used or which promotion it belongs to. The **Preview** panel on the right updates as you build the code. In the **Action** dropdown, select **POS Discount**. After you choose this action, the **Discount code** field appears below it. ![Create QR Code page in QuiQR Codes with the Action set to POS Discount and the Discount code field visible](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/900df384-64b9-4e79-a179-f31d117f1f3d/Screenshot_2026-08-06_at_09.08.06.png) In **Discount code**, enter the exact Shopify discount code you want to apply, such as `WELCOME10`. Enter the code exactly as it exists in Shopify, including the correct spelling and capitalisation. If needed, adjust the code design using options like **Background color** and **Foreground color**. When you're ready, click **Save** in the top bar. If you want to leave without keeping changes, click **Discard**. ## Edit an existing code You can also add or update the **POS Discount** action on an existing code. In Shopify admin, go to **Apps** → **QuiQR Codes** → **Manage QR Codes**. Select the existing QR code you want to edit. Set **Action** to **POS Discount**, enter the value in **Discount code**, then click **Save**. ## What happens when the code is scanned When the QR code is scanned in **Shopify POS**, Shopify uses the encoded discount URL and applies that discount to an applicable POS order. The discount only applies if the Shopify discount code is valid and the order meets that discount's eligibility rules, such as product restrictions, minimum purchase requirements, usage limits, or active dates. If you create and download / print a code, and then change the discount code associated with it later, the downloaded and printed code will continue to point to the original destination. Scans of POS Discount QR codes are not tracked and added to dashboard metrics such as **Total Scans.** ## Troubleshooting - Make sure the discount code exists in Shopify under **Discounts**. - Check that the code is active and spelled exactly as entered in **Discount code**. - Confirm the POS order qualifies for that discount. **Scans are not tracked in Quiqr** for **POS Discount**, because the QR code encodes the Shopify POS discount URL directly. --- ### QR code to a custom URL **URL:** https://quiqrcodes.mantledocs.com/qr-code-to-a-custom-url Use **QuiQR Codes** in Shopify to create a QR code that opens any website you choose (for example, your storefront homepage). ![QuiQR Codes dashboard with setup guide and Create QR Code button](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/655df69f-3548-4a5a-95f3-aa578823fcaa/frame_001.jpg) ## 1. Open the QR code creator In the Shopify admin sidebar, open **Apps** and select **QuiQR Codes**. From the **Dashboard**, select **Create QR Code** (top-right). You can also use the setup guide card if it’s shown. ## 2. Fill in the QR code details ![Create QR Code form with Name and Description fields and a Preview panel](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/a698ad1f-9fb3-4d67-a043-475186c0da83/frame_002.jpg) In **Name**, type a recognisable label (for example: *Homepage QR*). This helps you find the code later under **Manage QR Codes**. Use **Description (Optional)** to note where the QR code will be used (flyer, packaging insert, store sign, etc.). The **Preview** panel updates as you configure your QR code, so you can visually confirm you’re creating the right code before saving. ## 3. Set the action to Custom Page ![Action field set to Custom Page with Page URL input shown](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/3bacaf29-e359-4cff-9eb3-e824fd787fae/frame_004.jpg) In the **Action** field, open the dropdown. Select **Custom Page**. A **Page URL** field appears. ## 4. Paste your custom URL ![Page URL field filled with a custom https URL and preview visible](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/a0022d54-8592-4f47-8852-507265d05d24/frame_005.jpg) In **Page URL**, paste the full link you want customers to open (for example, `https://www.yourstore.com`). Check the **Preview** panel on the right to confirm the QR code updates after you enter the URL. Use a complete URL that includes `https://` to avoid scan issues on some devices. If your link is long, consider using a short, trackable link you control before pasting it into **Page URL**. ## 5. Review and save ![Final review of Create QR Code form with Custom Page action, Page URL set, and Save button](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/7f987406-5fcb-4f88-a7aa-f64f0f85df45/frame_006.jpg) - **Name** is correct and easy to recognise - **Action** is set to **Custom Page** - **Page URL** is correct (no typos) - The **Preview** looks ready Select **Save** in the top-right of the page. If you don’t want to keep your changes, select **Discard**. Always test the printed/placed QR code with a phone camera before distributing it widely. A small typo in **Page URL** will send customers to the wrong place. ## What happens after saving? After you save, your new QR code will be available under **Manage QR Codes**. From there, you can return to it later to manage your QR code campaign and access the code for downloading/usage. --- ### QR code to your homepage **URL:** https://quiqrcodes.mantledocs.com/qr-code-to-your-homepage ## Send customers to your homepage Use **QuiQR Codes** to create a QR code that opens your store homepage when someone scans it. This is useful for packaging inserts, posters, window stickers, and printed marketing where you want customers to land on your main storefront. This guide follows the app’s creation flow in Shopify: open **QuiQR Codes**, go to the **Dashboard**, select **Create QR Code**, complete the form, then select **Save**. ## Before you start Make sure your Shopify **Online Store** sales channel is set up and your homepage is live. The QR code will send customers to your storefront homepage, not to a specific product or collection. ## Create a homepage QR code In Shopify admin, open **Apps** and select **QuiQR Codes**. You’ll arrive on the **Dashboard**, where you may also see stats such as **Total QR Codes**, **Active Codes**, **Archived Codes**, and **Total Scans**. Select **Create QR Code** in the top-right of the **Dashboard**. You can also use the shortcut in the **Setup Guide** card if it is visible. On the **Create QR Code** screen, enter a clear label in **Name ***, such as `Homepage flyer QR` or `Storefront window QR`. If needed, add extra context in **Description (Optional)** so you can recognise the code later in **Manage QR Codes**. Open the **Action *** dropdown and select **Online Store (Homepage)**. This sets the QR code destination to your website homepage. Check the **Preview** panel on the right to confirm the QR code is ready. If you want, you can also adjust appearance settings such as **Background color** and **Foreground color** before saving. Select **Save** in the top bar to keep the QR code. If you do not want to keep your changes, select **Discard**. Use a descriptive name based on where the code will appear, such as `Homepage QR - Packaging Insert` or `Homepage QR - Store Counter`. This makes it easier to find the code later under **Manage QR Codes**. ## What happens after saving Once saved, the QR code is stored in **Manage QR Codes**. You can return to it later to manage the code and use it in your campaign materials. The app’s **Dashboard** can also help you monitor overall usage with tiles such as **Total QR Codes** and **Total Scans**. ## Best practices before printing - **Test the QR code first:** scan it with your phone before printing in bulk to confirm it opens your homepage. - **Use strong contrast:** if you customise **Background color** and **Foreground color**, keep the contrast high so the code remains easy to scan. - **Use the right destination:** choose **Online Store (Homepage)** when you want one general entry point to your site. If you want to send shoppers to a specific page instead, use a more targeted action. If your online store is password-protected, customers who scan the QR code may see the storefront password page instead of your homepage. ## When to use this action - General brand promotion - Retail signage - Packaging inserts - Event handouts - Printed materials where you want customers to start at your main storefront --- ### Customise a QR Code **URL:** https://quiqrcodes.mantledocs.com/customise-a-qr-code ## Overview: where customisation happens In **QuiQR Codes**, you customise a QR code from the **Edit QR Code** screen. As you update settings like colours and **Code Shape**, the **Preview** updates so you can confirm it still scans before downloading. ![QuiQR Codes dashboard showing total QR codes, active/archived counts, total scans, and a Create QR Code button](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/539c68ba-3112-4f72-bf14-797056e4c278/frame_001.jpg) ## 1. Start from the Dashboard From the **Dashboard**, you can quickly confirm you’re in the right store and app, and see high-level stats like **Total QR Codes**, **Active Codes**, **Archived Codes**, and **Total Scans**. - To create a brand-new code (instead of editing an existing one), select **Create QR Code** in the top-right. - To customise an existing code, go to the manager list next. ## 2. Open the QR Code Manager In the left navigation under **QuiQR Codes**, select **Manage QR Codes** to open the **QR Code Manager** list. ![Manage Codes page with the QR Code Manager table showing QR code name, action, info, status, and last updated](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/d4b47543-e356-4a42-b87f-2943318033ad/frame_002.jpg) The table helps you identify the right code using: - **Name** (your internal label for the code) - **Action** (what the QR code does, such as **Add to Cart**, **Collection**, **Product**, or **Custom**) - **Status** (for example, **Active** or **Archived**) - **Last Updated** If you have lots of codes, use **Add filter +** to narrow the list before you open the one you want to customise. ## 3. Enter Edit QR Code and confirm the basics Select the QR code you want to update to open **Edit QR Code**. ![Edit QR Code screen showing Name, Description, Action selection, a Preview panel, format dropdown, and a Download QR Code button](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/f285069a-7a67-4ce1-826d-4fc30f6b4b76/frame_003.jpg) On this page, review (and update if needed): - **Name** (required) - **Description (Optional)** - **Action** (required). For example, **Collection**. - If your action requires a target, choose it (for example, **Select Collection** with **Change Collection**). The **Preview** panel on the right shows what your QR code will look like as you customise it. ## 4. Customise the QR code design Scroll to the design section to update colours and shape. The **Preview** updates as you make changes. ![Edit QR Code customization section showing background and foreground color pickers and Code Shape options (Square, Circle) with an updated preview](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/301f4cdb-15ab-411d-bc1e-78048f86354a/frame_004.jpg) Under **Background colour**, enter a hex value (for example, `#FFFFFF`) or use the colour picker to choose a colour. Under **Foreground colour**, enter a hex value or use the colour picker. This controls the colour of the QR pattern itself. In **Code Shape**, select **Square** or **Circle** to change the style of the QR modules. High contrast matters. If the background and foreground colours are too similar, some devices may not be able to scan the code reliably. Always confirm the result in **Preview** before downloading. ## 5. Save, then download When you’re happy with the design: - Select **Save** in the top bar (you may also see **Discard** if there are unsaved changes). - In the **Preview** panel, choose a file type from **Format** (for example, **SVG**). - Select **Download QR Code**. If you no longer want a code available for use, select **Archive code** on the **Edit QR Code** page. Archived codes remain listed in the manager with an **Archived** status. --- ### Download a QR code **URL:** https://quiqrcodes.mantledocs.com/download-a-qr-code-png-or-svg ## Download a QR code file This guide shows where to find your saved QR codes and download them in **PNG** or **SVG** format. In your Shopify admin, open **Apps** → **QuiQR Codes** → **Manage QR Codes**. You’ll see the **QR Code Manager** list with each code’s **Name**, **Action**, **Status**, and **Last Updated**. ![QR Code Manager page showing a list of QR codes with status and last updated](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/2ddeac18-f446-4117-ab9f-905c10af9e14/frame_001.jpg) Click the QR code you want to export to open the **Edit QR Code** page. On the right side, in the **Preview** panel, find the **Format** dropdown and the **Download QR Code** button. ![Edit QR Code page with Preview panel showing Format dropdown options SVG and PNG and the Download QR Code button](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/a7168d21-0491-42b0-9ecd-83d1d2ce85e4/frame_002.jpg) In the **Preview** panel, open **Format** and select: - **PNG** for most uses (web, email, documents) - **SVG** for scalable, print-ready artwork (best for large signage) Click **Download QR Code**. Your browser will start downloading the file (for example, `my_add_to_cart_qr_code.png`) and it will appear in your browser’s downloads area. ![Browser download completed after clicking Download QR Code from the Edit QR Code page](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/38396a31-c5b7-4434-a980-a4dc3639e102/frame_003.jpg) **Best results for print:** Choose **SVG** when sending your QR code to a designer or print shop so it stays sharp at any size. ## Troubleshooting Make sure you’re on the **Edit QR Code** page (breadcrumb: **Manage Codes** › **Edit QR Code**) and look in the right-hand **Preview** panel. - Click **Download QR Code** again and check your browser’s downloads area. - Disable any browser pop-up/download blockers for your Shopify admin domain, then try again. **PNG** is best for quick sharing and most digital uses. **SVG** is best for professional design and printing because it scales without becoming blurry. Downloading a QR code exports the image file only. Your QR code settings (like **Action** and connected product/discount) remain unchanged. --- ### UTM tracking for QR codes **URL:** https://quiqrcodes.mantledocs.com/utm-tracking-for-qr-codes Use **UTM tracking** in QuiQR Codes to append campaign parameters to a QR code’s destination URL when it is scanned. This makes it easier to measure performance in third-party analytics tools such as Google Analytics. **Plan availability:** UTM tracking is available on the app’s **Core** plan. ## What UTM tracking does When UTM tracking is enabled, QuiQR Codes adds campaign parameters to the URL your QR code opens. This helps analytics tools identify where the visit came from and which campaign, placement, or promotion drove the scan. The available parameters are: - `utm_source` — Campaign source - `utm_medium` — Campaign medium - `utm_campaign` — Campaign name - `utm_term` — Campaign term - `utm_content` — Campaign content ## Before you start You can enable UTM tracking while creating a new QR code or by editing an existing one. - To create a new code, go to **Apps** → **QuiQR Codes**, then select **Create QR Code** from the **Dashboard**. - To update an existing code, go to **Apps** → **QuiQR Codes** → **Manage QR Codes**, then open the code you want to edit. UTM tracking does not replace your QR code’s destination. It adds tracking values to the existing destination URL when the code is scanned. ## Enable UTM tracking ![UTM tracking section in QuiQR Codes showing the Enable UTM tracking checkbox and campaign fields](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/e1a0b2f8-23c2-4c7d-96c0-f55a3472d870/Screenshot_2026-08-06_at_09.23.31.png) Start a new code from **Dashboard** → **Create QR Code**, or open an existing code from **Manage QR Codes**. In the **UTM tracking** section, select the **Enable UTM tracking** checkbox. Fill in **Campaign source (utm_source)**, **Campaign medium (utm_medium)**, and **Campaign name (utm_campaign)**. If needed, also fill in **Campaign term (utm_term)** and **Campaign content (utm_content)**. Select **Save** in the top-right corner to apply the UTM settings to the QR code. ## What to enter in each field - **Campaign source (utm_source)**: where the visitor came from, such as `qr`, `poster`, or `packaging`. - **Campaign medium (utm_medium)**: the channel, such as `offline`, `print`, or `in_store`. - **Campaign name (utm_campaign)**: the campaign or promotion name, such as `summer_sale`. - **Campaign term (utm_term)**: an optional extra label, often used for audience or keyword-style grouping. - **Campaign content (utm_content)**: an optional label to distinguish versions, placements, or creative variations. ## Example If your QR code sends shoppers to a summer promotion, you might use: - **Campaign source**: `qr` - **Campaign medium**: `print` - **Campaign name**: `summer_sale` - **Campaign term**: `store_window` - **Campaign content**: `blue_poster` When the code is scanned, QuiQR Codes appends these values to the destination URL so tools like Google Analytics can attribute the visit correctly. Use consistent lowercase naming, such as `summer_sale` instead of mixing formats like `SummerSale` and `summer-sale`. This keeps your analytics reports cleaner. ## Check that it’s working 1. Save the QR code. 2. Scan it with your phone. 3. Confirm the correct page opens. 4. Check the URL in your browser to make sure the `utm_` parameters are present. 5. Review your analytics tool for the new visit or campaign data. If you edit a QR code’s UTM settings, test the live code again after saving so you can confirm the latest parameters are being appended correctly. ## Best practices - Use different campaign names or content values for different placements, such as flyers, packaging inserts, or in-store signs. - Keep naming short and consistent so reports are easy to compare. - Always test a scan before printing or distributing a QR code widely. ## Related guides Create a QR code that opens a custom page or external link. Learn more about testing and troubleshooting QR code tracking in analytics tools. --- ### Bulk product QR codes **URL:** https://quiqrcodes.mantledocs.com/bulk-product-qr-codes ## Generate product QR codes in bulk QuiQR Codes lets you create QR codes for multiple products directly from the **Products** area in your Shopify admin. This is the fastest way to create a matching batch without opening the **Create QR Code** form for each product one by one. **Plan availability:** bulk product QR code generation is available on the app’s **Core** plan. Due to a Shopify limitation, you can generate a maximum of **50 QR codes at one time**. If you need more, repeat the process in additional batches. ## Before you start - Make sure you are working in the correct Shopify store. - Only select products you want to create new QR codes for in this batch. - If you want to use advanced options like **Enable UTM tracking** or **Custom logo**, review those settings before generating. The bulk generator creates product QR codes from the Shopify **Products** list. After generation, you can manage the new codes from **Apps** → **QuiQR Codes** → **Manage QR Codes**. ## Create QR codes for multiple products In your Shopify admin, select **Products** from the left-hand navigation. Use the checkboxes next to each product to choose the items you want to include in the batch. Once selected, Shopify shows the bulk action toolbar above the product list. ![Shopify Products page with multiple products selected and the Apps section showing Generate QR Codes in the More actions menu](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/55018d0d-0481-4580-b470-bab2e9e75d42/Screenshot_2026-08-06_at_09.48.34.png) In the bulk action toolbar, select the **more actions** menu (three dots). Scroll to **Apps**, then select **Generate QR Codes**. The **Generate QR Codes** pop-up opens and confirms how many products are selected. Use **Background colour** and **Foreground colour** to set the look of the batch. ![Generate QR Codes pop-up showing Background colour, Foreground colour, Advanced settings, Code shape, Enable UTM tracking, and Custom logo options](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/17f7cf09-b256-4ff5-ad5c-e9eb02018276/Screenshot_2026-08-06_at_09.51.41.png) Turn on **Advanced settings** to show more options for the batch. From here, you can: - change **Code shape** to **Square** or **Circle** - turn on **Enable UTM tracking** - turn on **Custom logo** When your settings are ready, select **Generate QR codes**. QuiQR Codes creates one product QR code for each selected product using the options from the pop-up. ## What the advanced options do ### Code shape Use **Code shape** to choose between **Square** and **Circle**. This changes the visual style of the QR code pattern for the whole batch. ### Enable UTM tracking **Enable UTM tracking** appends campaign parameters to each QR code’s destination URL when it is scanned. This is useful if you want to measure scans in analytics tools. In QuiQR Codes, the related UTM fields use the labels: - **Campaign source (utm_source)** - **Campaign medium (utm_medium)** - **Campaign name (utm_campaign)** - **Campaign term (utm_term)** - **Campaign content (utm_content)** ### Custom logo **Custom logo** lets you brand your QR codes with your store logo. ## After generation After the batch is created, open **Apps** → **QuiQR Codes** → **Manage QR Codes** to review and manage your new codes. In the **QR Code Manager**, you can identify codes by: - **Name** - **Action** - **Info** - **Status** - **Last Updated** If needed, you can open an individual code later to refine its settings from **Edit QR Code**. ## Best practices - Keep strong contrast between **Background colour** and **Foreground colour** for reliable scanning. - Test one of the generated codes on a phone before printing or sharing the full batch. - Split large jobs into logical groups if you are working near the 50-product limit. - Use consistent UTM naming so analytics reports stay clean and easy to compare. If you only need one product QR code, the standard [QR code to a product page](/features/qr-code-to-a-product-page) workflow gives you more step-by-step control over the individual setup. ## Related guides Create a single QR code that links directly to one Shopify product. Learn how background colour, foreground colour, and code shape work in QuiQR Codes. See how to add campaign tracking parameters to QR codes. Find out how logo upload works and how to enable it on your account. --- ## FAQs ### FAQs Overview **URL:** https://quiqrcodes.mantledocs.com/faqs-overview In this area, you’ll find some commonly asked questions about QuiQR functionality and features. --- ### Will my QR code expire? **URL:** https://quiqrcodes.mantledocs.com/will-my-qr-code-expire ## Do QR codes expire? In **QuiQR Codes**, your QR code will not expire as long as it is marked as **Active** in **Manage QR Codes** and your store continues to have an active app plan. An **Active** QR code stays available for use in the app unless you archive it or your app plan is no longer active. ## How to check whether your QR code is active You can confirm a code’s current status from the **QR Code Manager**. In Shopify admin, go to **Apps** and open **QuiQR Codes**. In the left-hand navigation under **QuiQR Codes**, select **Manage QR Codes**. On the **QR Code Manager** page, find your code in the list and look at the **Status** column. If it shows **Active**, the QR code does not expire while your app plan remains active. The same page also helps you identify the correct code by its **Name**, **Action**, and **Last Updated** details. ## What happens if a code is archived? If a QR code is set to **Archived**, it is not deleted immediately. Archived codes stay in the app for approximately **30 days** before being deleted. This 30-day period gives you time to recover a code if it was archived by mistake. ## Where archived status appears When a code has been archived, the **Status** column in **Manage QR Codes** shows **Archived** instead of **Active**. On the **Dashboard**, you may also see this reflected in the **Archived Codes** count. ## Can I restore an archived QR code? If the code is still within the approximately 30-day archived period, there is time for it to be re-instated after being archived in error. Do not leave an important code archived for too long. After roughly 30 days, it may be deleted from the app. ## Quick answer - **Active:** the QR code will not expire, as long as your app plan remains active. - **Archived:** the QR code remains in the app for about 30 days before deletion. - **Archived by mistake:** you have a limited window to have it re-instated before it is removed. --- ### QR code logo upload FAQ **URL:** https://quiqrcodes.mantledocs.com/qr-code-logo-faq ## QR code logo FAQ This FAQ explains how to get logo support enabled on your account and how to add a logo to a QR code in QuiQR Codes. ### How do I enable logo upload? Logo upload is available on the **Core** plan. If you have not yet upgraded your plan, you will see a button that links you to the "Plans" page of the app so that you can upgrade. ### How do I upload a logo to a QR code? In your Shopify admin, go to **Apps** and select **QuiQR Codes**. From the Dashboard, select **Create QR Code**, or open **Manage QR Codes** and choose an existing code to open **Edit QR Code**. On the QR code setup or edit screen, scroll to **Custom Logo**. In **Image Upload**, select **Add file** and upload your logo. Supported file types are `.jpg`, `.png`, and `.webp`, up to 5MB. Check the preview, then select **Save**. You can then use **Download QR Code** if needed. ![Custom Logo image upload area for adding a logo file to a QR code](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/c57f46ee-30f5-42d4-8d6e-dc30ed9f4195/Screenshot_2026-06-11_at_10.10.10.png) Keep file size in mind when uploading your logo. The maximum file size is 5MB, but larger files can slow down page speed if the QR code is shown on your website. ### Can I add a logo to a new QR code and an existing one? Yes. After the feature is enabled, you can add a logo while creating a new code with **Create QR Code** or when updating an existing code from **Manage QR Codes** in the **Edit QR Code** screen. ### What should I check before I use the QR code? Make sure your QR code still looks clear in the preview and test it on a phone before printing or sharing it widely. If the logo is too large or the design has poor contrast, scanning may be less reliable. --- ### How can I track events using QuiQR? **URL:** https://quiqrcodes.mantledocs.com/utm-tracking-qr-code-faq ## Track QR code performance with built-in UTM tracking If you want to see which QR codes drive visits, campaign traffic, or sales, you can enable **UTM tracking** directly in QuiQR Codes. The app adds your campaign details to the QR code’s destination URL when someone scans it, so analytics tools such as Google Analytics can attribute the visit correctly. **Plan availability:** UTM tracking is available on the app’s **Core** plan. This FAQ explains how UTM tracking works in QuiQR Codes, what to enter in each field, how to test it, and what to check if reporting does not look right. ## Frequently asked questions UTM tracking adds campaign labels to the destination URL when your QR code is scanned. These labels help your analytics tool understand where the visitor came from and which campaign or placement drove the scan. QuiQR Codes supports these tracking fields: - **Campaign source** (`utm_source`) - **Campaign medium** (`utm_medium`) - **Campaign name** (`utm_campaign`) - **Campaign term** (`utm_term`, optional) - **Campaign content** (`utm_content`, optional) You can enable UTM tracking while creating a QR code or by editing an existing one. Go to **Apps** → **QuiQR Codes**. Choose **Create QR Code** from the **Dashboard**, or open an existing code from **Manage QR Codes**. Enter the page you want the QR code to open. In the **UTM tracking** section, select **Enable UTM tracking**. Enter **Campaign source**, **Campaign medium**, and **Campaign name**. If needed, enter **Campaign term** and **Campaign content** to label variations or placements. Select **Save** to apply the tracking settings. - **Campaign source**: where the visitor came from, such as `qr`, `poster`, or `packaging`. - **Campaign medium**: the marketing channel, such as `offline`, `print`, or `in_store`. - **Campaign name**: the promotion or campaign name, such as `summer_sale`. - **Campaign term**: an optional extra label for audience, location, or grouping. - **Campaign content**: an optional label to distinguish versions, designs, or placements. Example setup for a store poster: - **Campaign source**: `qr` - **Campaign medium**: `print` - **Campaign name**: `summer_sale` - **Campaign term**: `store_window` - **Campaign content**: `blue_poster` Use short, consistent lowercase names so your analytics reports stay clean and easy to compare. 1. Save the QR code after enabling UTM tracking. 2. Scan the live QR code with your phone. 3. Make sure the correct destination page opens. 4. Check the page URL in your browser and confirm that the `utm_` parameters appear. 5. Review your analytics tool for the visit or campaign data. If you change any UTM values, test the live QR code again after saving to confirm the latest tracking parameters are being appended. If the destination page opens correctly but reporting is missing or delayed, check these common causes: - **The QR code was not saved after editing.** Open the QR code and confirm your changes were saved. - **UTM tracking is not enabled.** Make sure the **Enable UTM tracking** checkbox is selected. - **Required fields are missing.** Confirm that **Campaign source**, **Campaign medium**, and **Campaign name** are filled in. - **You are checking reports too quickly.** Some analytics tools do not show visits instantly. - **Your analytics setup filters or blocks visits.** Internal traffic filters, consent settings, or ad blockers can affect reporting. If the URL does not show any `utm_` values after scanning, the issue is usually in the QR code’s UTM tracking settings rather than your analytics platform. Yes. This is one of the best ways to compare performance across posters, flyers, packaging inserts, shelf signs, or event materials. For example, you might keep the same campaign name but change **Campaign content** or **Campaign term** for each placement so you can compare results later. - Use a clear naming pattern across all QR campaigns. - Keep values short and readable. - Use lowercase formatting consistently. - Use optional fields to distinguish placements or creative versions. - Always test a scan before printing or distributing a QR code widely. ## Quick troubleshooting checklist - The QR code opens the correct destination page. - **Enable UTM tracking** is turned on. - **Campaign source**, **Campaign medium**, and **Campaign name** are filled in. - The scanned URL includes the expected `utm_` parameters. - The QR code was saved after the latest changes. - Your analytics tool has had enough time to process the visit. ## Related guides Set up built-in UTM tracking on a new or existing QR code. Create a QR code that opens a custom page or external link. --- ### Can I import existing QR codes into QuiQR? **URL:** https://quiqrcodes.mantledocs.com/importing-qr-codes-into-quiqr ## Can you import QR codes from another app? **At this time, QuiQR Codes doesn’t include an “Import” feature** for bringing in QR codes created in another app (for example by uploading a QR image or pasting QR data into an import screen). In QuiQR Codes, QR codes are created and managed from inside the app so they can appear in the **QR Code Manager** list and show up in your app stats (like **Total Scans** on the **Dashboard**). ## What to do instead (recommended) If you have a QR code from another app, the best approach is to **recreate it in QuiQR Codes** by matching what the old QR code does (its destination). In your Shopify admin, go to **Apps** → **QuiQR Codes**. From the **Dashboard**, select **Create QR Code** (top-right). In the **Action** dropdown, choose the option that matches your existing QR code’s behavior (details below). Select **Save** in the top-right of the page. ### Choose the right Action (based on what your old QR code does) Use **Action** → **Custom Page**, then paste the destination into **Page URL** (include `https://`). Full walkthrough: [QR code to a custom URL](/creating-qr-codes/qr-code-to-a-custom-url). If your other app used a short link, you can paste that same short link into **Page URL** so the destination stays identical. Create a new code and set **Action** to **Product**, then choose the item under **Select Product** (for example via **Browse Products**). See: [QR code to a product page](/creating-qr-codes/qr-code-to-a-product-page). Create a new code and set **Action** to **Collection**, then pick the collection under **Select Collection** (using **Change Collection**). See: [QR code to a collection page](/creating-qr-codes/qr-code-to-a-collection-page). Create a new code and set **Action** to **Add to Cart**, then choose the item under **Select Product**. If you want a discount applied, fill in **Discount (Optional)**. On the **Edit QR Code** screen you may see a reminder like *“Only select one variant.”* Choose a single variant to ensure the QR behaves consistently. See: [QR code to add to cart + discount](/creating-qr-codes/qr-code-add-to-cart-discount). ## What you *can* bring over - **The destination** (URL, product, collection, add-to-cart behavior): you can recreate this by choosing the correct **Action**. - **The look and feel** (colors and shape): after creating the code, open it from **Manage QR Codes** and adjust **Background colour**, **Foreground colour**, and **Code Shape** on the **Edit QR Code** page. See [Customise a QR Code](/quiqr-codes-features/customise-a-qr-code). ## What you can’t bring over - **The original QR image file** (PNG/SVG) from another app can’t be uploaded into QuiQR Codes to become a managed code. - **Historical scan data** from another app won’t appear in QuiQR Codes. The **Total Scans** stat on the **Dashboard** reflects scans tracked for codes created and managed in QuiQR Codes. ## Download your recreated QR code Go to **Apps** → **QuiQR Codes** → **Manage QR Codes**. Click the code to open **Edit QR Code**. Use the right-hand **Preview** panel to choose **Format** (PNG or SVG), then click **Download QR Code**. Full walkthrough: [Download a QR code](/quiqr-codes-features/download-a-qr-code-png-or-svg). If you change design settings (like colours), always confirm the code still scans by checking the **Preview** and testing the printed version before distributing it widely. ## FAQ Yes—you can still print or share the QR code image you already have. However, it won’t appear in **Manage QR Codes**, and it won’t be managed or tracked by QuiQR Codes. It depends on the destination: - If your old QR code opened a URL and you paste the *same* URL into **Page URL** (using **Custom Page**), customers should land in the same place. - If your old QR code used a different add-to-cart method or discount behavior, match it using **Action** → **Add to Cart** and **Discount (Optional)**. All saved codes are listed in **Apps** → **QuiQR Codes** → **Manage QR Codes** in the **QR Code Manager** table. Click any row to open **Edit QR Code**. Yes. Open the code’s **Edit QR Code** screen and select **Archive code**. Archived codes remain listed with an **Archived** status. --- ### Why won't the custom page option accept my URL? **URL:** https://quiqrcodes.mantledocs.com/why-won-t-the-custom-page-option-accept-my-url If the **Custom Page** option won’t accept your link when you create a new QR code, it’s usually because the URL you entered is missing the required prefix (for example, `https://` or `http://`). ## What you’ll see - You select **Action** → **Custom Page**, but the **Page URL** field won’t accept what you type, or the form won’t let you **Save**. - You entered something like `www.example.com` or `example.com` instead of a full web address. ## Why it happens **Page URL** expects a complete URL, including the protocol at the start: - `https://` (recommended) - `http://` Most websites use `https://`. If you’re unsure, try `https://` first. ## Fix: enter the full URL (including https://) In the Shopify admin sidebar, open **Apps** and select **QuiQR Codes**. From the **Dashboard**, select **Create QR Code** (top-right). ![QuiQR Codes dashboard with setup guide and Create QR Code button](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/655df69f-3548-4a5a-95f3-aa578823fcaa/frame_001.jpg) In the **Action** dropdown, select **Custom Page**. The **Page URL** field appears. ![Action field set to Custom Page with Page URL input shown](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/3bacaf29-e359-4cff-9eb3-e824fd787fae/frame_004.jpg) In **Page URL**, paste the full website address, including `https://` or `http://`. - **Accepted examples**: `https://www.yourstore.com`, `https://yourstore.com/pages/contact` - **Not accepted** (missing prefix): `www.yourstore.com`, `yourstore.com/pages/contact` ![Page URL field filled with a custom https URL and preview visible](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/video-frames/a0022d54-8592-4f47-8852-507265d05d24/frame_005.jpg) Select **Save** (top-right). Then scan the QR code with your phone camera to confirm it opens the correct page. If you copy/paste from a document or email, double-check that the URL starts with `https://`. Some apps hide it visually, but **Page URL** still needs it. ## Common mistakes to avoid Add the protocol to the start: use `https://example.com` (or `http://example.com` if your site doesn’t support HTTPS). Use `https://www.example.com`. The `www` part is not the same as `https://`. Check for extra spaces at the beginning/end of the link and confirm there are no typos. Then scan-test the QR code before distributing it. Always test the printed/placed QR code before distributing it widely. A small typo in **Page URL** can send customers to the wrong page. ## Where to find your QR code after saving After you save, your QR code appears under **Manage QR Codes**, where you can return to it later and download it for use. --- ## Troubleshooting ### Troubleshooting Overview **URL:** https://quiqrcodes.mantledocs.com/troubleshooting-overview In this area, you’ll find guidance on troubleshooting for functionality and features within QuiQR. --- ### Fix invalid hex color error **URL:** https://quiqrcodes.mantledocs.com/fix-invalid-hex-color-error ## Why this error appears When you edit a QR code in **QuiQR Codes**, the **Background color** and **Foreground color** fields only accept hex color values in the correct format. If you type a value like `FFFFFF` or `000000` without the leading `#`, QuiQR Codes shows this error when you try to save: `Background color must be a valid hex color (e.g. #FFFFFF)` or `Foreground color must be a valid hex color (e.g. #000000)` ![QuiQR Codes Edit QR Code screen showing validation errors for Background color and Foreground color when the \# symbol is missing from hex values](https://cdn.heymantle.com/orgs/c60dabf2-e049-400a-a45b-5abda837631d/docs-pages/e2ca4438-64f0-4360-a3d6-34c34915043f/hex-error.png) ## Where to fix it You can update these fields from the **Edit QR Code** screen in QuiQR Codes. In Shopify admin, go to **Apps** and select **QuiQR Codes**. In the left navigation under **QuiQR Codes**, select **Manage QR Codes**. Select the QR code you want to update to open **Edit QR Code**. Scroll to the design section and look for **Background color** and **Foreground color**. ## How to fix the value Add a `#` at the beginning of the hex code before selecting **Save**. - Use `#FFFFFF` instead of `FFFFFF` - Use `#000000` instead of `000000` - Use `#1BAF31` instead of `1BAF31` If you are copying a color from another tool, check whether it included the `#`. Some design tools show the value without it. ## Save the QR code again After correcting the value in **Background color** or **Foreground color**, select **Save** in the top bar again. If the value is valid, the QR code should save normally and the **Preview** will continue showing your updated design. ## Use the color picker instead If you do not want to type the hex code manually, you can use the built-in color picker beside each field. This helps avoid formatting mistakes. The color picker fills the field in the correct format automatically, so it is a good option if you keep seeing this validation error. ## Quick checklist - You are editing the code from **Manage QR Codes** → **Edit QR Code** - The value starts with `#` - The field contains a full hex color such as `#FFFFFF` or `#000000` - You selected **Save** after updating the field ---