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

# Insights Data Filters and Annotations

> Add filters and custom annotations to your payments data visualizations, homing in on the data most important to your business.

![Chart with filters and annotations applied.](https://mintcdn.com/pagossolutionsinc/Xv1w1qAeWSzhiVBO/images/insights/filters-annotation.png?fit=max\&auto=format\&n=Xv1w1qAeWSzhiVBO\&q=85\&s=93fe6e36cf1c6b8c2bfbf702d4bdca8a)

## Applying Filters

Use Insights' built-in filters to refine your aggregated payments data by properties like processor, card brand, currency, and more. You can combine filters to view specific segments of data.

**1. Apply Date Range filter**

Click the drop-down menu in the top-right corner of the dashboard.

**2. Apply other filters**

Click **Add Filter**.

**3. Select filter parameters**

Click a filter in the drop-down menu, select your preferred filter parameters, then click **Apply Filters**.

**4. Add additional filters**

Click **More Filters**, then repeat the previous steps to select a filter and the desired filter parameters.

> [!NOTE]
>
> If you've created [custom MID hierarchies](https://docs.pagos.ai/getting-started/managing-your-pagos-organization.md#adding-a-custom-mid-hierarchy) within your Pagos Organization, click the dropdown beneath your company name in the top-left corner of the Pagos Service panel to access a list of your hierarchy categories and subcategories. Click an option to filter the entire service panel to only show data for that business segment.

## Filter Options

Depending on the page or section of Insights you're in, you may see any of the following filter options:

> [accordion] Date Range
>
> Set a date range, along with a time interval to group the data by (hour, day, week, month, quarter, or year). Click **Custom date until now**, then select a start date to view data between that date and today; click **Custom dates** to choose a start and end date for your data.
>
> > [!NOTE]
> >
> > * Hourly data is only available for date ranges of up to seven days. Larger date ranges default to a daily grouping.
> > * Daily data is only available for date ranges of up to 365 days. Larger date ranges default to a weekly grouping.

> [accordion] Processor
>
> View data for transactions processed through the selected processor.

> [accordion] Data Connection
>
> View data for transactions processed through the selected data connection.

> [accordion] Merchant Account ID
>
> View data for transactions processed through the selected merchant account ID. If you've [assigned aliases to your Merchant Account IDs](https://docs.pagos.ai/importing-data/managing-data-connections.md#adding-a-merchant-account-id-alias), those alias names will appear in the filter menu.

> [accordion] MCC
>
> View data for transactions associated with the selected Merchant Category Code (Chase only).

> [accordion] Card Brand
>
> View data for transactions made using payment cards from the selected card brands.

> [accordion] Card Type
>
> View data for transactions made with the selected payment card types (e.g. credit, debit, prepaid).

> [accordion] Prepaid Reloadable Type
>
> View data for transactions made with the selected prepaid card type (Reloadable, Non Reloadable, Not Applicable, or No Value Provided).

> [accordion] Card Product
>
> View data for transactions made with the selected [card product](https://docs.pagos.ai/payments-basics/card-brand-services/bin-product-code-guide.md).

> [accordion] Card Product Category
>
> View data for transactions made with the selected card product category (e.g. Business, Consumer, Healthcare, etc.).

> [accordion] Payment Method
>
> View data for transactions made with the selected payment methods (e.g. amazon\_pay, android\_pay, apple\_pay, card, google\_pay, PayPal wallet, sepa, klarna, and ideal).

> [accordion] Stored Credential
>
> View data for the selected transaction types, identified by their use of [stored payment credentials](https://docs.pagos.ai/payments-basics/the-stored-credential-field.md) (e.g. one-time, recurring, installment).

> [accordion] Network Token
>
> View data for transactions made with customer primary account numbers (PANs) or network tokens.

> [accordion] Transaction Status
>
> View data for transactions with the selected status at the time indicated in the **Date Range** filter.

> [accordion] Transaction Response Code
>
> View data for transactions with the selected issuer response codes (e.g. do\_not\_honor, expired\_card, decline\_gateway, etc.).

> [accordion] Transaction Size
>
> View data for transactions whose total value was greater than, less than, or between the indicated amount(s) in USD; for transactions processed in other currencies, view data for transactions whose total value converts to the filtered USD amount.
>
> If applied to a chart demonstrating chargeback data, this filter applies to the size of the original transaction. Use the [Chargeback Size](#chargeback-size) filter to filter for specific chargeback values.

> [accordion] Deduplication
>
> Remove duplicate transaction data (e.g. [retries](https://docs.pagos.ai/payments-basics/transaction-retry-deduplication.md)) from your visualizations. At this time, the retry deduplication filter doesn't apply to duplicate retries processed through PayPal, dLocal, or Klarna.
>
> If you imported historical payments data into your Pagos account at signup, the retry deduplication filter may not apply to your historical data. Some processors don't provide all the necessary details (e.g. BIN, last four digits, or expiration date) with historical data imports to meet the retry filter's logic.

> [accordion] Issuing Bank
>
> View data for transactions made using payment cards issued by the selected issuing banks.

> [accordion] Issuing Region
>
> View data for transactions made with cards issued in the selected regions.

> [accordion] Issuing Country
>
> View data for transactions made with cards issued in the selected countries.

> [accordion] Durbin Regulated
>
> View data for transactions made with Durbin-regulated cards or those that are exempt from Durbin. [Learn more about the Durbin Amendment.](https://docs.pagos.ai/payments-basics/the-durbin-amendment.md)

> [accordion] Fintech Brand
>
> The fintech, neobank, BNPL, or wallet card program a card's BIN belongs to (e.g. Chime, Cash App, Nubank), matched on the most specific known BIN prefix (8 digits where available, else 6). Available only in [Charts](https://docs.pagos.ai/insights/charts.md).

> [accordion] Fintech Category
>
> The kind of fintech card program a card's BIN belongs to (e.g. neobank, BNPL, prepaid, earned-wage access, crypto). Available only in [Charts](https://docs.pagos.ai/insights/charts.md).

> [accordion] Customer Region
>
> View data for transactions made by customers located in the selected regions.

> [accordion] Customer Country
>
> View data for transactions made by customers located in the selected countries.

> [accordion] Presentment Currency
>
> View data for transactions processed in the selected presentment currencies.

> [accordion] Settlement Type
>
> View data for transaction events of the selected [**settlement type**](https://docs.pagos.ai/response-codes/settlement-type-codes.md).

> [accordion] Settlement Currency
>
> View data for transaction events settled in the selected currency.

> [accordion] BIN
>
> View data for transactions made with payment cards with the selected bank identifier numbers (BINs).

> [accordion] CVV
>
> View data for transactions with the selected [CVV response codes](https://docs.pagos.ai/response-codes/cvv-check-response-codes.md).

> [accordion] AVS Line Code
>
> View data for transactions with the selected [AVS line codes](https://docs.pagos.ai/response-codes/avs-response-codes.md#avs-line-code).

> [accordion] AVS Post Code
>
> View data for transactions with the selected [AVS post codes](https://docs.pagos.ai/response-codes/avs-response-codes.md#avs-post-code).

> [accordion] Rapid Dispute Resolution
>
> View data for disputed transactions resolved by Visa as Rapid Dispute Resolution. Transactions from any other card brand will be categorized as *No Value Provided*.

> [accordion] Chargeback Status
>
> View data only for disputed transactions with the selected [chargeback status code](https://docs.pagos.ai/response-codes/chargebacks/chargeback-status-codes.md).

> [accordion] Chargeback Reason
>
> View data only for disputed transactions with the selected [chargeback reason code](https://docs.pagos.ai/response-codes/chargebacks/chargeback-reason-codes.md).

> [accordion] Chargeback Size
>
> View data for chargebacks whose total value was greater than, less than, or between the indicated amount(s) in USD; for chargebacks made in other currencies, view data for chargebacks whose total value converts to the filtered USD amount.

> [accordion] POS Entry Mode
>
> View data only for transactions where the customer's payment card information was captured in the selected manner. See [**POS Entry Mode Codes**](https://docs.pagos.ai/response-codes/pos-entry-mode-codes.md) for all possible values.

> [accordion] Adyen Retry Attempt
>
> View data for Adyen transactions tagged with specific retry flags (Adyen retries some failed transaction attempts multiple times based on their own internal logic; when we pull your transaction data from Adyen, we only ingest the final attempt of a retried Adyen transaction, tagging it with a custom retry flag indicating the total number of times Adyen attempted the transaction).

> [accordion] Track Device Data
>
> View data for transactions the processor collected device data for or did not. At this time, this filter only applies to transactions processed through Braintree; transactions processed through other processors will be categorized under *No Value Provided*.

> [accordion] Soft Descriptor
>
> View data for transactions tagged with specific soft descriptors; if you're unsure what soft descriptors you currently use, check out the **Soft Descriptors** tab in the [**Custom Data**](https://docs.pagos.ai/insights/custom-data.md#soft-descriptors) section of your Pagos account.

> [accordion] Metadata
>
> View data for transactions tagged with specific metadata. Click **Metadata Name** to select the metadata field, enter the metadata value, then click **Add**; if you're unsure what metadata values you currently use, check out the **Metadata** tab in the [**Custom Data**](https://docs.pagos.ai/insights/custom-data.md#metadata) section of your Pagos account.

> [accordion] Fee Type
>
> View cost data associated with specific [fee types](https://docs.pagos.ai/response-codes/fees/fee-type-codes.md).

> [accordion] Fee Category
>
> View cost data associated with specific [fee categories](https://docs.pagos.ai/response-codes/fees/fee-type-category-codes.md).

> [accordion] Fee Subcategory
>
> View cost data associated with specific [fee subcategories](https://docs.pagos.ai/response-codes/fees/fee-type-subcategory-codes.md).

> [accordion] Fee Description
>
> Use the text field to enter a specific raw fee name as it appears in your processor data. The field uses *contains* logic, meaning we'll filter for all raw fee names containing the text you enter. Apply the filter, then export your **Aggregated Data**; the **Fee Descriptions** column identifies the exact raw fee names you filtered for.

> [accordion] Your Custom Dimension
>
> If you’ve worked with your Pagos Account Manager to build out [custom dimensions](https://docs.pagos.ai/getting-started/managing-your-pagos-organization.md#adding-custom-dimensions), you'll see the names of your custom dimension(s) in the drop-down menu. Click the filter option, then type the exact parameter value you want to view data for, then hit **Enter**.
>
> > [!NOTE]
> >
> > **Keep in mind:**
> >
> > * You can only select one parameter from the custom dimension to filter your data by
> > * For a full list of the parameter options available for your custom dimension(s), navigate to **Charts**, [create a chart](https://docs.pagos.ai/insights/charts.md#creating-new-charts) using the custom [dimension](https://docs.pagos.ai/insights/chart-customizations.md#dimensions), and copy the parameter from the chart's legend.

## Annotations

With Annotations, you can tag specific days or date ranges in your Insights data visualizations with additional context. For example, flag the start date of a new marketing campaign, the week you ran an A/B test, or the hour of an outage.

You can add Annotations to the following visualizations within Pagos Insights:

* Custom [Charts](https://docs.pagos.ai/insights/charts.md)
* The main graph on each [Metrics](https://docs.pagos.ai/insights/metrics/overview.md) page
* Individual charts in [Snapshots](https://docs.pagos.ai/insights/snapshots.md)
* Each [Costs](https://docs.pagos.ai/insights/costs.md) page
* The [Chargeback Win Rate By Reason Category](https://docs.pagos.ai/insights/risks.md#chargeback-win-rate-by-reason-category) graph on the **Chargebacks** Risks page

### Creating Annotations

To create a new Annotation:

**Step 1**

From a custom Chart, Snapshot chart, or Metrics page, click **Options**, then click the **gear** icon beside **Show Annotations**.

From a Costs page or the Chargeback Win Rate chart, click **Annotations**.

**Step 2**

At the bottom of the **Annotations** side panel, click **Add New Annotation**.

**Step 3**

Give your Annotation a **Title** (e.g. *Start of Holiday Campaign*) and an optional **Description**. These will appear as a label on the Annotation inside a chart.

**Step 4**

Under **Date**, click the first drop-down menu to select either **Date** or **Date Range**, then use the second drop-down menu to set the specific time period for your Annotation.

**Step 5**

Click the **Applies To** drop-down menu, then select the type(s) of payments data your Annotation applies to. For example, if you only want to see this Annotation on charts demonstrating transaction data, select **Transactions**.

**Step 6**

Click the **Visible To** drop-down menu, then select who in your Pagos Organization can apply your Annotation to charts in Insights:

* **Only Me** - Only you can view your annotation on relevant charts
* **Everyone** - All members of your organization can add your annotation to relevant charts

**Step 7**

Select a **Color** for your Annotation. This determines how it appears on visualizations in Insights.

**Step 8**

Click **Save**.

To edit a saved Annotation, select it in the Annotations side panel, make your changes, and click **Save**. Click **Delete** to remove it entirely.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.