# Adding custom fields

{% hint style="info" %}
Custom fields can only be added by an Administrator.
{% endhint %}

Custom fields allow you to add a new, **registry-wide** field to metadata items that aren't included in the ISO 11179 standard.

### How to add a custom field <a href="#how_to_add_a_custom_field" id="how_to_add_a_custom_field"></a>

1. Select 'Administrator tools' from your Dashboard side panel, then 'Manage Custom Fields'.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2F2wc53OWMQJprt3CU81W0%2Fimage.png?alt=media&#x26;token=8323c01b-157a-4665-995f-a19aecf78824" alt=""><figcaption></figcaption></figure>

2. **If you wish to add a custom field usable by all metadata item types,** select 'Edit' from the '*All*' row. **If you wish to add a custom field usable only by a single metadata item type*****,*** select 'Edit' from the row matching the desired metadata item type.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FedgfagsDnbfCUbV1jv2u%2Fimage.png?alt=media&#x26;token=04fd0bc8-ad03-45ed-87f3-bce1e913c104" alt=""><figcaption></figcaption></figure>

3. Select 'Add Custom Field for \[*chosen metadata item type(s)*]'.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FqZayZ8ceEXh2wbs1o2C2%2Fimage.png?alt=media&#x26;token=20eadc93-5c70-4c68-8331-56eb1ec12c66" alt=""><figcaption></figcaption></figure>

4. Enter a name, value type, and system name into the 'Name', 'Type' and 'System name' fields respectively, along with optional help text in the 'Help text' field if desired.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FXdpeWpeLOnDyNUXWlJap%2Fimage.png?alt=media&#x26;token=90377979-1e2a-4bc1-9e54-57c17244a593" alt=""><figcaption></figcaption></figure>

5. Use the 'Visibility' dropdown to select what roles the custom field will be visible to, and the 'State' dropdown to enable or disable the field for use in the registry.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FQF8swYdDro9MI3ntVyGa%2Fimage.png?alt=media&#x26;token=69d967e1-4d8a-43c0-8db0-f8da645d2aeb" alt=""><figcaption></figcaption></figure>

6. Select 'Submit Edits' when you are satisfied.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FI2PKCUmoBYIbZccMrQDJ%2Fimage.png?alt=media&#x26;token=7859321c-7987-49f7-882c-ecda4c570ae2" alt=""><figcaption></figcaption></figure>

7. Once saved, your custom fields will appear in the 'Slots' tab of the metadata item editor when creating or editing an item.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FGbjySdc2miDD4m9RYvjo%2Fimage.png?alt=media&#x26;token=66dfd306-1a8a-46f7-9824-7f26974f7a93" alt=""><figcaption></figcaption></figure>

**Note:** Upon creation, custom fields will not be searchable. A [reindex task](https://help.aristotlemetadata.com/administrator-tasks/task-runner/resolving-issues-with-search-using-reindex) must be completed in order to search for a metadata item by its custom field(s).
