# Report Table

**GM - Report Table** is a powerful GridMate component that allows users to embed **Salesforce reports** including **Tabular**, **Summarized**, and **Matrix** formats directly onto any **Lightning page** (Home, App, or Record page). With support for advanced features like **row and column groupings**, **grand totals**, and **custom display options**, it offers a highly **interactive** and **configurable** way to surface business critical data.

By default, Salesforce Lightning only supports displaying **report charts**, not raw tabular data. **GridMate fills this gap** by enabling users to view full report tables directly in the Lightning Experience, empowering teams to make data driven decisions faster and more efficiently.<br>

In this tutorial, we will setup **GM - Report Table** component to display an  Opportunity summarized report on a home page . Below is a quick demo on how to configure it 👇.

{% embed url="<https://youtu.be/mhLOHI8zjF8>" %}
GRIDMATE - REPORT TABLE
{% endembed %}

{% hint style="success" %}
If the component is used on a record page, the report can be filtered on the current record Id using **Filter** property.&#x20;

Below is an example to filter opportunities report based on the current account.&#x20;

{ "ACCOUNT\_ID": { "value": "$recordId" } }
{% endhint %}

👋 **Note** that Salesforce Reports doesn't always use the field API name for filtering. You can find the field name to use  by following the instructions below.

Execute the code bellow using the [Executing Anonymous Apex Code](https://help.salesforce.com/s/articleView?id=sf.code_dev_console_execute_anonymous.htm\&type=5) :point\_down:

```java
Report r = [
    SELECT Id, Name, DeveloperName
    FROM Report
    WHERE DeveloperName = ${Developer_Name}
    Limit 1
];

Reports.ReportMetadata reportMetadata = Reports.ReportManager.describeReport(r.Id).getReportMetadata();

System.debug(JSON.serialize(reportMetadata));
```

In our example Developer Name = '**Closed\_Opportunities\_ode**'

For better vision, copy the JSON **log** into the[ GridMate playground](https://gridpal.my.site.com/s/playground) and you will find the columns on the **reportFilters** attribute.

<figure><img src="/files/oNdygVk75Wi5Av0IOHFZ" alt=""><figcaption></figcaption></figure>

## Matrix Report

In this tutorial, we will setup **GM - Report Table** component to display an Opportunity Matrix report on the opportunity record page. Below is a quick demo on how to configure it 👇.

{% embed url="<https://youtu.be/DTW4STEWa0U>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gridmate.io/product-tour/report-table.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.