---
schema_version: "1"
id: ad5fda943954043133a1f67604bbf8ef692c3c82eae424f6987c0d31627bc9c2
title: DashboardComponent
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_dashboardcomponent.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_dashboardcomponent.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: e231b568bd656c6a8bd9eb834892662098b29151e7e0d27eb3b72c6582d191ec
description: Represents a dashboard component, which can be a chart, metric, table, or gauge on a dashboard. Access is read-only. This object is available in API version 21.0 and later.
---
# DashboardComponent

Represents a dashboard component, which can be a chart, metric, table, or gauge on a dashboard. Access is read-only. This object is available in API version 21.0 and later.

## Supported Calls

describeSObjects(), query(), retrieve()

## Fields

| Field | Details |
| --- | --- |
| CustomReportId | 
Type

reference

Properties

Filter, Group, Nillable, Sort

Description

Requires the user permission "Manage All Private Reports and Dashboards." The ID of the report that provides data for the dashboard component. See [Report](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_report.htm#sforce_api_objects_report "Represents a report, a set of data that meets certain criteria, displayed in an organized way. Access is read-only. This object is available in API version 20.0 and later.").



 |
| DashboardId | 

Type

reference

Properties

Filter, Group, Sort

Description

The ID of the dashboard that contains the dashboard component. See [Dashboard](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_dashboard.htm#sforce_api_objects_dashboard "Represents a dashboard, which shows data from custom reports as visual components. Access is read-only. This object is available in API version 20.0 and later.").

This is a relationship field.

Relationship Name

Dashboard

Relationship Type

Lookup

Refers To

Dashboard



 |
| Name | 

Type

string

Properties

Filter, Group, Nillable, Sort

Description

The name of the dashboard component.



 |

## Usage

Provides read only access to the current values in dashboard component fields.

## Associated Objects

This object has the following associated objects. Unless noted, they are available in the same API version as this object.

[DashboardComponentFeed](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_feed.htm "StandardObjectNameFeed is the model for all feed objects associated with standard objects. These objects represent the posts and feed-tracked changes of a standard object.")

Feed tracking is available for the object.