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

# Insight basics

export const OutboundLink = ({linkText, linkTarget}) => {
  return <a target="_blank" href={linkTarget}> {linkText} 
    <div className="inline h-3 w-3 fill-gray-500 dark:fill-gray-100 text-gray-500 dark:text-gray-300 ml-1 mr-1">
      <svg className="inline w-2.5 h-2.5 bg-gray-500 dark:bg-gray-300" style={{
    maskImage: `url('https://mintlify.b-cdn.net/v6.5.1/solid/up-right-from-square.svg')`,
    maskRepeat: "no-repeat",
    maskPosition: "center center"
  }}></svg> 
    </div>
    </a>;
};

export const Icon = ({name}) => {
  return <div className="h-4 w-4 fill-gray-800 dark:fill-gray-100 text-gray-800 dark:text-gray-100 inline-block align-middle">
            <svg className="w-4 h-4 bg-gray-800 dark:bg-gray-100" style={{
    maskImage: `url('https://mintlify.b-cdn.net/v6.5.1/solid/${name}.svg')`,
    maskRepeat: "no-repeat",
    maskPosition: "center center"
  }} />
        </div>;
};

export const IconText = ({name, text, iconSource = "mintlify", iconLocation = "before", iconType = "solid"}) => {
  const sourceUrl = iconSource === 'local' ? `url('/images/icons/${name}.svg')` : `url('https://mintlify.b-cdn.net/v6.5.1/${iconType}/${name}.svg')`;
  return <>
            <div className="inline-block pl-2">
                {iconLocation === 'before' && <div className="h-3.5 w-3.5 fill-gray-800 dark:fill-gray-100 text-gray-800 dark:text-gray-100 inline-block align-middle mr-2">
                        <svg className="w-4 h-4 bg-gray-800 dark:bg-gray-100 " style={{
    maskImage: sourceUrl,
    maskRepeat: "no-repeat",
    maskPosition: "center center"
  }} />
                    </div>}
                <span className="inline-block align-middle font-semibold fill-gray-800 dark:fill-gray-100 text-gray-800 dark:text-gray-100 pl-1 pr-2">{text}</span>
                {iconLocation === 'after' && <div className="h-3.5 w-3.5 fill-gray-800 dark:fill-gray-100 text-gray-800 dark:text-gray-100 inline-block align-middle mr-2">
                        <svg className="w-4 h-4 bg-gray-800 dark:bg-gray-100 pr-3" style={{
    maskImage: sourceUrl,
    maskRepeat: "no-repeat",
    maskPosition: "center center"
  }} />
                    </div>}
            </div>
        </>;
};

This serves as a knowledge base for Insights. For a general overview of Insights & Dashboards, see the [Overview](./overview) section.

## What is an insight

Insights are the main building block of your custom marketing analytics.
They allow you to visualize customer events, ad platform metrics, and first-party attribution metrics, and analyze how you acquire customers.

## How to create your first insight

1. From the sidebar click on <IconText text="Insights" name="plus" iconLocation="after" /> and click on **Create new Insight**.

2. This will open the query builder, click on the <Icon name="pencil" />-icon next to "Unnamed insight" and give it a name, e.g. `Revenue over time`.
   <Frame>
     <img src="https://mintcdn.com/converge/ecGnucKsPgTlQzkL/images/insights-dashboards/naming-an-insight.png?fit=max&auto=format&n=ecGnucKsPgTlQzkL&q=85&s=57b004b383fe37dedb70d6e9aa65f372" alt="Insight name" width="820" height="141" data-path="images/insights-dashboards/naming-an-insight.png" />
   </Frame>

3. Click on the <Icon name="check" />-icon to save the new name.

4. Click on <IconText text="Add metric" name="plus" />

5. Click on <IconText text="Revenue" name="dollar-sign" />
   <Frame>
     <img src="https://mintcdn.com/converge/zWlDFBz7l1F_0PFn/images/insights-dashboards/add-metric.png?fit=max&auto=format&n=zWlDFBz7l1F_0PFn&q=85&s=e4034c394112755c250384d0c4c0e9ee" alt="Add metric" width="1340" height="602" data-path="images/insights-dashboards/add-metric.png" />
   </Frame>

6. Click on <IconText text="Create insight" name="floppy-disk" /> in the top right corner.

7. You've created your first insight.
   <Frame>
     <img src="https://mintcdn.com/converge/ecGnucKsPgTlQzkL/images/insights-dashboards/revenue-over-time.png?fit=max&auto=format&n=ecGnucKsPgTlQzkL&q=85&s=834e6be6e948a6abe4d01c51d792b84d" alt="Insight created" width="2078" height="1001" data-path="images/insights-dashboards/revenue-over-time.png" />
   </Frame>

## Insight Building Blocks

Insights are extremely flexible, you can configure the exact insight you want across these dimensions:

* [Metrics](./metrics): Choose which values you'd like to display
* [Visualization Types](./visualization-types): Insights can show up as tables, line charts, pie charts, etc.
* [Filters](./filters): You can flexibly filter in or out based on session, event, attribution, or ad platform properties
* [Breakdowns](./breakdowns): You can break down insights across session, event, attribution, or ad platform properties
* [Cohorts](./cohorts): We support specific cohort-based insights