The Workflow Library

Library / Data quality / data-quality-040

Language and locale property normalization

Data qualityContactData Hub ProfessionalSimple~20 min to buildFull spec

Outcome. A contact's preferred language always reads as one of a small, standard set of values, instead of a mix of raw locale codes, free-text guesses, and inconsistent casing that no email personalization rule or list segmentation can reliably filter on.

Workflow map Enrollment, branches and actions at a glance data-quality-040
flowchart TD
    A[Raw locale code known or changed] --> B{Starts with which prefix?}
    B -->|en| C[Preferred language: English]
    B -->|fr| D[Preferred language: French]
    B -->|nl| E[Preferred language: Dutch]
    B -->|de| F[Preferred language: German]
    B -->|es| G[Preferred language: Spanish]
    B -->|none match| H[Leave unset]
action or delay branch public on every spec, paid or not

When to use it, when not to

  • UseUse it when a raw locale code, from a browser's language header captured by an integration, a form field, or an import, needs to become a clean, standard picklist value used for segmentation and email personalization.
  • UseUse it when the set of locales you actually operate in is small enough to map explicitly, a handful of languages, not the full space of every possible browser locale variant.
  • SkipDo not use it to infer language from country alone. A contact's country and preferred language are related but not the same thing, a French-speaking contact in Belgium, an English-speaking expat in Germany. Keep them as separate properties.
  • SkipDo not use it if the raw source already writes a clean, standard value directly. Check the actual raw values you receive before building a mapping for variants that do not occur in practice.
The preview ends here. Six sections are in the library. counted, not blurred
PrerequisitesEvery property with its label, internal name, type and options, plus the assets the workflow needs before you start.2 items
EnrollmentThe trigger, the criteria exactly as they are ticked in the UI, the re-enrollment rule and the suppression list.4 parts
StepsEach action in order with its parameters, its branches and its delays, written as you tick them.7 numbered actions
Known pitfallsTraps seen in production, each with what breaks and what to do instead.4 pitfalls
Test plan, variants and build specHow to prove it works in a test portal, where to look when it does not, the variants for other objects or tiers, and the YAML build spec.3 variants, 3 sections
FilesThe properties JSON creates the fields in one API call, the workflow JSON documents the build.PDF, Markdown, JSON
Install1 click. The installer creates the properties this spec declares and the workflow itself, switched off, then opens a task for the prerequisites that are assets rather than properties, such as a team, a static list or a marketing email. What it created is listed on the install page.1 click, switched off
Unlock the full library, 149 EUR

or the data quality pack, 39 EUR

One-time, excl. VAT. 30-day refund, no questions asked. Founding prices until 31 October, then 199 and 59 EUR. Includes every spec added later, up to the full 500, and the one-click installer on the full library. Building on client portals? The agency licence at 449 EUR covers unlimited client portals.