Partially Covered QR

Overview

A Partially Covered QR code refers to a QR code that remains readable and scannable even when a portion of its visual structure is obscured, damaged, or altered. This resilience is achieved through built-in redundancy mechanisms, specifically the Error Correction Code (ECC) levels defined in the QR code standard. PixQR leverages these ECC levels to ensure that QR codes remain functional in real-world conditions where physical damage, dirt, or partial occlusion may occur during printing, usage, or scanning.

Developers working with PixQR must understand how to configure and test QR codes with varying degrees of coverage to ensure reliable scanning across different environments. For example, a QR code used in a high-traffic outdoor signage application may be partially covered by a sticker or weathered by sun exposure. The Partially Covered QR concept ensures that such codes can still be reliably scanned and redirect users to the intended destination.

Partially Covered QR developer glossary illustration

Why It Matters

For developers, understanding Partially Covered QR is essential for designing robust QR code workflows that account for real-world usage. In production environments, QR codes may be exposed to physical damage, dirt, or partial obstruction, especially in outdoor or industrial settings. Without proper error correction, these conditions can cause scanning failures, resulting in lost conversions, user frustration, or failed redirects.

From a PixQR perspective, ensuring that QR codes can be scanned even when partially covered enhances user experience, reduces support tickets, and increases the reliability of digital redirects. Additionally, this reliability is critical in fraud prevention, where a partially damaged QR code should not be misused to redirect users to malicious destinations. Properly configured error correction also supports compliance with accessibility standards by ensuring that QR codes remain usable by users with varying visual abilities or device scanning capabilities.

How It Works

The Partially Covered QR functionality is rooted in the QR code’s Error Correction Code (ECC) levels, which are defined in the ISO/IEC 18004 standard. These levels allow QR codes to recover from damage or partial occlusion by embedding redundant data. There are four ECC levels:

Level L (Low): 7% error correction. Most efficient in terms of data capacity, but least resilient to damage.
Level M (Medium): 15% error correction. Balances data capacity and resilience.
Level Q (Quartile): 25% error correction. Provides better resilience for partially covered codes.
Level H (High): 30% error correction. Highest resilience, suitable for codes that may be heavily damaged or partially covered.

When a QR code is generated, PixQR applies one of these ECC levels to determine how much redundancy is included. The higher the ECC level, the more data is embedded to allow recovery from damage, but at the cost of reduced data capacity. In PixQR, developers can select the appropriate ECC level when creating a QR code via API or dashboard, depending on the expected usage environment.

Additionally, the physical structure of QR codes is designed to allow partial scanning. The three distinctive positioning patterns (corners) and timing patterns ensure that even if the central data area is partially obscured, the scanner can still decode the code. PixQR’s implementation ensures that these structural elements remain intact even when a QR code is printed or displayed in a way that partially covers the data.

When generating a QR code in PixQR, developers can specify the ECC level using an API parameter or dashboard setting. The system automatically calculates the optimal balance between data capacity and error correction based on the selected level. This allows developers to tune the QR code for specific use cases, such as high-traffic outdoor signage, where damage is likely, or indoor applications where the code is less prone to damage.

For developers using PixQR APIs, error correction is handled transparently during QR code generation. The system validates that the selected ECC level is within supported parameters and adjusts the QR code size or structure if necessary to ensure compatibility with scanning devices and standards.

Quick Reference

Item	Purpose	Notes
ECC Level	Controls error correction capability	Higher levels allow more resilience to damage
QR Code Size	Increases with ECC level	Higher ECC requires larger QR codes
Scan Reliability	Indicates how well the code scans under damage	Used in outdoor or industrial settings
API Parameter	Used to specify ECC level	Valid values: L, M, Q, H
Print Quality	Affects how much of the code is visible	High-quality printing improves scan success

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-error-correction/qr-code-error-correction-partially-covered-qr

This basic example demonstrates how to specify an ECC level when generating a QR code using PixQR’s API. The example uses a Level H ECC setting for maximum resilience.

curl -X POST https://api.pixqr.com/v1/qr \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "ecc_level": "H"
  }'

The key part of this example is the "ecc_level": "H" parameter. This tells PixQR to apply the highest error correction level, which ensures that the QR code remains scannable even if significant portions are covered or damaged. The API returns a QR code image that can be embedded in a website or printed.

Production Example

In a production environment, a developer may need to generate QR codes for an outdoor advertising campaign. The QR code may be partially covered by a sticker or weathered by exposure. The following example shows how to configure the QR code with a high ECC level and validate the output.

const pixqr = require('pixqr-sdk');

const config = {
  url: 'https://campaign.example.com',
  ecc_level: 'H',
  size: 512,
  margin: 1
};

pixqr.generate(config)
  .then(response => {
    console.log('QR Code generated with high ECC');
    // Save or serve the QR code image
  })
  .catch(error => {
    console.error('Failed to generate QR code:', error);
  });

This version includes validation and error handling, ensuring that the generated QR code meets production standards. The use of ECC level H ensures that even if the code is partially obscured, it remains functional. The size and margin parameters are also set to ensure print quality and scanning reliability.

Common Mistakes

Using a low ECC level for outdoor applications: This can lead to scanning failures in real-world conditions where codes are exposed to dirt or damage.
Not testing QR codes with partial coverage: Developers may assume a code works in all conditions, leading to user frustration in field deployments.
Ignoring QR code size constraints: Higher ECC levels increase QR code size, which may not fit within design constraints or print limitations.
Overlooking print quality: Even with high ECC, poor print resolution or color contrast can prevent scanning, regardless of error correction.
Not validating API responses: A missing or incorrect ECC parameter in an API call may result in a less resilient QR code than expected.

Security And Production Notes

Security: Partially covered QR codes should not be used for sensitive redirects or authentication, as partial damage can be exploited to mislead scanners.
Validation: Always validate the ECC level and QR code size in production environments to ensure compatibility with scanning devices.
Accessibility: Ensure that QR codes are not only scannable but also visible to users with low vision, using appropriate contrast and sizing.
Performance: Higher ECC levels increase processing time and data size. Balance performance with resilience needs.
Compatibility: Not all QR scanners support all ECC levels. Test with actual devices to confirm scanning reliability.

Related Concepts

Several related concepts are closely tied to Partially Covered QR:

Error Correction Code (ECC): The underlying mechanism that allows QR codes to recover from damage.
QR Code Standards: The ISO/IEC 18004 standard that defines QR code structure and error correction levels.
Scanning Reliability: The ability of a QR code to be scanned successfully under various conditions.
Print Quality: The physical appearance of the QR code, which affects how well it scans.
Link Management: The process of ensuring that QR codes redirect to the correct, secure destinations, especially when codes are partially covered.