---
title: "Modify the Brainspace Native File Whitelist"
slug: "modify-the-brainspace-native-file-whitelist"
tags: ["modify", "native", "whitelist", "change"]
updated: 2025-04-25T06:44:36Z
published: 2025-04-25T06:44:36Z
canonical: "docs.revealdata.com/modify-the-brainspace-native-file-whitelist"
---

> ## 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.

# Modify the Brainspace Native File Whitelist

This topic describes how to modify the default Brainspace native file whitelist when creating a new dataset with a native connector and for an existing dataset with a native connector.

The default Brainspace native file whitelist is tested and verified. Modifying the default Brainspace whitelist could cause issues when building datasets. If you encounter issues when building datasets with native connectors, see [***Native Ingest Troubleshooting***](/brainspace/docs/native-ingest-troubleshooting).

> [!WARNING]
> **Important**
> 
> The whitelist is global. Modifications to the whitelist affect all ingests for all datasets that use the native file analysis (NFA) plugin throughout the Brainspace application, not just a specific connector or dataset.

### Modify the Brainspace Whitelist When Creating a New Dataset

To modify the default Brainspace whitelist for a new dataset with a native connector:

1. In the user drop-down menu, click **Administration**. The Datasets page will open.

![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/modify-the-brainspace-native-file-whitelist-image-8qwxpzzz.jpg)
2. In the Datasets screen, click the **Add Dataset** button. The New Dataset dialog will open.

![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/modify-the-brainspace-native-file-whitelist-image-s2wg646q.png)
3. In the New Dataset dialog, type a **Dataset Name**, and then toggle switches in the **Dataset Groups** pane to add the new dataset to one or more groups:

![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/modify-the-brainspace-native-file-whitelist-image-kr349pnz.jpg)
4. Click the **Create** button. The Dataset Settings dialog will open.
5. Click the **Choose Connector** button:

![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/image(127).png)
6. The Choose Connector dialog will open.
7. In the Choose Connector dialog, click the appropriate native connector in the list.
8. In the Select a Source dialog, click the folder that contains the native documents, and then click the **Save and Proceed** button.
9. In the Native Source dialog, click the **Browse** button. The Select Folder for Path to Native Files dialog will open.
10. Select a folder, and then click the **Select Current Folder** button. The Native Source dialog will refresh.
11. Click the **Proceed** button. The License Checks dialog will open and run a check on your license document limits.
12. After Brainspace verifies the license document limits, click the **Confirm** button. The Field Mapping dialog will open.

![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/modify-the-brainspace-native-file-whitelist-image-zem9t4db.jpg)
13. Map the required fields and any additional fields, and then click the **Continue** button.The Dataset Settings dialog will refresh.

> [!NOTE]
> Note
> 
> For more information about mapping fields, see [***Field Mapping Categories and Definitions***](/brainspace/docs/field-definitions).
14. Click the **Save** button.
15. Using command-line interface, navigate to */var/lib/brains/.brainspace/plugins/natives-plugin-6.1.0/native-doc-whitelist.txt.*
16. Edit the *native-doc-whitelist.txt* file, and then save the whitelist in the same directory location.
17. Return to the Dataset Setting dialog in the Brainspace graphical-user interface, and then click the **Build** button. The Dataset Build Options dialog will open.
18. Choose a build option, and then click the **Run This Build Type** button. The Schedule Build dialog will open.
19. Click the **Build as soon as possible** button.

> [!NOTE]
> **Note**
> 
> If you choose to build the dataset in the future, click the Schedule Build Time field, select a date and time, and then click the Save button.
20. The Datasets page will refresh and show the Dataset Queue build in progress:

![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/modify-the-brainspace-native-file-whitelist-image-vkzq1p9z.jpg)
21. While the build is in progress, you can click the View Status button to view the build steps in progress.

After the build completes successfully, the new dataset will move from the Dataset Queue to the list of active datasets in the Datasets page.

### Modify the Brainspace Whitelist for an Existing Dataset

> [!NOTE]
> **Not**e
> 
> The default Brainspace native file whitelist is tested and verified. Modifying the default Brainspace whitelist could cause issues when building datasets. If you encounter issues when building datasets with native connectors, see [***Native Ingest Troubleshooting***](/brainspace/docs/native-ingest-troubleshooting).

To modify the default Brainspace whitelist for an existing dataset with a native connector:

1. Using command-line interface, navigate to */var/lib/brains/.brainspace/plugins/natives-plugin-6.1.0/native-doc-whitelist.txt.*
2. Edit the **native-doc-whitelist.txt** file, and then save the whitelist in the same directory location.
3. In the user drop-down menu of the Brainspace graphical-user interface, click **Administration**:

![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/modify-the-brainspace-native-file-whitelist-image-xsocblax.jpg)
4. The Datasets page will open.
5. Locate the dataset in the Datasets list, and then click the **dataset**. The Dataset Setting dialog will open.
6. Click the **Build** button.The Dataset Build Options dialog will open.
7. Choose a build option, and then click the **Run This Build Type** button. The Schedule Build dialog will open.
8. Click the **Build as soon as possible** button.

> [!NOTE]
> Note
> 
> If you choose to build the dataset in the future, click the Schedule Build Time field, select a date and time, and then click the **Save** button.
9. The Datasets page will refresh and show the Dataset Queue build in progress:

![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/modify-the-brainspace-native-file-whitelist-image-pvn2qgln.jpg)

While the build is in progress, you can click the View Status button to view the build steps in progress.

After the build completes successfully, the new dataset will move from the Dataset Queue to the list of active datasets in the Datasets page.

## Related

- [Native Ingest Troubleshooting](/native-ingest-troubleshooting.md)
- [Create a Dataset with a Native Connector](/create-a-dataset-with-a-native-connector.md)
- [Create and Manage a Native Connector](/create-and-manage-a-native-connector.md)