> For the complete documentation index, see [llms.txt](https://helpcenter.channable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.channable.com/manage-improve-product-data/insights/insights-for-orders/set-up-insights-for-orders.md).

# Set up Insights for orders

Set up an order-based Insights dashboard to track marketplace revenue, cost, commission, and shipping.

Insights based on sales and cost analysis data (commissions and/or shipping costs) uses order data to break down your listing performance.

In this article, we explain how to set up Insights for orders in your Channable account. After setting up Insights for orders, you’ll:

* Get a graphical overview of revenue compared to costs
* Be able to use Insights fields to create rules

***

### <i class="fa-memo-circle-check">:memo-circle-check:</i> Before you start

**You’ll need:**

* A unique ID for each item (usually `id`)
* An active [order connection](/list-advertise/orders/order-connections/supported-marketplaces-for-order-connections.md) for the supported channel

### **Create Insights Dashboard**

1. In your Channable account, create or open a project and go to **Insights**.
2. Click **+ Create Insights**.
3. For **Connect with**, select the connection used for your order connection.

{% hint style="info" %}
It may be hard to identify which of connection to select if your connection doesn't have a descriptive name (like 'Amazon - DE - orders'). To verify which connection to select, go to **Setup > Order connections** and check the entries there to make sure you select the right one.
{% endhint %}

1. Fill in your Insights dashboard settings:
   1. For **Name**, give your dashboard a descriptive name (like 'Insights - Amazon orders')
   2. For **Date range setting**, choose between a [Rolling date range](#user-content-fn-1)[^1] or [Fixed date range](#user-content-fn-2)[^2].
   3. For **Date range**, choose the date range you want to pull data from (if fixed range) or the maximum number of days to pull data from (if rolling date range).
   4. For **Channel Unique ID**, select the field containing your item IDs used to match your orders.
   5. For **Group on fields** <mark style="color:$primary;">(optional)</mark>, select fields you'd like to group and view data from. For example, by selecting a field like `sale` , you can have your dashboard only reflect items on sale.
2. Click **New Insights dashboard**.

You can also group data by category, brand and fields from your imported items.

{% hint style="success" %}
You can create multiple dashboards for a channel and set different date ranges and/or data combinations.
{% endhint %}

### **Reviewing data**

Check in on your listing performance any time by clicking the **Insights** tab and selecting the dashboard.

**Reviewing at product level**

1. In **\[your Insights dashboard]**, go to **View all items.**
2. Select the product you want to examine.

A graph and data will appear providing more information about your product.

{% hint style="success" %}
To change your Insights dashboard settings, go to **Insights > \[your order Insights dashboard]** and click **Settings**.
{% endhint %}

[^1]: A rolling date range is a dynamic period that's relative to the current day (e.g. 'Last 30 days')

[^2]: A fixed date range has a defining start and end point (e.g. 'January 1 - July 31)


---

# 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 dynamically by asking a question.

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

```
GET https://helpcenter.channable.com/manage-improve-product-data/insights/insights-for-orders/set-up-insights-for-orders.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.