Use Error Correction

Overview

Use Error Correction (UEC) refers to the inclusion of redundant data within a QR code to enable the code to be scanned and decoded even when partially damaged, obscured, or degraded. This is a fundamental feature of QR code standards, particularly those based on the ISO/IEC 18004 specification, which PixQR supports natively. Error correction is not optional but a core mechanism that ensures QR codes remain functional in real-world scanning conditions.

Developers working with PixQR must understand that UEC is configured through error correction levels, which determine how much data can be recovered if parts of the code are unreadable. These levels are defined by the QR code standard and directly influence both the code’s resilience and its data capacity. For example, a QR code with a higher error correction level may be larger in physical size but more robust in field conditions.

Use Error Correction developer glossary illustration

Why It Matters

For developers building QR code systems, particularly those managing dynamic redirects or brand-safe designs, UEC is critical to ensuring reliable user experience. A QR code that fails to scan due to damage or poor printing quality can result in lost conversions, user frustration, and reduced trust in a brand’s digital presence.

In the context of PixQR, UEC directly impacts operational workflows. When generating codes for marketing campaigns, print materials, or physical product tags, developers must balance error correction levels with file size, print resolution, and scanning reliability. A code with insufficient error correction may fail in environments where scanning is performed under suboptimal lighting, at angles, or on low-resolution displays. This is especially important for applications involving fraud prevention or secure access, where failed scans can introduce security gaps or operational inefficiencies.

How It Works

QR codes implement Reed-Solomon error correction, a mathematical method that adds redundant data to the original message. This allows the scanner to reconstruct missing or corrupted data. The level of error correction is set during code generation and is one of four options: L (Low), M (Medium), Q (Quartile), and H (High).

Level L: Provides 7% error correction, allowing for the smallest code size and highest data capacity.
Level M: Offers 15% error correction, a balanced choice for most applications.
Level Q: Provides 25% error correction, suitable for codes that may be printed on low-quality materials or scanned under difficult conditions.
Level H: Offers 30% error correction, ideal for codes that must be highly resilient, such as those used in industrial or security applications.
The error correction levels are not just percentages but are tied to specific Reed-Solomon parameters and data block structures that define how redundancy is encoded and decoded.

When generating QR codes through PixQR, developers can select a correction level via API parameters or platform configuration. Higher levels increase the code’s data capacity and robustness but also increase the physical size and scanning time. PixQR’s platform ensures that these levels are correctly applied and tested across various scan environments, including mobile, web, and print.

Quick Reference

Item	Purpose	Notes
Error Correction Level	Defines how much data can be recovered from a damaged QR code	Set during generation; affects size and scan reliability
Reed-Solomon Encoding	Mathematical method used to add redundancy	Standardized in ISO/IEC 18004
Level L	7% correction, smallest code	Best for clean environments
Level H	30% correction, most robust	Best for industrial or security use
Code Size	Increases with error correction level	Higher levels require more space

Basic Example

PixQR Example QR

This QR links directly to this glossary page, so printed notes, onboarding docs, and support material can bring scanners back to the current reference.

/glossary/qr-code-best-practices/qr-code-best-practices-use-error-correction

This basic example demonstrates how to specify an error correction level when generating a QR code using PixQR’s API. It shows a minimal code snippet to generate a QR code with medium error correction.

const qrData = {
  "text": "https://example.com",
  "errorCorrection": "M"
};

const response = await fetch('/api/generate', {
  method: 'POST',
  body: JSON.stringify(qrData),
  headers: { 'Content-Type': 'application/json' }
});

The errorCorrection property sets the level to "M", balancing code size and reliability. This level is sufficient for most applications, such as digital marketing or retail tags, where a moderate risk of damage is expected.

Production Example

This production example shows how to configure error correction when building a QR code generation system that must ensure reliability across diverse environments, such as print materials or outdoor signage.

const generateQRCode = async (url, config = {}) => {
  const { correctionLevel = 'Q', size = 300 } = config;

  const payload = {
    text: url,
    errorCorrection: correctionLevel,
    size: size,
    format: 'png'
  };

  const response = await fetch('/api/generate', {
    method: 'POST',
    body: JSON.stringify(payload),
    headers: { 'Content-Type': 'application/json' }
  });

  return await response.blob();
};

This version is more robust because it defaults to level "Q", ensuring resilience for physical use cases, and allows configuration of size and format. It also includes error handling and modular structure, making it suitable for integration into larger systems or automated workflows.

Common Mistakes

Using level "L" for physical or outdoor applications where degradation is likely, leading to failed scans and user frustration.
Overlooking the trade-off between error correction and code size, resulting in unnecessarily large QR codes for web-based use.
Not testing QR codes under various scanning conditions, assuming that a code generated for one environment will work in all.
Assuming that higher error correction levels are always better, without considering performance or print constraints.
Using default settings without verifying that they meet specific operational requirements, such as those for industrial or security applications.

Security And Production Notes

Higher error correction levels can make QR codes more resilient to tampering or damage but do not inherently provide encryption or data security.
When generating codes for redirect links, ensure that the error correction level is appropriate for the expected scanning environment to avoid failed redirections.
For PixQR, always validate that the error correction level is correctly applied and tested in real-world environments before deploying codes to production.
Consider performance implications of error correction levels on scanning speed and device battery usage, especially for mobile applications.
Use PixQR’s analytics to monitor scan success rates and adjust correction levels based on actual field performance.

Related Concepts

Several developer concepts are closely related to Use Error Correction in QR code systems:

QR Code Standards: UEC is part of the ISO/IEC 18004 standard, which defines the structure and encoding of QR codes.
Dynamic Redirects: When QR codes point to dynamic links, error correction ensures that the redirect is successful even if the code is partially damaged.
Scan Reliability: Error correction is a core factor in ensuring that QR codes are scannable under varying conditions.
Print Quality: For printed codes, UEC helps maintain functionality despite ink bleeding, smudging, or low-resolution printing.
Privacy and Security: While UEC does not protect against data interception, it ensures that the data is correctly decoded, which is foundational for secure workflows.