Shopify QR codes for products, baskets and support
Use Shopify QR codes to connect packaging and shop displays with products or baskets. Choose the destination and check the mobile shopping journey.
- Published
- Last updated
A Shopify QR code connects a printed display or package to a product page, a prepared basket or a support page. Choose that destination first, generate the code and scan a physical proof before printing the full batch. A readable code can still open the wrong variant or an unusable checkout.
Choose what the scan must accomplish
Give each code one job that matches what the customer is holding or looking at. A shelf label and a delivery insert usually need different destinations.
| Customer’s task | Suitable destination | What the label promises |
|---|---|---|
| Learn about an item | Its product page | View sizes and product details |
| Buy a known selection | A permalink with selected variants and quantities | Buy this refill |
| Redeem a promotion | The relevant offer page or a checkout link with a discount | Shop the refill offer |
| Get help after delivery | A public help page or secure account entry page | Get help with your order |
Use a product page when customers still need to choose a size or read specifications. A prepared basket suits a known refill, but its contents must match the printed description. Explain any promotion’s eligibility on the destination page.
A generic URL code encodes the address you supply. Shopify’s Shopcodes app connects a code to a product and supports either its product page or checkout with that product. An optional discount applies to the checkout destination. Shopify’s Shopcodes instructions describe these choices.
Before starting, you need a public destination and permission to manage the relevant product or app. A password-protected storefront blocks ordinary customers even when the QR image scans correctly.
Build the right Shopify destination
Start with the public storefront address or a documented permalink, then check exactly what it opens. Keep admin addresses and customer-specific links out of the artwork.
- Open the product on your public storefront. Copy its canonical product address on the intended store domain, without a temporary preview link. Confirm that it works in a signed-out browser.
- If you’re preparing a basket, identify each selected variant. Shopify’s variant ID instructions show where to find the number in admin. The product ID and variant ID are different. Match the variant to its size and colour before using it.
- Build the basket destination using the documented format. Check the selected quantity and where the customer lands before encoding it.
For a hypothetical store, a product page could be https://store.example.com/products/refill-bottle. It lets the customer read about the bottle and choose an option.
Shopify documents this legacy cart permalink shape. This example uses an illustrative store domain and Shopify’s example variant number:
https://store.example.com/cart/70881412:1
The number identifies a variant, and :1 requests one item. Replace both the domain and variant with your store’s values. Separate additional variant-and-quantity pairs with commas. Shopify’s merchant cart permalink guide explains the format.
A legacy cart permalink opens checkout by default. Append ?storefront=true to send customers to the basket first, or ?discount=REFILL10 for an illustrative discount code. That code must exist and apply to the purchase. Shopify’s developer cart permalink documentation lists the supported parameters. Selling plans aren’t supported, so use a product page for a subscription purchase.
For new implementations, Shopify recommends its successor, Cart and Checkout Permalinks. Use the endpoint listed under dev.ucp.shopping.permalink in your store’s /.well-known/ucp profile. If that capability is absent, use the supported legacy format. Avoid assuming that adding /buy to any domain will work.
Keep email addresses, delivery addresses and order-access tokens out of public codes. A support code can open a help page where customers enter their details securely. Anyone who photographs the package can read its encoded link.
Create and place the code
Generate the QR image only after its destination passes the signed-out check. Keep the printed label beside the image so customers know what will open.
- For a static code, paste the complete HTTPS address into the QR code generator using Website URL mode. Use Standard QR for an ordinary phone journey.
- Download the image for the print layout. A static download preserves that exact URL. Changing the generator’s input creates another image and doesn’t update a printed code or add scan tracking.
- Add a label such as “View bottle sizes” or “Get order help”, plus your recognisable store domain. Keep the promise specific to the destination.
- Place the code on a flat, visible area of the shelf label, insert or packaging. Preserve its clear border and use dark squares on a light background. Keep folds and glossy seams away from the image.
- Print a proof at the final size on the intended material. Test that proof before approving the print run.
To use Shopcodes instead, open Apps > Shopcodes in Shopify admin and choose Create Shopcode. Set the product and scan destination, select the variant and any applicable discount, then create and download the code.
Shopcodes also has account-managed edits and reports. You can change its destination or variant, and change the connected product from the app. Shopify says existing printed codes then follow the updated link. Its Scans and Conversions columns open the associated reports. Those capabilities belong to Shopcodes, independently of a static image generator.
Check the complete phone journey
Scan the physical proof and follow the route a customer will take, through choosing or buying the item or reaching support. Opening a page is only the first check.
- Scan with the phone’s normal camera under the lighting where the code will be used. If recognition fails, compare the printed code with the exported image. Restore cropped clear space or increase the printed size.
- Check the final domain and product. Match the variant, quantity, current price and availability to the label. If the wrong colour appears, correct the variant ID or Shopcodes setting before printing.
- Follow the buying journey as far as the payment step without placing an order. Confirm the discount, delivery options and mobile controls. For a help destination, confirm that a signed-out customer can reach the support entry point.
- Test the unavailable-product case in a test store. The page must explain what’s unavailable and give the customer a useful next action, such as selecting another size or contacting support.
For the newer Cart and Checkout Permalinks, Shopify can reduce quantities to available stock or omit sold-out items. Each opening creates a new cart containing the link’s items and replaces the customer’s previous store cart. Test with an existing test basket as well as an empty one. A customer expecting a full set must be able to see any missing item before paying.
If the scan works but the page fails, open the decoded address directly. A failure there points to the destination or store access. If the address works directly, compare it character by character with the QR payload.
Maintain links when the catalogue changes
Keep the printed URL reachable for as long as the packaging or display remains in circulation. Record which code appears on each print batch and who maintains its destination.
After a product handle or domain change, scan an old physical copy. Follow the full redirect chain and confirm the final product, variant and buying route. A working homepage redirect doesn’t prove that an old product link survives. Use the Shopify domains guide when planning an address change.
For an obsolete product path you control, create a redirect to a relevant replacement or an explanatory page. Shopify’s URL redirect guide explains the admin steps. Redirects work from broken paths, and Shopify excludes /cart paths. Don’t assume an old cart permalink can be repaired with an ordinary product redirect.
If the code uses an old domain, retain control of that domain and its redirect service. A redirect configured only on the new domain cannot receive scans sent to an expired old domain. For Shopcodes, update the managed destination and rescan the printed image.
When you can’t preserve the encoded destination, replace the physical code. Approve the new print run only when the replacement proof completes its intended phone journey.
Give your store its own shopping agent
Customers ask in their own words. Your agent finds, compares and checks out from your catalogue, right on your site.