Medallion Architecture
What Is Medallion Architecture?
Medallion architecture is a data design pattern that organizes data into progressively refined layers, usually Bronze, Silver, and Gold. In a data lake or lakehouse, it separates raw ingestion, cleaning, and business-ready outputs so teams do not mix every task in one data pipeline. It is a logical pattern, not a database product, data model, or replacement for ETL and ELT processes.
How Bronze, Silver, and Gold Layers Work
Each layer has a clear responsibility and a defined level of trust.
- Bronze stores source records with minimal changes, such as raw ecommerce orders, click events, or API responses.
- Silver cleans, deduplicates, validates, and standardizes those records. For example, it can convert order dates to one format and match product IDs.
- Gold publishes purpose-built datasets, such as daily sales by product, customer metrics, or features for a machine learning model.
Medallion Architecture vs. a Traditional Data Warehouse
A lakehouse is a platform approach, while medallion architecture is a pattern for organizing data within it.
| Area | Medallion architecture | Traditional data warehouse |
|---|---|---|
| Raw data | Usually retained in Bronze for replay and audit. | Often transformed before loading. |
| Transformation | Refined gradually across layers. | Commonly centered on curated warehouse tables. |
| Consumers | Engineers, analysts, data scientists, and applications. | Mainly reporting and business intelligence users. |
| Modeling | Can support detailed, conformed, and aggregated data. | Often uses dimensional models for reporting. |
Benefits of Medallion Architecture
The pattern makes trustworthy data easier to maintain and reuse.
- Raw records support audits, troubleshooting, and pipeline recovery.
- Repeatable transformations improve consistency between reports.
- Quality checks can occur before data reaches broad audiences.
- Silver data can serve both analytics and machine learning workloads.
- Source schema changes can be isolated before they affect Gold outputs.
Practical Limits of Medallion Architecture
Three named layers do not automatically create reliable data.
- Keeping multiple versions increases storage and processing costs.
- Requiring every layer can delay simple, time-sensitive reporting.
- Unclear ownership can leave data quality issues unresolved.
- Over-transformation may remove detail needed for future analysis.
- A small application may only need raw and curated datasets, not all three layers.
Implementation Tips: Define Layer Contracts and Quality Gates
Use explicit rules rather than relying on layer names alone.
- Keep Bronze ingestion immutable where possible.
- Capture source, timestamp, schema, and lineage metadata.
- Define schema expectations and quality tests for Silver.
- Quarantine invalid records instead of silently dropping them.
- Make processing idempotent, so reruns do not duplicate data.
- Apply access controls and document the intended use of Gold datasets.
Both batch jobs and streaming pipelines can use this pattern. Streaming event sources also fit well with event-driven architecture when downstream systems need timely updates.
Using Medallion Data in Modern Applications
Documented Gold datasets can power dashboards, internal tools, AI features, and customer-facing applications without exposing unverified source data. Teams planning an application should align its data access rules with the wider application architecture from the start. An AI app builder such as Emergent can help teams build data-aware full-stack applications that use governed, business-ready data.
on Emergent today

