WPS Builder Troubleshooting — Load Errors & Required Fields

WPS vs PQR, essential variables, JSON load failures, and PDF gating

Diagnose WPS vs PQR confusion, untagged essential variables, JSON load errors, and required fields that block PDF export in the WPS Builder.

Fix the underlying issue, then reload or re-export

Most problems are confusion about qualification vs formatting, or incomplete required fields.

Open WPS Builder → WPS vs PQR →

WPS vs PQR Confusion

A PQR (Procedure Qualification Record) documents the test weld and results that qualify a procedure. A WPS specifies the production parameters welders follow for a procedure that has been qualified. This tool builds a WPS layout — it does not create or replace a PQR. Enter your supporting PQR number in Identification if you have one; the tool never validates it. See WPS vs PQR — Relationship Explained.

Essential Variables Not Tagged

ASME Section IX and AWS D1.1 define essential, nonessential, and supplementary-essential variables with specific tables (e.g., QW-250). This tool deliberately does not tag fields against those tables — every field is free-form documentation. For code compliance, use the official code form and a qualified reviewer (CWI, welding engineer) who maps your variables to the applicable tables.

Load (.json) Errors

If load fails with “Could not read that file”, the file is not a WPS Builder export. Valid files contain "_type": "testtalkhq-wps" and a fields object. Re-export from a working session or fix corrupted JSON. Loading a partial file from another tool will not work.

Missing Required Fields Block PDF

PDF export requires: Company / Shop name, WPS number, at least one welding process, and Base metal group. The error message lists whatever is missing. Fill those fields and try again — Save (.json) works even when required fields are incomplete, but PDF does not.

SymptomCauseFix
Red error on PDF clickRequired field emptyComplete listed fields
Load failsWrong or corrupt JSONUse a .json from Save (.json)
“Qualified” on shop floor without reviewTemplate mistaken for PQRQualify per code; read WPS vs PQR guide
P-No. / F-No. don’t match code tablesFree-text fields, no validationVerify against code & mill cert

Reference Materials

AWS code books and official WPS/PQR form pads are common shop references for procedure documentation.

Catalog gap: No AWS D1.1 code books or WPS/PQR form pads exist in the TestTalkHQ affiliate CSV at publish time — we do not substitute unrelated products.

Related Calculators & Guides

Welding

Welding Reference Card

Welding Reference Card

One page. MIG, TIG, stick and flux core settings by thickness.

$3.99

Buy
Complete Welding Settings Guide

Complete Welding Settings Guide

19 pages. Four processes, stainless and aluminum, symbols and inspection.

$12.99

Buy
Welding Job Estimator

Welding Job Estimator

Price the job, then hand over a quote with no internal numbers.

Excel or Google Sheets. Best on a computer.

$29.00

Buy
BEST VALUE
Welding Complete Bundle

Welding Complete Bundle

Card, 19-page guide and the estimator workbook. All six files.

Excel or Google Sheets. Best on a computer.

$34.99

$45.98 if bought separately — save $10.99

Buy

See all Welding products

Checkout opens in a new tab.