> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omni.co/llms.txt
> Use this file to discover all available pages before exploring further.

# error embed event

> Emitted by Omni when a detectable error occurs on an embedded page.

## Error display behavior

Embedded content displays a generic error message to end users when a query runtime error occurs. Detailed error information, such as database connection details or warehouse-specific messages, is not shown in the embedded UI. The exact message depends on where the error appears:

* **Dashboard tiles, spreadsheet tiles, and drills** display "Something went wrong"
* **Workbook results pane** displays "Something went wrong" with the subtitle "There was an issue running this query. Contact your administrator."

This is automatic and requires no configuration. [Custom dashboard state messages](/visualize-present/dashboards/custom-state-message), if configured, are still displayed.

To capture the underlying error details, listen for the `error` event in your host application. The event payload includes the full error message, which you can log or use to build a custom error experience.

## Payload

```json theme={null}
{
  "href": "string",
  "message": "string"
}
```

## Properties

<ParamField path="href" type="string">
  The fully qualified URL, e.g., `https://blobsrus.omniapp.co/dashboards/123abc?f--users.email=someone@example.com`.
</ParamField>

<ParamField path="message" type="string">
  The full error message. This may contain details not shown to the embedded user, such as database or warehouse-specific information.
</ParamField>