# Working with custom entity types

The entity types list includes any custom entity types that are active for the dataset. From the **Entity settings** page, you can enable and disable custom entity types.

You can also update the configuration of a regex-based custom entity type, and go to the details page for a model-based custom entity type.

## Enabling and disabling custom entity types <a href="#dataset-custom-entity-enable-disable" id="dataset-custom-entity-enable-disable"></a>

{% hint style="info" %}
**Required dataset permission:** Edit dataset settings
{% endhint %}

The entity types list includes the custom entity types that are active for the dataset.

To manage which custom entity types are active for the dataset:

1. Click **Custom entity types**.
2. On the **Enable custom entity types** panel, to search for specific entity types, begin to type text in the entity type name. As you type, Textual updates the list to only display matching entity types.

<figure><img src="https://3072847115-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvOPn7KQptPWmS5iKg5P0%2Fuploads%2Fdccwz2Tm5nK1TPHgPDCF%2FDatasetEnableCustomEntityTypes.png?alt=media&#x26;token=222f2a58-94d9-479f-a3ae-8a0f5fea36a6" alt=""><figcaption><p>Enable custom entity types panel for a dataset</p></figcaption></figure>

3. To enable a custom entity type for the dataset, set its toggle to the on position.
4. To disable a custom entity type for the dataset, set its toggle to the off position.
5. To enable all of the custom entity types for the dataset, click **Bulk**, then click **Enable all**.
6. To disable all of the custom entity types for the dataset, click **Bulk**, then click **Disable all**.

## Updating the configuration of a regex-based custom entity type <a href="#dataset-custom-entity-edit" id="dataset-custom-entity-edit"></a>

{% hint style="info" %}
**Required global permission - either:**

* Create custom entity types
* Edit any custom entity type
  {% endhint %}

From the dataset details, you can edit the configuration of a regex-based custom entity type. To edit a regex-based custom entity type, click the settings icon for that type.

Note that any changes to the custom entity type settings affect all of the datasets that use the custom entity type.

For information on how to configure a custom entity type, go to [#custom-entity-type-config](https://docs.tonic.ai/textual/entity-types/entity-types-custom#custom-entity-type-config "mention").

## Viewing the details for a model-based custom entity type  <a href="#model-based-custom-view-details" id="model-based-custom-view-details"></a>

{% hint style="info" %}
**Required global permission - either:**

* Create custom entity types
* Edit any custom entity type
  {% endhint %}

For a model-based custom entity type, to display the details for the entity type, click the settings icon.

Textual displays the entity type details in a new browser tab.

## Running a new scan to reflect custom entity type changes <a href="#dataset-scan-entity-type-changes" id="dataset-scan-entity-type-changes"></a>

When you enable, disable, or edit custom entity types, the changes do not take effect until you run a new scan on each file.

Textual marks each file as requiring a rescan, and displays a prompt to rescan all of the files.

<figure><img src="https://3072847115-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvOPn7KQptPWmS5iKg5P0%2Fuploads%2Fn0uPQqY8P9EhE4uTgjHD%2FDatasetDetails_FilesScanRequired.png?alt=media&#x26;token=418918ba-807d-4179-9ae6-fc735c821a1c" alt=""><figcaption><p>Dataset files when a rescan is required</p></figcaption></figure>

To run a new scan for a file, click its scan option.

<figure><img src="https://3072847115-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvOPn7KQptPWmS5iKg5P0%2Fuploads%2FVW4PPUJIQnWwJ9QGlHfG%2FDatasetFileRescanMarkerAndOption.png?alt=media&#x26;token=4a5134fd-f591-4207-9360-bfa424bd31ed" alt=""><figcaption><p>Rescan option for an individual dataset file</p></figcaption></figure>
