Skip to content

Free ONIX File Validator

Check Your Book Metadata Online

Built for publishing editors and metadata managers, this free tool validates your ONIX XML file against the official EDItEUR schemas, groups every problem by book record, and explains what to change — in publishing language, not parser jargon.

Free ONIX file check

Drag your ONIX file here

or drop a file anywhere in this box

Supports ONIX 2.1 / 3.0 / 3.1 · XML, ONX, and ONIX files

No sign-up required. Your file is uploaded over HTTPS, processed temporarily on the validation service, and deleted after validation. Privacy details Maximum file size: 25 MB.

Example report

Illustrative

See what you get after uploading

Every result starts with a clear file summary, then points you to the affected record, explains why the issue matters, and gives you a safe next step.

2

schema errors

3

quality warnings

42

product records checked

Official XSD error schema

Missing title detail

Record 18 · ISBN 9780000000000 · Line 122

This record does not include the title information required for a product listing.

How to repair

Add the required title composite to the affected product record, then validate the exported file again.

What is ONIX?

ONIX for Books is the international standard XML format for communicating book product metadata. Maintained by EDItEUR, it defines a precise vocabulary for describing titles, contributors, identifiers, prices, territorial rights, and supporting resources so that trading partners can exchange catalog data without manual re-keying.

Publishers create ONIX messages; distributors, wholesalers, retailers, and library suppliers receive them. A single ONIX message contains a header plus one product record per book or format, and each record can carry hundreds of fields — from the ISBN and title to subject classifications, descriptions, and supply terms.

Because the format is strict, a single misplaced element or invalid code can make an entire feed fail. That is why validation matters: errors found here are errors that Amazon, Ingram, and other recipients would otherwise find during ingestion.

This validator supports ONIX 2.1, 3.0, and 3.1 — the versions in active use across the industry — in both reference-tag and short-tag formats.

Common ONIX Errors We Catch

Schema validation errors. The file breaks the official ONIX specification: unexpected or misspelled elements, elements in the wrong order, missing required elements or composites, and values that violate the format the schema requires (for example a malformed publication date).

Invalid code-list values. ONIX fields such as product form, contributor role, and price type draw from EDItEUR code lists. A value outside the list is meaningless to receiving systems.

ISBN and identifier problems. Our project quality rules flag records with no usable product identifier, ISBNs that fail check-digit rules, and duplicate record references — issues that pass schema validation but break distribution.

Metadata-quality warnings. Clearly separated from official schema errors, these recommendations cover problems like missing titles, contributors without roles, and prices without currencies — the mistakes that cause silent rejections and wrong product pages.

How the Validator Works

  1. Upload. Drag your ONIX file into the box above or choose it from your computer. The file is sent over HTTPS to the validation service.
  2. Review the result workspace. Your original XML appears beside the validation report. Hover an issue to highlight its reported source line, then read the plain-English explanation and repair guidance.
  3. Repair and re-check. Follow the repair steps in your source system, export a corrected file, and validate again until the report is clean.

Supported Versions and Limitations

Validation runs against the official XML Schemas for ONIX 2.1, 3.0, and 3.1, bundled with the pinned onixcheck 0.9.11 engine. The engine version and active schema are shown with every report.

Honest limits: a schema-valid file is not guaranteed to be accepted by Amazon, Ingram, Google, or any other channel — recipients apply their own additional rules. This tool does not verify that your metadata is commercially complete, and project warnings are recommendations, not official ONIX errors.

Frequently Asked Questions

What is an ONIX validator?

An ONIX validator checks whether an ONIX for Books XML file follows the official EDItEUR schema. It finds structural errors, missing required elements, and invalid code values, and — in this tool — explains each problem in publishing language with repair steps.

Which ONIX versions are supported?

The validator supports ONIX 2.1, ONIX 3.0, and ONIX 3.1, in both reference-tag and short-tag formats, validated against the official XSD schemas bundled with onixcheck 0.9.11.

Is my ONIX file uploaded to a server?

Yes. The file is uploaded over HTTPS so the onixcheck engine and our quality rules can run on it. The file is held only in an isolated temporary location on the validation server while your request is processed.

How long is my file stored?

Your file exists only for the duration of the validation request. This service does not intentionally save uploaded XML files or validation history after processing completes.

What is the difference between an error and a warning?

Errors come from the official ONIX schema: the file violates the specification and is likely to be rejected by recipients. Warnings are project recommendations about metadata quality — the file is schema-valid, but something is likely to cause problems in distribution.

Does a valid ONIX file guarantee retailer acceptance?

No. Schema-valid means the file conforms to the official ONIX specification. Retailers and distributors apply their own additional requirements, so a schema-valid file can still be rejected by a specific channel.

Can the tool fix my ONIX file automatically?

Today the validator explains each problem and tells you how to repair it — it never silently changes your metadata. A future version may offer a small set of safe, mechanical fixes with a visible diff and your explicit approval before anything changes.

Latest ONIX Guides

Check your feed in seconds

No sign-up, no installation — validate ONIX 2.1, 3.0, and 3.1 files right here.

Try the free ONIX validator