---
title: Correlate Records
slug: user-guide-10x/correlate-records
docTags: 
createdAt: 2025-06-18T11:01:38.790Z
---

Record correlation correlates records within a single application within the Swimlane platform. Upon ingestion of new Application records, the platform compares the new record to previous records that have correlation keys.

Record Correlation executes two tasks:

- Compares Correlation Key fields across records in a single application, looking for configurable similarities.
- Creates References in a Reference field among associated records.

The correlation field types in the following table are aligned with their default configurations and will be compared with the matching preferences on the Settings tab:

| **Correlation Field Type**                     | **Value and Default Information**                                                                                                                   |
| ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| IPv4 public addresses                          | Plus or minus 255 values. Example: 10.10.11.0 – 10.10.10.254 = 2                                                                                    |
| IPv4 private addresses                         | Exact match between addresses                                                                                                                       |
| IPv6 public addresses                          | Within 65535 values                                                                                                                                 |
| Domains, URLs, file names, and email addresses | Has a threshold of 90% similarity, calculated via “lengthwise Levenshtein” of less than 1 character substitution per 10 characters of string length |
| File attachments                               | Fuzzy hash similarity greater than or equal to 90%                                                                                                  |
| Text list fields                               | Matches process as entry fields, so 2 items will match with 2.                                                                                      |

## Configure Record Correlations

To configure record correlations:

1. From the Navigation menu, select **Applications and Applets**.
2. Click the **plus** icon, and then click **Create a new application**.

::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/jJWHkYWzQC7a-Bml2eXj5_create-a-new-application-button.png" size="26" width="433" height="317" position="center" showCaption="false"}

1. On Create Application, complete the **Name** field. You can click the GENERAL, ADMINISTRATION, RECORDS, or WORKSPACE tabs to add information or use the **Next** and **Prev** buttons to move through the tabs.
2. Click **+Create**.

::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/6LZW5GXVtVFYaZFu81v8t_create-application-window-alerts.png" size="38" width="955" height="521" position="center" showCaption="false"}

Once you click the +Create button, the new application opens in the application builder.

The FORM LAYOUT section will be blank.

::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/TsLUoRAVunW-xGU1X1lQn_blank-form-layout.png" size="62" width="1632" height="886" position="center" showCaption="false"}

1. Click and drag the following field types into the FORM LAYOUT section to start building your application: **Text**, **IP**, **URL**, and **Correlation**.

The FORM LAYOUT section will reflect all of the required field types for record correlation.

::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/FdHsdOK8B4Pr544-xHXfO_alert-form-layout-fields.png" size="58" width="1560" height="835" position="center" showCaption="false"}

Now, record correlation has been enabled for this application. The field named **Correlation Results** will display the correlation results.

1. To setup correlation settings, click **Manage correlation settings** hyperlink.

::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/capMorqCzIXok8eRZsFRw_manage-correlation-settings-hyperlink.png" size="48" width="1560" height="835" position="center" showCaption="false"}

From the Record Correlation window, you will be able to manage data.

1. For details about how record correlation executes and default values for specific Correlation field types, click the **Documentation** tab.

::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/Z8YZNRR_HCnk3HmmU6VxI_record-correlation-documentation-tab.png" size="50" width="900" height="717" position="center" showCaption="false"}

Once you have read details about the correlation process and data, navigate back to the **Settings** tab.

::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/6dnQq_Tgz_FOrkMfwnwNa_record-correlation-settings.png" size="40" width="896" height="746" position="center" showCaption="false"}

From Settings, there will be three Matching Preferences fields: **Matching Timeframe**, **Matching Threshold**, and **Minimum number of matching fields**. Each field has a default value. Click within the field to modify the default value.

1. After you set the Matching Preferences, click the **Correlation Field** drop-down arrow and select a field type.

   ::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/C_cW1Ja3Apo4GGrmti8AZ_correlation-field-dropdown.png" size="30" width="897" height="664" position="center" showCaption="false"}

   i> **Tip:** Click **Add a Correlation Field** to create another drop-down list.
   Complete this for each required Correlation Field drop-down.

   ::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/2g2eUNm5INzmKoQu0FG4Z_completed-record-correlation-settings.png" size="42" width="900" height="750" position="center" showCaption="false"}
2. To save record correlation settings, click **Apply**.