Works in Staging
ELI5 — The Vibe Check
Works in staging is the sequel to 'works on my machine.' The code passed every test in the staging environment but immediately catches fire in production. Different environment variables, different data volume, different traffic patterns — turns out staging is just production cosplay. The staging fairy tale has a sad ending: an incident postmortem.
Real Talk
"Works in staging" describes the common situation where software functions correctly in pre-production environments but fails in production due to environmental differences — data volume, configuration, network topology, traffic patterns, third-party service behavior, or race conditions that only manifest under real load. It's a key argument for production observability, canary deployments, and realistic staging environments.
When You'll Hear This
"It works in staging!' has become a meme on our team." / "Our staging environment has 100 rows. Production has 50 million. Of course it works in staging."
Related Terms
Canary Deployment
Canary deployment is releasing your new code to a tiny percentage of users first to see if it explodes.
Production
Production is the real thing — the live app that actual users are using right now. It's the opposite of your practice environment.
Staging
Staging is a fake version of your real app that looks and acts exactly like production but has zero real users.
Works on My Machine
The most dangerous phrase in software development.