# Creating and editing custom HTML templates

{% hint style="info" %}
Only users with the following permissions are able to add HTML to the registry header or footer:

* 'Allow user to manage and change templates'
* 'Allow user to manage and change the home pages'.

**Notes:**

* You will need intermediate web skills using HTML or CSS to add custom HTML to the registry header or footer
* See [here](https://help.aristotlemetadata.com/administrator-tasks/managing-user-accounts) for editing the above user permissions (Administrators only).
  {% endhint %}

{% hint style="info" %}
Overriding templates can have unexpected consequences - such as disabling actions, breaking layouts or preventing users from accessing your registry. Only make changes if you are confident in what you are doing.
{% endhint %}

Users with the appropriate permissions can use custom HTML to personalize the registry's header and footer.

### How to create and edit custom HTML templates

1. Select 'Site page tools' from the dashboard side panel.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FcB9KyEiPKFC0w2MF4jry%2Fimage.png?alt=media&#x26;token=22517e97-4f31-4e8b-81e1-eafa7c4d1d03" alt=""><figcaption></figcaption></figure>

2. Select 'Edit templates'.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FWD0LEUvf2BG5QmUY6ESY%2Fimage.png?alt=media&#x26;token=145763e9-ff33-4d8d-bb52-65ab2149bc31" alt=""><figcaption></figcaption></figure>

3. Select 'Create New Template'.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FQsnpkOaOWNBEPdMQ6BnC%2Fimage.png?alt=media&#x26;token=b921eaf4-872d-4d42-b62b-4cdc692c8f9b" alt=""><figcaption></figcaption></figure>

4. From this page, the following options can be adjusted:

* 'Name': The template name that will be overridden

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FTYvdYEXkdVdQsKFjrjOn%2Fimage.png?alt=media&#x26;token=f34d9e6c-81ca-4672-b186-9aabac839db5" alt=""><figcaption></figcaption></figure>

**Note:** For example template names, see [Default customisation templates](#default-customization-templates) below.

* 'Is active': Whether or not the template being created will be currently active upon submission. Inactive templates are only visible to template editors when previewing templates

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2F69I9oXnzOnCwgLKkz5Y2%2Fimage.png?alt=media&#x26;token=edee72bf-1569-4db5-9815-a0d1935cf371" alt=""><figcaption></figcaption></figure>

* 'Description': A field to describe the template's purpose, location, etc.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FDloE4of1EBAi9C2gD9KP%2Fimage.png?alt=media&#x26;token=36c5e975-ed29-48d7-bdc0-a4b1632016b6" alt=""><figcaption></figcaption></figure>

* 'Content': The HTML content to be used in the template upon submission.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2F1kpe7VKBzc8iPCaidCsq%2Fimage.png?alt=media&#x26;token=aacb4921-f8e3-4982-b50f-689a4af123e4" alt=""><figcaption></figcaption></figure>

5. Select 'Submit'. The changes will be immediately visible.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2F9nLbZwDovNG6pEyuVDZA%2Fimage.png?alt=media&#x26;token=e385af98-4214-483d-94eb-65394b0a077c" alt=""><figcaption></figcaption></figure>

### Previewing or deleting a draft template

1. Select 'Site page tools' from the dashboard side panel.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FcB9KyEiPKFC0w2MF4jry%2Fimage.png?alt=media&#x26;token=22517e97-4f31-4e8b-81e1-eafa7c4d1d03" alt=""><figcaption></figcaption></figure>

2. Select 'Edit templates'.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FWD0LEUvf2BG5QmUY6ESY%2Fimage.png?alt=media&#x26;token=145763e9-ff33-4d8d-bb52-65ab2149bc31" alt=""><figcaption></figcaption></figure>

3. **If you wish to delete a custom HTML template**, select the desired template's 'Delete' option. **If you wish to preview a custom HTML template**, select the desired template's 'Preview' option.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FdUuPXSckEj3A26h4YKkF%2Fimage.png?alt=media&#x26;token=847d05de-1c0a-4f36-9192-688b3a919f63" alt=""><figcaption></figcaption></figure>

**Notes:**

* Selecting 'Delete' will take you to the below page. Select 'Delete Template' to confirm deletion.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FTNuzMJZaYaRzc5VFpylT%2Fimage.png?alt=media&#x26;token=567b4bd9-5562-4a2b-bdec-94f47d6c100f" alt=""><figcaption></figcaption></figure>

* Previewing a template will alter the URL bar to send you to the homepage and view the selected template's changes using  the `preview_template_ids` query parameter and the id of the template being edited.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FllOTcdwJya6RWNCMRcgl%2Fimage.png?alt=media&#x26;token=e7e07d34-fc97-4038-a35a-0babef45f805" alt=""><figcaption></figcaption></figure>

### **Default customisation templates**

Options: Header, Neck, Body, Ankle, Footer, Sole

There are other customisations for the header and footer that can only be achieved by requesting the Aristotle Metadata team. See the screenshot below as an example:

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FCFYozTh86x3AIXGa4p7N%2F1.png?alt=media&#x26;token=52707064-9c1c-4248-b7cd-56ad970d9eac" alt=""><figcaption></figcaption></figure>

You can alter these sections of the page by making custom templates for the following sections:

* **Header:** `aristotle_cloud/custom/header.html`
* **Neck:** `aristotle_cloud/custom/neck.html`
* **Footer:** `aristotle_cloud/custom/footer.html`
* **Ankle:** `aristotle_cloud/custom/ankle.html`