---
title: "Reveal Analytics Requirements"
slug: "reveal-analytics-requirements"
tags: ["analytics", "Requirements", "email threading", "analytics data mapping", "analytics requirements"]
updated: 2026-04-16T20:45:31Z
published: 2026-04-16T20:45:31Z
---

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

# Reveal Analytics Requirements

In order to leverage Reveal's data analytics features, there are a few minimum requirements that must be met:

1. Ingest at least 300 documents with text in the Extracted or OCR / Loaded text set.
2. Map and ingest all metadata fields listed in “The complete analytics field mapping” section.

For metadata field descriptions, please see [Reveal Field Mapping Matrix & Definitions](/reveal/docs/reveal-field-mapping-matrix-definitions).

## The complete analytics field mapping

Mapping and ingesting all the fields in the Required Fields table will allow for the use of all of Reveal’s analytics features. To see field mapping for individual analytics features, reference the [Field mapping by feature](/reveal/docs/reveal-analytics-requirements#field-mapping-by-feature) section.

| Reveal Display Name | Reveal Field Name |
| --- | --- |
| Begin Number | BEGDOC |
| Begin Number Attach | BEGATTACH |
| Bcc | BCC |
| Cc | CC_ADDRESSES |
| Conversation ID | CONVERSATION_ID |
| Date Sent | SENT_DATE |
| Duplicate ID | MD5_HASH |
| Email Subject | SUBJECT_OTHER |
| From | SENDER |
| Item ID* | ITEMID |
| Parent ID* | PARENT_ITEMID |
| To | RECIPIENT |

*Item ID and Parent ID are auto-generated by the system. Parent ID should not be mapped if Begin Number Attach is not provided during initial data load.

## Field mapping by feature

Navigate the below tabs to see which features require certain fields. All fields listed below are included in [The complete analytics field mapping](/reveal/docs/reveal-analytics-requirements#the-complete-analytics-field-mapping-table) table.

**Communications**

### Communications required fields

The following fields are required to use Reveal’s Communications feature.

| Reveal Display Name | Reveal Field Name |
| --- | --- |
| Bcc | BCC |
| Cc | CC_ADDRESSES |
| From | SENDER |
| To | RECIPIENT |

**Dup Detection**

### Duplicate Detection required fields

The following fields are required to use Reveal’s duplicate detection feature.

| Reveal Display Name | Reveal Field Name |
| --- | --- |
| Duplicate ID | MD5_HASH |

**Email Threading**

### Email threading required fields

The following fields are required to use Reveal’s email threading feature.

| Reveal Display Name | Reveal Field Name |
| --- | --- |
| Bcc | BCC |
| Cc | CC_ADDRESSES |
| Conversation ID | CONVERSATION_ID |
| Date Sent | SENT_DATE |
| Email Subject | SUBJECT_OTHER |
| From | SENDER |
| Parent ID* | PARENT_ITEMID |
| To | RECIPIENT |

*Parent ID is auto-generated by the system.

**Family Relationships**

### Family relationships

The following fields are required for Reveal to map family relationships.

| Reveal Display Name | Reveal Field Name |
| --- | --- |
| Begin Number Attach | BEGATTACH |

## Related

- [About Ask](/about-ask.md)
- [Translate (Translation)](/translate-translation.md)
- [Analyze and Search Emotional Intelligence](/analyze-and-search-emotional-intelligence.md)
- [Email Threading Overview](/email-threading-overview.md)
- [System Overview](/system-overview.md)