Skip to main content

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, 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

Properties

string
The fully qualified URL, e.g., https://blobsrus.omniapp.co/dashboards/123abc?f--users.email=someone@example.com.
string
The full error message. This may contain details not shown to the embedded user, such as database or warehouse-specific information.