Join the waitlist

Let us know how we should get in touch with you.

Thank you for your interest! We’re excited to show you what we’re building very soon.

Close
Oops! Something went wrong while submitting the form.

The B2B Enrichment Data Dictionary: Fields, Entity Levels, and Null Values

·
Updated on: September 8, 2026

TL;DR: B2B enrichment commonly adds person, company, employment, location, technology, and behavioral fields. Every field needs a definition, entity level, data type, provenance, observed time, allowed null reasons, and overwrite policy. A blank value must never silently mean false, zero, unchanged, or not applicable.

What types of data do B2B enrichment tools typically provide?

B2B enrichment tools supplement an existing record with attributes used for identity, segmentation, routing, prioritization, personalization, or measurement. Common field families describe a person, a company, the employment relationship between them, relevant technology, business location, and observed behavior or signals.

Field names can look similar while carrying different meanings. Company size may refer to global employees, a regional estimate, or a categorical band. A job title may be observed text, a normalized function, or an inferred seniority. The data dictionary should make those distinctions explicit.

Core B2B enrichment field familiesField familyTypical fieldsCommon operating usePersonName, professional profile, work email, phone, locationIdentity resolution and contactability.CompanyLegal name, domain, industry, size, revenue band, headquartersAccount fit, segmentation, and routing.Employment relationshipTitle, function, seniority, start date, current-company statusPersona qualification and job-change handling.TechnologyProduct name, category, observed domain, detection timeTechnographic segmentation and workflow context.Behavioral or signalWebsite activity, product events, hiring, research, relationship eventsTiming, prioritization, and message context.Governance metadataSource, observed time, confidence state, consent, suppression, license scopeAuditability and permitted activation.

Assign the correct entity level

An entity level tells the system what the field describes. Person email belongs to a person, industry usually belongs to a company, and job title belongs to the relationship between a person and a company. Attaching relationship data directly to the person can preserve an old title after a job change.

Entity levels for an enrichment data modelEntity levelExamplesIdentity keyPersonName, personal professional profile, durable person identifierProvider person ID plus governed matching attributes.CompanyLegal name, primary domain, industry, employee bandCompany ID, normalized domain, and legal identity where available.EmploymentTitle, function, seniority, employment datesPerson ID plus company ID and validity period.LocationHeadquarters, office, region, mailing addressLocation ID or normalized address tied to the correct parent entity.Technology observationProduct, category, observed URL, detection timeCompany or domain plus technology and observed time.Behavioral eventPage view, product action, hiring event, research signalActor or account, event type, source, and event time.

Define field types and units

  • Text: specify normalization, casing, allowed characters, and whether the value is observed or generated.
  • Enumeration: publish the allowed values, mapping rules, and an explicit unknown state.
  • Boolean: reserve true and false for known states. Use null when the fact was not established.
  • Number: define unit, precision, range, and whether the value is exact, estimated, or bucketed.
  • Date and time: identify time zone and distinguish event time, observed time, and sync time.
  • Array: define ordering, deduplication, maximum size, and whether an empty array differs from null.
  • Reference: identify the target entity and behavior when the referenced record is merged or deleted.

Treat null as a governed state

A null value should mean that the system does not have a usable value under a documented condition. It should not be used interchangeably with false, zero, empty text, not applicable, redacted, unchanged, or lookup failed.

Null and absence states for enrichmentStateMeaningRecommended handlingUnknownThe value has not been establishedLeave null and retain lookup status.Not foundThe source was checked but returned no valueRetain source and checked time for retry policy.Not applicableThe field does not apply to this entityUse an explicit status rather than null alone.Withheld or restrictedThe value exists but cannot be supplied or usedStore a policy state without exposing the value.ConflictingSources returned incompatible valuesHold activation or apply a documented resolution rule.ClearedA previous value is known to be invalidRemove the value and retain the invalidation event.

Set overwrite and merge rules

For each field, state whether enrichment may fill only blanks, replace stale values, append an observation, or require manual approval. A current CRM owner or verified customer-provided field may have higher authority than an external estimate. A timestamp alone should not decide authority.

  • Fill-if-empty: safest for customer-maintained fields with no current value.
  • Replace-if-stale: requires a freshness definition and a source-authority check.
  • Append observation: best for events, technology detections, and changing relationships.
  • Hold on conflict: appropriate when an incorrect value changes routing, eligibility, or compliance.
  • Clear on invalidation: preserves the reason a former value must no longer be used.

Give every field an operating contract

A data dictionary becomes executable when each field includes an owner, business purpose, source authority, update trigger, allowed consumers, and failure behavior. Without those attributes, two systems may share a field name while applying different definitions or overwriting each other.

Operating contract for an enrichment fieldContract elementDefinitionExample decisionBusiness purposeThe decision or workflow the field supportsIndustry may control segmentation but not contact eligibility.Source authorityWhich source may create or replace the valueCustomer CRM value may outrank an external estimate.Freshness policyWhen the field is stale enough to recheckEmployment data is revalidated after a job-change event.Null policyWhich absence states are allowed and how they differNot found does not become false.Overwrite policyWhether to fill, replace, append, hold, or clearA conflicting owner field is held for review.Activation policyWhich workflows may use the field and under what conditionsAn inferred signal may prioritize research but not enroll automatically.

Version field definitions when meaning changes. If a provider changes an industry taxonomy or a team replaces employee count with a size band, historical comparisons may no longer be like-for-like. Keep the transformation version and effective time so reports and workflows can explain the transition.

Retire fields deliberately. Identify every downstream consumer, stop writes, preserve required history, migrate references, and monitor for continued use. Deleting a visible CRM property without removing hidden workflow dependencies can create silent nulls and routing failures.

Validate the dictionary before activating data

Pick representative records and test every critical field through ingestion, mapping, conflict resolution, CRM write-back, and deletion or invalidation. Confirm that the destination field preserves the intended type and entity. Review null distributions by source and status, not only overall completeness.

Stop activation when a field lacks an owner, its definition changes by source, entity identity is unresolved, provenance is missing, or null states are collapsed in a way that changes eligibility or routing.

How Unify fits the enrichment model

Unify describes a company and contact data workflow that supports prospecting, enrichment, and enrollment. Its waterfall approach can query sources in sequence, but customers should still define field authority, entity level, null handling, and CRM overwrite behavior.

A connected workflow is most useful when the data dictionary travels with it. Store the source and observed time needed to explain why a record qualified, which value was selected, and what should happen when that value later changes.

Start using Unify to connect enrichment data with governed outbound actions.

Frequently asked questions

What types of data do B2B enrichment tools provide?

Common families include person, company, employment, technology, location, and behavioral or signal data. Exact fields and definitions vary by source.

What does null mean in enrichment data?

Null should mean the value is unknown or unavailable under a documented reason. It should not silently mean false, zero, not applicable, or unchanged.

Why assign an entity level to every field?

Entity levels prevent values from being attached to the wrong person, company, office, domain, or relationship.

Sources