Loading

"Unexpected Error" When Embedding a CRM Analytics Dashboard Component with a Filter on a Salesforce Record Page

Fecha de publicación: Jun 29, 2026
Descripción

Overview
When a CRM Analytics dashboard component that contains a Filter is embedded on a Salesforce record page, users may see an "Unexpected Error" message. This error does not originate from the CRM Analytics dashboard itself, but from the underlying Salesforce record page.
Root Cause
The underlying error that triggers this behavior is:
"This record could not be loaded because it includes too many formula fields with complex formulas, or too many custom fields. Ask your Salesforce administrator to remove some formula fields or simplify the formulas in use."
When a record page contains too many formula fields with complex formulas, or too many custom fields, the record page fails to load. This failure causes the embedded CRM Analytics dashboard component — which depends on the record page context to apply the filter — to display an "Unexpected Error".
Users see the "Unexpected Error" on embedded CRM Analytics dashboards that contain a filter when the hosting record page exceeds Salesforce's formula field or custom field limits.

Solución

Workaround for the Unexpected Error on Embedded CRM Analytics Dashboards
Because the root cause is Salesforce's record page formula field limit rather than the CRM Analytics dashboard itself, the recommended workaround is to embed the CRM Analytics dashboard using a Visualforce page instead of the native dashboard component on the record page.
When embedding with a Visualforce page, use the correct filtering syntax (not selection syntax) to retrieve the record page context and pass it to the dashboard. This bypasses the formula field limit issue on the record layout and allows the CRM Analytics dashboard with filters to load correctly.
To implement this workaround:

  • Create a Visualforce page that hosts the CRM Analytics dashboard component
  • Configure the Visualforce page to pass the record ID using the filtering (not selection) parameter syntax
  • Add the Visualforce page to the record page layout in place of the native CRM Analytics dashboard component

If reducing the number of formula fields or simplifying existing formulas on the record page is feasible, that is a permanent fix and removes the need for the Visualforce workaround.

Recursos adicionales
Número del artículo de conocimiento

000381610

 
Cargando
Salesforce Help | Article