Blog

Victor Campos

November 18, 2025

Spread the word


Share your thoughts

Are you tired of staring at endless, unreadable stack traces when exceptions hit your ColdBox app? There’s a better way to handle exceptions, especially during development, and it’s called Whoops!

Whoops offers a clean, interactive way to track and navigate exceptions in your ColdBox applications, making debugging much easier. Let’s dive into how you can enable it in your app.

Step 1: Enable Whoops in Development Mode

First, head over to your config/ColdBox.cfc file and look for the development() environment configuration. You’ll want to add the following setting to tell ColdBox to use Whoops for exception tracking

function development(){
    coldbox.customErrorTemplate = "/coldbox/system/exceptions/Whoops.cfm";
}

This tells ColdBox to trigger the Whoops UI whenever an exception is detected. You’ll get a beautiful, interactive stack trace to help you troubleshoot more effectively!

Step 2: What Does Whoops Do?

Whoops gives you a clean UI stack trace that allows you to:

  • Navigate each file in the stack.
  • Jump to the exact line number where the exception occurred.
  • Integrate with your IDE for instant editing of the problematic file!

No more scrolling through long, convoluted error logs—you can see exactly where things went wrong, and fix them faster.

Step 3: Configure Your IDE for Whoops

Whoops is even more powerful when it integrates directly with your IDE. By default, Whoops is set up for Visual Studio Code (vscode), but you can configure it to use a different editor if that’s your preference.

In the same development() block, add the following configuration to set your preferred IDE

function development(){
    coldbox.exceptionEditor = "vscode-insiders";
}

Here are some valid options for the exceptionEditor setting:

  • vscode (Default)
  • vscode-insiders
  • sublime
  • textmate
  • emacs
  • macvim
  • idea
  • atom
  • espresso

Pick your favorite, and Whoops will let you open the files and jump directly to the line number where the exception occurred!

Conclusion

By enabling Whoops and configuring your IDE, you’ll get a smoother, faster, and more enjoyable exception-tracking experience. Say goodbye to those frustrating debugging sessions and hello to a more streamlined development workflow!

Learn More ColdBox Tips and Tricks

Stay tuned for more ColdBox tips in our ongoing series. if you want to learn more than 10 free tips and tricks make sure to get your “ColdBox 102 tips and tricks book” We have a variety of formats you can choose from.

Get your Copy

Join the Ortus Community

Be part of the movement shaping the future of web development. Stay connected and receive the latest updates on, product launches, tool updates, promo services and much more.

Subscribe to our newsletter for exclusive content.

Follow Us on Social media and don’t miss any news and updates:

Add Your Comment

Recent Entries

Your API Returns 200. Did the Business Transaction Actually Work?

Your API Returns 200. Did the Business Transaction Actually Work?

The customer submits an order. The portal shows a confirmation. The API returns 200 OK, and the release checks pass.

The next morning, operations asks why the order never appeared in the approval queue. Support has a ticket. A developer has to trace the order through the database and figure out whether someone can safely submit it again.

For teams maintaining a ColdFusion or Lucee application, this is a frustrating kind of release failure: the team ...

Maria Jose Herrera
Maria Jose Herrera
November 11, 2026
BoxLang AI 3.7: Profiles, Embeddings Defaults and MCP Rate Limiting

BoxLang AI 3.7: Profiles, Embeddings Defaults and MCP Rate Limiting

Ortus Solutions announces the release of BoxLang AI 3.7. Name a provider, model, params and API key once, then pick it by name for a call, an agent, or a single agent run. Embeddings get their own defaults, MCP servers you build get rate limiting and trusted proxies, and a handful of important fixes land along the way.

Luis Majano
Luis Majano
November 05, 2026
BoxLang  1.19.0: See Everything Your Code Does

BoxLang 1.19.0: See Everything Your Code Does

Ortus Solutions today announces the release of BoxLang 1.19.0, the software productivity platform for building, modernizing and running applications, with developers and AI agents working together. This release is about observability: built-in code coverage and execution profiling, the missing post-invocation events for BIFs, and new query and transaction events, and it pairs with the new BxLens beta, the debug bar and ops console that exposes hotspots and bytecode profilers. It also adds your own global settings in boxlang.json, static method interception, raw binary HTTP streaming and a lot of hardening across JDBC, Java interop and CFML compatibility.

Luis Majano
Luis Majano
November 05, 2026