Samla

Validators

Every field in a Samla bucket can be guarded by one or more validators. They run server-side - live, as the customer types. Rules stay centralised and your frontend never carries stale logic.

Built-in validators

Ship with every Samla install - Hosted and Self-Hosted alike.

Format & contact
emailValid email format.
phoneInternational formats (+49…).
urlValid http(s) URL.
plz5-digit German postcode.
Banking & payment
ibanFormat + ISO 13616 check digits.
bic8 or 11 chars, SWIFT standard.
kreditkarte13–19 digits, Luhn + network length.
Tax & identity
ust_idnrEU VAT ID, MOD-97 check.
steuernummerGerman tax number per ELSTER (format + check digit).
idnr11-digit tax ID, ISO 7064 check digit.
personalausweisnummerID-card number, ICAO 9303 check digit.
Social security & payroll
svnrDEÜV social-security number with check digit.
beitragsgruppenschluessel4-digit DEÜV contribution-group key.
betriebsnummer8-digit employer number (BA) with check digit.
dguv_unternehmensnummer15-digit DGUV number (mod 11).
mindestlohnHourly rate ≥ minimum wage (2026: €13.90).
minijob_grenzePay ≤ mini-job limit (§ 8 SGB IV).
werkstudent_20h≤ 20 weekly hours (§ 6 SGB V).
mindestausbildungsverguetungTrainee pay ≥ § 17 BBiG.
Keys & codes
taetigkeitscode5-digit KldB-2010 code.
taetigkeitsschluessel9-digit BA activity key.
gefahrtarifstelle4-digit BG hazard-tariff code.
Dates & age
datum_in_zukunftDate must be in the future.
datum_in_vergangenheitDate must be in the past.
datum_groesser_alsDate after another field's date.
date_rangeDate within a range.
month_yearFormat MM.YYYY (e.g. 03.2026).
alter_minMinimum age from date of birth.
alter_maxMaximum age from date of birth.
Text & logic
regexValue against a custom regex pattern.
min_lengthMinimum length (Unicode chars).
max_lengthMaximum length (Unicode chars).
gleich_zu_feldMust equal another field (confirm email).
pflicht_wennRequired when another field has a value.
unique_im_dokumententypUnique across all entries of the doc type.
Plausibility
vergleichNumeric comparison across fields.
summe_gleichValue = sum of linked fields.
Files
mime_matchAllowed file MIME types.
pdf_parseablePDF readable, minimum page count.
image_min_resolutionImage minimum resolution (pixels).
More than format checks

Configurable per field - and across fields.

  • configMany validators take options (minimum amount, cut-off date, threshold) set by the admin in the editor.
  • siblingsRules like vergleich, summe_gleich or pflicht_wenn read linked fields of the same document.
  • regexFor anything else, define any format rule yourself with a custom regex pattern.