> For the complete documentation index, see [llms.txt](https://docs.chord.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chord.co/analyze-with-dashboards/custom-explores/creating-custom-reports.md).

# Creating custom reports

## Introduction

{% hint style="info" %}
**A note on terminology:**

A **report** on the Chord platform can refer to either a **dashboard** or a **Look** (which also known as an **explore**). A **dashboard** is made up of a collection of **Looks** (**explores**).
{% endhint %}

Chord enables you to create custom analyses using our modeled data. You can visualize your data, gain insights, and share those insights with others. You can share these reports with others and let them view the data or give them edit access to change the report structure.

This article will help you create a report useful to your business. So that you know, you can modify the examples provided to create the custom report of your choice.

See below for more details on creating new dashboards or Looks on the Chord platform:

* **Build a New Dashboard**
* **Create a New Look**
* **How to Use Explores**

## Build a new dashboard

![](https://2938842758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5Oy2IAsu7IvAGAlWgC36%2Fuploads%2Fgit-blob-4d8641ca127bdbd2b3a6acf9401c87b0cc427026%2Fcreating-custom-reports-1.png?alt=media)

![](https://2938842758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5Oy2IAsu7IvAGAlWgC36%2Fuploads%2Fgit-blob-a42a5a5feeca11b1b0c7d73d4e510b184f815273%2Fcreating-custom-reports-2.png?alt=media)

1. Log into Chord and navigate to the **My Reports** menu item in the left navigation pane, under the **Analytics** page.
2. If you do have pre-existing reports, click on the pink **+ New Report** button.
3. If you **do not** have any pre-existing reports, click the **Add New Report** button in the middle of the screen.
4. Click on **New Dashboard** in the dropdown selection to create a new dashboard that consists of multiple Looks.
5. You will be immediately taken to the newly created dashboard under **My Reports**.
6. Here, you can edit the dashboard and add custom metrics to build the reporting you need.

## Create a new look

![](https://2938842758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5Oy2IAsu7IvAGAlWgC36%2Fuploads%2Fgit-blob-4d8641ca127bdbd2b3a6acf9401c87b0cc427026%2Fcreating-custom-reports-1.png?alt=media)

![](https://2938842758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5Oy2IAsu7IvAGAlWgC36%2Fuploads%2Fgit-blob-5ecca21c3206145c653aa18e43691e285f2caa07%2Fcreating-custom-reports-3.png?alt=media)

![](https://2938842758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5Oy2IAsu7IvAGAlWgC36%2Fuploads%2Fgit-blob-06ecb0b06a80c4d4d37dbfd4ae2846c1b787f903%2Fcreating-custom-reports-4.png?alt=media)

1. Navigate to the **My Reports** tab within the **Analytics** homepage.
2. If you do have pre-existing reports, click on the pink **+ New Report** button.
3. If you\*\* do not\*\* have any pre-existing reports, click the **Add New Report** button in the middle of the screen.
4. Click on **New Look** in the dropdown selection to create a new Look.
5. You will be taken to our **Quickstarts** library to browse different starter metrics to create a new Look.

{% hint style="info" %}
**Note:** You can also create a Look using **Explores**, which is outlined in the next section.
{% endhint %}

## How to use explores

{% hint style="info" %}
You can access\*\* Explores\*\* in two different ways:

1. Clicking into the **Explores** tab under **Analytics** (which we cover in this section).
2. Adding a new visualization to a dashboard.
   {% endhint %}

{% hint style="info" %}
If you click on **Explore from Here** on an existing Look (seen below), you will see a pre-filtered view of **Explores**.

<img src="https://2938842758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5Oy2IAsu7IvAGAlWgC36%2Fuploads%2Fgit-blob-52ac669c4a6ba0c317f2bdc36d4c266e8f8d0040%2Fcreating-custom-reports-5.png?alt=media" alt="" data-size="original">
{% endhint %}

![](https://2938842758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5Oy2IAsu7IvAGAlWgC36%2Fuploads%2Fgit-blob-e11701d6dd05b26f79e6ca81d069dbe50b25c918%2Fcreating-custom-reports-6.png?alt=media)

1. Navigate to the **Explores** tab within the **Analytics** homepage.
2. Click on the dropdown menu on the top left section of the page and select a specific **Explores** category that you are interested in creating.

   ![](https://2938842758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5Oy2IAsu7IvAGAlWgC36%2Fuploads%2Fgit-blob-32875882992c45a9cda947a4fb34c8a2fd32e837%2Fcreating-custom-reports-7.png?alt=media)
3. Each category will display a set of fields in different tabs: all fields that are available and fields that are currently in use. If you begin creating a Look via **Explores**, you will see that the “In Use” tab will be empty until you apply fields to your query.
4. Different **Explores** categories will highlight different facets of Chord-collected data that you can use to build specific queries to use as part of your reporting. Some common fields that you can use are:
   1. **Custom Fields** (custom fields that you have created)
   2. **Activities** (different dimensions focused on customer activities on your site, such as session landing page)
   3. **Sales** (dimensions focused on sales-related activities, such as order discounts).
5. Once you have created a specific query using existing measures, you can save it to your personal reports folder or add it to an existing dashboard.

For more details on creating a new Look using Explores, check out the video below.

{% embed url="<https://www.loom.com/embed/63e056c1a82242b48881ed7caf018148?sid=8a71fb4a-e51d-4b7b-a1fc-58c48d160f95>" %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.chord.co/analyze-with-dashboards/custom-explores/creating-custom-reports.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
