Syncfusion Blazor Barcode Generator
Syncfusion's Blazor Barcode Generator package (Syncfusion.Blazor.BarcodeGenerator) provides three components for generating barcodes in Blazor applications:
| Component |
Use For |
SfBarcodeGenerator |
1D linear barcodes (Code39, Code128, Codabar, etc.) |
SfQRCodeGenerator |
QR codes with optional logo embedding |
SfDataMatrixGenerator |
2D Data Matrix codes for compact encoding |
All three work in Blazor Server, Blazor WebAssembly, and Blazor Web App (.NET 8+).
When to Use This Skill
- User needs to render or display a barcode in a Blazor component
- User asks about QR code generation (e.g., product links, 2FA, contact cards)
- User needs Data Matrix codes (pharmaceutical, logistics, label printing)
- User is configuring
SfBarcodeGenerator, SfQRCodeGenerator, or SfDataMatrixGenerator
- User asks about exporting a barcode as an image (JPG/PNG) or Base64
- User asks about barcode types, error correction, checksums, or validation events
- User is embedding a logo in a QR code
Navigation Guide
Setting Up the Project
📄 Read: references/getting-started.md
- NuGet package installation
_Imports.razor namespace configuration
- Service registration in
Program.cs
- Stylesheet and script references
- Setup for Blazor Server, WebAssembly, and Web App
- Adding the first barcode component to a page
1D Barcode Types and Configuration
📄 Read: references/barcode-types.md
- All supported
BarcodeType enum values with descriptions
- Code39, Code39 Extended, Code11, Code32, Code93, Codabar, Code128
- Choosing the right type for your use case
EnableCheckSum configuration
OnValidationFailed event handling
QR Code Generator
📄 Read: references/qr-code-generator.md
- Basic QR code usage
- Error correction levels (L, M, Q, H)
- Embedding a logo image in the QR code center
- Customizing logo size
- Color, dimension, and display text customization
OnValidationFailed event
Data Matrix Generator
📄 Read: references/data-matrix-generator.md
- Basic Data Matrix code usage
- Color, dimension, and display text customization
- Common use cases (pharmaceuticals, labels)
OnValidationFailed event
Exporting and Customizing Barcodes
📄 Read: references/export-and-customization.md
- Export barcode to image file (JPG/PNG)
- Export as Base64 string
ForeColor for custom barcode color
Width / Height for sizing
BarcodeGeneratorDisplayText for label text
- Applies to all three generator types
Quick Start Examples
1D Barcode
@using Syncfusion.Blazor.BarcodeGenerator
<SfBarcodeGenerator Width="200px" Height="150px"
Type="@BarcodeType.Code128"
Value="SYNCFUSION">
</SfBarcodeGenerator>
QR Code
@using Syncfusion.Blazor.BarcodeGenerator
<SfQRCodeGenerator Width="200px" Height="200px"
Value="https://www.syncfusion.com">
</SfQRCodeGenerator>
Data Matrix
@using Syncfusion.Blazor.BarcodeGenerator
<SfDataMatrixGenerator Width="200" Height="150"
Value="SYNCFUSION">
</SfDataMatrixGenerator>
Key Properties
| Property |
Applies To |
Description |
Value |
All |
The data string to encode |
Width |
All |
Width of the barcode (px or %) |
Height |
All |
Height of the barcode (px or %) |
Type |
SfBarcodeGenerator |
BarcodeType enum — selects the 1D symbology |
ForeColor |
All |
Color of the barcode bars (e.g., "red", "#333") |
EnableCheckSum |
SfBarcodeGenerator |
Adds/validates checksum digit (default true for Code39) |
ErrorCorrectionLevel |
SfQRCodeGenerator |
QR error recovery: Low, Medium, Quartile, High |
OnValidationFailed |
All |
Event triggered when Value contains invalid characters |
Common Use Cases
| Need |
Component |
Read |
| Product/inventory labels |
SfBarcodeGenerator (Code128/Code39) |
barcode-types.md |
| URL / contact / 2FA QR code |
SfQRCodeGenerator |
qr-code-generator.md |
| Branded QR code with logo |
SfQRCodeGenerator + QRCodeLogo |
qr-code-generator.md |
| Pharmaceutical / shipping labels |
SfDataMatrixGenerator |
data-matrix-generator.md |
| Download barcode as image |
.Export() method |
export-and-customization.md |
| Embed barcode in email/PDF |
.ExportAsBase64Image() |
export-and-customization.md |
1---2name: syncfusion-blazor-barcode3description: Build and troubleshoot barcode generation in Blazor using SfBarcodeGenerator, SfQRCodeGenerator, and SfDataMatrixGenerator. Trigger for 1D barcodes (Code39, Code128, Codabar), QR codes with logo and error correction, Data Matrix, checksum validation, and exporting barcodes to images in Syncfusion Blazor apps.4---5
6# Syncfusion Blazor Barcode Generator
7
8Syncfusion's Blazor Barcode Generator package (`Syncfusion.Blazor.BarcodeGenerator`) provides three components for generating barcodes in Blazor applications:
9
10| Component | Use For |
11|-----------|---------|
12| `SfBarcodeGenerator` | 1D linear barcodes (Code39, Code128, Codabar, etc.) |
13| `SfQRCodeGenerator` | QR codes with optional logo embedding |
14| `SfDataMatrixGenerator` | 2D Data Matrix codes for compact encoding |
15
16All three work in **Blazor Server**, **Blazor WebAssembly**, and **Blazor Web App** (.NET 8+).
17
18---
19
20## When to Use This Skill
21
22- User needs to render or display a barcode in a Blazor component
23- User asks about QR code generation (e.g., product links, 2FA, contact cards)
24- User needs Data Matrix codes (pharmaceutical, logistics, label printing)
25- User is configuring `SfBarcodeGenerator`, `SfQRCodeGenerator`, or `SfDataMatrixGenerator`
26- User asks about exporting a barcode as an image (JPG/PNG) or Base64
27- User asks about barcode types, error correction, checksums, or validation events
28- User is embedding a logo in a QR code
29
30---
31
32## Navigation Guide
33
34### Setting Up the Project
35📄 **Read:** [references/getting-started.md](references/getting-started.md)
36- NuGet package installation
37- `_Imports.razor` namespace configuration
38- Service registration in `Program.cs`
39- Stylesheet and script references
40- Setup for Blazor Server, WebAssembly, and Web App
41- Adding the first barcode component to a page
42
43### 1D Barcode Types and Configuration
44📄 **Read:** [references/barcode-types.md](references/barcode-types.md)
45- All supported `BarcodeType` enum values with descriptions
46- Code39, Code39 Extended, Code11, Code32, Code93, Codabar, Code128
47- Choosing the right type for your use case
48- `EnableCheckSum` configuration
49- `OnValidationFailed` event handling
50
51### QR Code Generator
52📄 **Read:** [references/qr-code-generator.md](references/qr-code-generator.md)
53- Basic QR code usage
54- Error correction levels (L, M, Q, H)
55- Embedding a logo image in the QR code center
56- Customizing logo size
57- Color, dimension, and display text customization
58- `OnValidationFailed` event
59
60### Data Matrix Generator
61📄 **Read:** [references/data-matrix-generator.md](references/data-matrix-generator.md)
62- Basic Data Matrix code usage
63- Color, dimension, and display text customization
64- Common use cases (pharmaceuticals, labels)
65- `OnValidationFailed` event
66
67### Exporting and Customizing Barcodes
68📄 **Read:** [references/export-and-customization.md](references/export-and-customization.md)
69- Export barcode to image file (JPG/PNG)
70- Export as Base64 string
71- `ForeColor` for custom barcode color
72- `Width` / `Height` for sizing
73- `BarcodeGeneratorDisplayText` for label text
74- Applies to all three generator types
75
76---
77
78## Quick Start Examples
79
80### 1D Barcode
81```razor
82@using Syncfusion.Blazor.BarcodeGenerator
83
84<SfBarcodeGenerator Width="200px" Height="150px"
85 Type="@BarcodeType.Code128"
86 Value="SYNCFUSION">
87</SfBarcodeGenerator>
88```
89
90### QR Code
91```razor
92@using Syncfusion.Blazor.BarcodeGenerator
93
94<SfQRCodeGenerator Width="200px" Height="200px"
95 Value="https://www.syncfusion.com">
96</SfQRCodeGenerator>
97```
98
99### Data Matrix
100```razor
101@using Syncfusion.Blazor.BarcodeGenerator
102
103<SfDataMatrixGenerator Width="200" Height="150"
104 Value="SYNCFUSION">
105</SfDataMatrixGenerator>
106```
107
108---
109
110## Key Properties
111
112| Property | Applies To | Description |
113|----------|-----------|-------------|
114| `Value` | All | The data string to encode |
115| `Width` | All | Width of the barcode (px or %) |
116| `Height` | All | Height of the barcode (px or %) |
117| `Type` | `SfBarcodeGenerator` | `BarcodeType` enum — selects the 1D symbology |
118| `ForeColor` | All | Color of the barcode bars (e.g., `"red"`, `"#333"`) |
119| `EnableCheckSum` | `SfBarcodeGenerator` | Adds/validates checksum digit (default `true` for Code39) |
120| `ErrorCorrectionLevel` | `SfQRCodeGenerator` | QR error recovery: Low, Medium, Quartile, High |
121| `OnValidationFailed` | All | Event triggered when `Value` contains invalid characters |
122
123---
124
125## Common Use Cases
126
127| Need | Component | Read |
128|------|-----------|------|
129| Product/inventory labels | `SfBarcodeGenerator` (Code128/Code39) | barcode-types.md |
130| URL / contact / 2FA QR code | `SfQRCodeGenerator` | qr-code-generator.md |
131| Branded QR code with logo | `SfQRCodeGenerator` + `QRCodeLogo` | qr-code-generator.md |
132| Pharmaceutical / shipping labels | `SfDataMatrixGenerator` | data-matrix-generator.md |
133| Download barcode as image | `.Export()` method | export-and-customization.md |
134| Embed barcode in email/PDF | `.ExportAsBase64Image()` | export-and-customization.md |