Wix-managed headless projects report log messages and errors to Wix Logs, a live log stream in your project's dashboard. Use it to trace what your code did and to debug a released project.
Note: Monitoring is available with Wix's Astro integration only. The integration registers the client that reports your messages and errors, which doesn't happen for projects built with another web framework.
Important:
console.log() and the other console methods aren't forwarded to Wix Logs. To send a message to the log stream, call captureMessage() or captureException() as described below.
This article covers:
@wix/essentials installed.You don't need to configure anything to start reporting. Unlike monitoring for Wix apps, headless projects don't use Sentry, so there's no DSN to add and nothing to change in wix.config.json.
Wix Logs shows what you report with the monitoring client. You can call it from anywhere in your project: backend endpoints, page rendering, and client-side code all report to the same log stream.
Uncaught errors in your backend code are reported for you. Report everything else yourself: console output isn't forwarded, and uncaught errors in client-side code aren't captured.
Get a monitoring client, then call captureMessage():
The message appears in Wix Logs with a severity of INFO. To report it at a different severity, pass a level:
Call captureException() with the error you caught:
By default, errors reported with captureException() appear with a severity of ERROR.
You can attach tags and contexts to either call to record extra detail:
This detail is recorded alongside the message, so you can find these entries using the search box in Wix Logs.
Uncaught errors in client-side code aren't captured automatically, so catch them and report them yourself:
Each entry shows the severity level, a timestamp, the message, and a source file.
Important: Wix Logs is a live stream and doesn't store history. Open it before you reproduce the behavior you're investigating. If the stream doesn't appear, reload the site while the Wix Logs page is open in another tab.
Include enough detail in each message to identify where it came from.
Last updated: 27 July 2026