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

# Custom Reports

> Build tailored reports in the HoopAI Platform using your own metrics, filters, widgets, and column configurations.

Custom Reports allow you to provide concise and dynamic information about your company's health. When handling your data inside the platform, you want an easy way to relay this information to your intended audience — Custom Reports lets you build exactly what you need.

## Accessing custom reports

Navigate to **Reporting** in the left sidebar, then select **Custom Reports**.

<Frame caption="Custom Reports section">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/fpcCfUClUku7SftL/images/reporting-custom-reports-1.png?fit=max&auto=format&n=fpcCfUClUku7SftL&q=85&s=c4a7cacff70bd7e2dd787fbb0de2955f" alt="Custom Reports" width="1626" height="487" data-path="images/reporting-custom-reports-1.png" />
</Frame>

***

## Creating a custom report

<Steps>
  <Step title="Open custom reports">
    Go to **Reporting → Custom Reports** and click the **Create Report** button.

    <Frame caption="Create Report button">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/fpcCfUClUku7SftL/images/reporting-custom-reports-2.png?fit=max&auto=format&n=fpcCfUClUku7SftL&q=85&s=8705f1c3e58d50f642b57ecaeb7c4926" alt="Create Report" width="1626" height="487" data-path="images/reporting-custom-reports-2.png" />
    </Frame>
  </Step>

  <Step title="Name your report">
    Give your report a descriptive name so it's easy to find and share with your team.
  </Step>

  <Step title="Choose your data source">
    Select the type of data to analyze — contacts, opportunities, appointments, conversations, or other objects in your account.

    <Frame caption="Selecting a data source">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/fpcCfUClUku7SftL/images/reporting-custom-reports-3.png?fit=max&auto=format&n=fpcCfUClUku7SftL&q=85&s=c81f67c6000891ff6ad8073d03e81123" alt="Data Source" width="928" height="787" data-path="images/reporting-custom-reports-3.png" />
    </Frame>
  </Step>

  <Step title="Select columns and metrics">
    Pick the fields you want to include as columns in your report. You can add standard fields (name, email, status) as well as custom fields you have created in your account.

    <Frame caption="Selecting columns">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/fpcCfUClUku7SftL/images/reporting-custom-reports-4.png?fit=max&auto=format&n=fpcCfUClUku7SftL&q=85&s=7466389aa0b0a229c8b749d3a50eaf99" alt="Columns" width="1258" height="591" data-path="images/reporting-custom-reports-4.png" />
    </Frame>
  </Step>

  <Step title="Apply filters">
    Narrow your dataset by setting filter conditions — for example, contacts tagged as "hot lead" created in the last 30 days.
  </Step>

  <Step title="Add widgets">
    Add chart widgets to visualize your data. Widgets can display bar charts, line graphs, pie charts, and summary metrics. You can also move and reorder widgets within the report.

    <Frame caption="Report page list">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/fpcCfUClUku7SftL/images/reporting-custom-reports-page-list.png?fit=max&auto=format&n=fpcCfUClUku7SftL&q=85&s=97f490774c67421c643cb71cf2bb1a1b" alt="Page List" width="410" height="436" data-path="images/reporting-custom-reports-page-list.png" />
    </Frame>
  </Step>

  <Step title="Save your report">
    Save the report. It will appear in your Custom Reports list for quick access. Reports can be shared with other team members in your account.
  </Step>
</Steps>

***

## Widget-level customization

You can customize individual widgets within your report:

* **Widget type** — choose chart type (bar, line, pie, table, etc.)
* **Metrics** — select which data fields the widget displays
* **Colors** — apply custom colors to distinguish between data series
* **Filters** — apply widget-level filters that override the report-level filter for that widget only

<Note>
  Widget-level filters let you show different subsets of data side-by-side in the same report — for example, a chart for leads from Facebook next to one for leads from Google.
</Note>

***

## Sharing and exporting

* **Export** — download the report as a CSV or Excel file for offline analysis or sharing with stakeholders outside the platform.
* **Share** — share saved reports with other users in your account so the whole team works from the same data.
* **Schedule** — configure scheduled report delivery to receive reports via email at set intervals.

***

## Use cases

<AccordionGroup>
  <Accordion title="Lead source analysis">
    Build a report filtering contacts by source to compare how many leads each channel (Facebook, Google, organic) has generated in a given period.
  </Accordion>

  <Accordion title="Pipeline health check">
    Report on opportunities by stage, value, and assigned owner to get a snapshot of where deals stand and which stages have the most drop-off.
  </Accordion>

  <Accordion title="Campaign response tracking">
    Filter conversations or contacts by a specific tag, campaign, or workflow to measure engagement and response rates.
  </Accordion>

  <Accordion title="Custom field reporting">
    Surface data stored in custom fields — such as industry, referral source, or service type — in a clean table view for segmentation analysis.
  </Accordion>

  <Accordion title="Multi-page reports">
    Create multi-page reports where each page focuses on a different aspect of your business (e.g., Page 1: Lead Generation, Page 2: Sales Performance, Page 3: Call Activity).
  </Accordion>
</AccordionGroup>

<Tip>
  Save commonly used filter and column combinations as named reports so your team can access them with one click, without reconfiguring filters each time.
</Tip>

***

## Custom metrics for dashboard reports

Custom metrics let you create calculated KPIs that combine data from multiple sources. Metrics created in Custom Reports are also available as dashboard widgets, and vice versa.

To create a custom metric:

1. In your Custom Report, click **Add Widget** and switch to the **Custom Metrics** tab
2. Click **+ Create Custom Metric**
3. Enter a name, data type (currency, percentage, number), and description
4. Build the formula using the formula builder — combine up to 4 metrics with operators (+, -, x, /)
5. Click **Create**

The custom metric appears in both your report and the dashboard Custom Metrics library.

***

## Custom report template library

Save commonly used report configurations as templates for quick reuse:

1. Create and configure a Custom Report with your desired data source, columns, filters, and widgets
2. Click the **three-dot menu** and select **Save as Template**
3. Enter a template name and save

Templates are accessible from the **Create Report** dialog. Select **From Template** to start a new report with pre-configured columns, filters, and widget layout.

<Tip>
  Create templates for recurring reporting needs — monthly sales review, weekly lead source analysis, quarterly pipeline health — so your team generates consistent reports without reconfiguring each time.
</Tip>

***

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Who can see my custom reports?">
    Custom reports are visible to all users in your account with reporting access. You can share saved reports with team members, and administrators can control which reports appear for which roles.
  </Accordion>

  <Accordion title="Can I include custom fields in a report?">
    Yes. When selecting columns, both standard fields and any custom fields you have created are available. This allows you to report on data specific to your business.
  </Accordion>

  <Accordion title="How do I schedule a report to be sent by email?">
    Open the report, click **Schedule**, and configure the delivery frequency (daily, weekly, or monthly) along with the recipient email addresses. The report will be delivered automatically at the configured interval.
  </Accordion>

  <Accordion title="What chart types are available for widgets?">
    Widgets support bar charts, line graphs, pie charts, and summary metric tiles. You can add multiple widgets per report page and rearrange them by dragging.
  </Accordion>

  <Accordion title="Can I create a report with multiple pages?">
    Yes. Custom reports support multiple pages, each with its own widgets, filters, and metrics. Use this to organize a report into sections — for example, one page for lead generation and another for sales performance.
  </Accordion>

  <Accordion title="How do widget-level filters differ from report-level filters?">
    Report-level filters apply to all widgets on all pages. Widget-level filters override the report filter for that specific widget only, letting you display different data subsets side-by-side in the same report.
  </Accordion>
</AccordionGroup>

***

## Related articles

* [Audit reports](/reporting/audit-reports)
* [Custom fields](/settings/custom-fields)
* [Custom values](/settings/custom-values)
* [Agent reporting](/reporting/agent-reporting)