# Customer insights - Admin Block

The **Customer Insights block** brings key Hubble-specific data directly into your Shopify Admin so your team can see exactly what our targeting engine sees — no confusion, no missing context.

## Why use the Customer Insights block?

Shopify doesn’t always show the full picture. For example, **test orders** are excluded from the default order count in the customer profile. Hubble, however, uses all data — including test orders — when evaluating [conditions](https://docs.overse.app/hubble/conditions).

By installing the **Customer Insights block**, you get:

* ✅ Accurate **number of orders**, including test orders
* ✅ Account creation date
* ✅ Marketing opt-in status
* ✅ Full alignment between what Hubble sees and what your team sees
* ✅ And more as we add more rules to [conditions](https://docs.overse.app/hubble/conditions).

{% hint style="info" %}
This block lives **inside the Shopify Admin customer profile page**, so your team can access it instantly while reviewing a customer.
{% endhint %}

## Visual Example

Here’s how the count can differ:

<figure><img src="https://252181162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgNjbkcqEVwk7mzEfZieR%2Fuploads%2Fgit-blob-25b6ca6d35ed60508cc8f5362e379291dc326fa7%2Fimage%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

> *In this example, Shopify shows only 1 order, but Hubble shows 2 (including a test order).*
>
> \
> \&#xNAN;*With the Customer Insights block, you get the full picture used by our targeting engine.*

## How to set it up

{% stepper %}
{% step %}

#### Go to any customer’s profile in the Shopify Admin

You'll see a section labeled **“App blocks”**.

<figure><img src="https://252181162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgNjbkcqEVwk7mzEfZieR%2Fuploads%2Fgit-blob-e59a3a69e8feb284e88f71805ffb9513ba80f0aa%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Click on "+ App block" and select Hubble's "Customer insights"

Shopify will show a list of available app blocks.

<figure><img src="https://252181162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgNjbkcqEVwk7mzEfZieR%2Fuploads%2Fgit-blob-98c473d960e8f62bfbd3bbc644e9a9c01c38d409%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### (Optional but recommended): Pin it

Click the **pin icon** to keep the block visible by default for all staff.

<figure><img src="https://252181162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgNjbkcqEVwk7mzEfZieR%2Fuploads%2Fgit-blob-7a8b3adcfcd63a906d061e3e0c49b65013a06aa2%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### ✅ Done!

You should now see the full customer insights block every time you visit a customer’s profile:

<figure><img src="https://252181162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgNjbkcqEVwk7mzEfZieR%2Fuploads%2Fgit-blob-0961ee4ecb0a8462019244d68ba3095138acdc57%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}


---

# Agent Instructions: 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:

```
GET https://docs.overse.app/hubble/analytics/customer-insights-admin-block.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
