🏷️Descriptions/Labels

NEW

Also known as: Human-Readable Labels, Display Names

Human-readable names and descriptions associated with codes or entities to convey meaning to users across languages and contexts.

DESCRIPTION

Labels and descriptions make data understandable and usable, especially when underlying identifiers are opaque. Standards like SKOS define preferred and alternate labels per language. Good labeling practices include concise names, clear descriptions, and provenance. Linking labels to code values, glossary terms, and concepts ensures consistency across UIs, reports, and APIs.

ALTERNATIVE DEFINITIONS

W3C

skos:prefLabel The preferred lexical label for a resource, in a given language.

Defines the standard property for preferred labels within SKOS.

Source

W3C

rdfs:label is a human-readable name for the subject.

Defines a general-purpose labeling property in RDF Schema.

Source

RELATED TERMS

Value Set Simple Knowledge Organization System RDF Schema Data Glossary Business Glossary Code Values Metadata Management Knowledge Representation Class Hierarchy

COMPETING TERMS

Opaque Codes

KNOWLEDGE AREAS

Semantic & Knowledge Modeling Metadata Management Data Management Data Quality

TARGET AUDIENCE

Data Steward Data Modeler Data Architect BI Specialist Data Analyst Information Analyst

EXTERNAL SOURCES

• Wikipedia - Simple Knowledge Organization System
• W3C - SKOS labeling and notes properties
• W3C - RDFS labeling property definition
• Schema.org - Common name property for entities

TOP QUESTIONS

Why do Descriptions/Labels matter in data systems?

They translate codes and identifiers into human-understandable terms, improving usability and reducing semantic errors.

Category: Relevancy

How do SKOS labels help?

SKOS provides preferred and alternative labels per language, enabling consistent multilingual naming.

Category: Standards

What is a good label?

Short, clear, context-appropriate, and disambiguated with qualifiers when needed, aligned to glossary definitions.

Category: BestPractice

How should descriptions be governed?

Stewards review and version descriptions, linking them to authoritative definitions and change logs.

Category: Governance

How are labels related to code values?

Labels provide human-readable names for codes; both should be versioned together.

Category: Relationship

How do labels appear in BI tools?

Expose business-friendly names and descriptions via semantic layers and catalogs to improve self-service.

Category: Practice

What risks arise from poor labels?

Ambiguous labels cause misinterpretation, selection errors, and reporting inconsistencies.

Category: Risk

How to manage multilingual labels?

Store language-tagged labels (e.g., SKOS), and implement locale-aware selection in UIs.

Category: HowTo

What tools support label management?

Glossary/catalog platforms, terminology services, and ontology editors like Protégé support governance.

Category: Tools