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

---
id: 6c24d3ef-a3c6-4d6b-bd36-dba0ee889230
---

# CrmReport

> Learn about the CrmReport component for use in UI extensions.

The `CrmReport` component renders a [single object report](https://knowledge.hubspot.com/reports/create-custom-single-object-reports), which can be filtered with the `use` prop to surface data based on the currently displaying record, its associations, or unfiltered.

By default, the report data will automatically filter for the currently displaying record, as long as there is an association between the displaying record and records included in the report.

For example, using this component you can display a single object report that shows which deals closed this quarter. When viewing the report on a contact record, by default the report will only display data from deals associated with that contact.

<Frame>
  <img src="https://developers.hubspot.com/hs-fs/hubfs/Knowledge_Base_2023/ui-ext-components-report.png?width=426&height=344&name=ui-ext-components-report.png" alt="ui-ext-components-report" />
</Frame>

This component requires you to specify the ID of the report to render. To get a report's ID:

* In your HubSpot account, navigate to **Reports** > **Reports**.
* Click the **name** of the report you want to display.
* In the URL, copy the **number** that is not your HubID.

<Frame>
  <img src="https://developers.hubspot.com/hs-fs/hubfs/Knowledge_Base_2021/Developer/report-id-in-URL.png?width=452&height=36&name=report-id-in-URL.png" alt="report-id-in-URL" />
</Frame>

<Warning>
  **Please note:**

  Report data will only display for users with [permissions to view reports](https://knowledge.hubspot.com/user-management/hubspot-user-permissions-guide#reports).
</Warning>

```js theme={null}
import { CrmReport } from '@hubspot/ui-extensions/crm';

const Extension = () => {
  return (
  <CrmReport reportId="6339949" />;
 );
};
```

## Props

| Prop       | Type                                                        | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ---------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `reportId` | String                                                      | The numeric ID of the single object report, which can be found in the URL when viewing the report in HubSpot.                                                                                                                                                                                                                                                                                                                                                                                           |
| `use`      | `'associations'` (default) \| `'subject'` \| `'unfiltered'` | Specifies how the report should be filtered based on its relationship to the currently displaying CRM record:<ul><li>`associations`: report will only include data from records associated with the currently displaying record.</li><li>`subject`: report will only include data from the currently displaying record. Will not include data from associated records.</li><li>`unfiltered`: report will display all data regardless of the currently displaying record and its associations.</li></ul> |

## Related components

* [CrmAssociationPivot](/apps/developer-platform/add-features/ui-extensions/ui-components/crm-data-components/crm-association-pivot)
* [CrmAssociationPropertyList](/apps/developer-platform/add-features/ui-extensions/ui-components/crm-data-components/crm-association-property-list)
* [CrmAssociationTable](/apps/developer-platform/add-features/ui-extensions/ui-components/crm-data-components/crm-association-table)