Sign In
Products
ZPL ViewerBarcode GeneratorImage → ZPLZPL cheat sheetLabel DesignerTemplate Gallery
Developers
API QuickstartAPI ReferenceMCP ServerBulk GenerationWebhooksSDKs & ExamplesLimitsDirectPrint agent NewGitHub ActionVS Code extensionOn-Premise
Solutions
Logistics & ShippingE-CommerceERP & WMSManufacturingRetailHealthcare & LaboratoryAll solutions
Tools
ZPL Diagnostics HubZPL DebuggerSize & DPI AnalyzerDPI ConverterBarcode fit calculatorShipping Label AnalyzerFont InspectorOrientation DebuggerCalibration AssistantPrinter Compatibility CheckerBarcode Readability CheckerPrinter Language DetectorThermal Printer Test PackZPL ToolsEPL ToolsTSPL ToolsCPCL ToolsPrinter Language ConverterAll ToolsGuidesPricing
Language
EnglishTürkçeDeutsch
Home›Documentation›Frequently Asked Questions

Frequently Asked Questions

Frequently asked questions about Labelixa: rendering issues, character support, error messages, the free tier and the on-premise option.

Why does my label render not at all or incorrectly?

The most common causes: an unsupported command (listed in the X-Warnings header), a wrong dpmm/size, or a CORS block from the browser. Check the X-Warnings response header first.

Are special characters (accents, ß, ı, ş, ğ) supported?

Yes. The engine uses a font that supports Latin Extended characters and assumes UTF-8. Send your ZPL as UTF-8; ^CI28 is recommended.

What does a rate-limit / quota error (429) mean?

You exceeded the per-second request limit, the daily label ceiling or your monthly label/request quota. The X-Quota-Reason header names the window and X-Quota-Reset the renewal time; wait, or move to a higher plan.

Is there a guarantee for the free tier?

No. No plan comes with a service-level agreement (SLA); a dedicated SLA is provided only under a separate contract. For production use a paid plan is recommended.

What is the difference between the Label API and the Barcode API?

The Label API (/v1/printers) renders full ZPL labels. The Barcode API (/v1/barcodes) produces a single barcode without knowing ZPL; its audience and usage are different.

Can I run it on my own server (on-prem)?

Yes, the engine is stateless and can be packaged as a single Docker image. A custom font can be defined with LABELIXA_FONT. Contact us for enterprise requirements.