> For the complete documentation index, see [llms.txt](https://help.aristotlemetadata.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aristotlemetadata.com/registry-configuration/creating-and-editing-custom-html-templates.md).

# 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](/administrator-tasks/managing-user-accounts.md) 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="/files/xp4t9fzUFhFuLQ0IUYG9" alt=""><figcaption></figcaption></figure>

2. Select 'Edit templates'.

<figure><img src="/files/La8ZLov6ON08VBXWZONB" alt=""><figcaption></figcaption></figure>

3. Select 'Create New Template'.

<figure><img src="/files/WtxbriJSLeuksy8jeX5O" 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="/files/Yj5jV2cC8GcY3lGopWzW" 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="/files/r8CuqmWW70Ga3adocTnN" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/YbUnBQkmvIAJklcXpFgS" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/eoteHJ3Eq0mRC2UlD8rQ" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/TIAZIi5rIjJ8ftp90lth" alt=""><figcaption></figcaption></figure>

### Previewing or deleting a draft template

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

<figure><img src="/files/xp4t9fzUFhFuLQ0IUYG9" alt=""><figcaption></figcaption></figure>

2. Select 'Edit templates'.

<figure><img src="/files/La8ZLov6ON08VBXWZONB" 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="/files/xXXHr0MLMek4MqAXCtF5" alt=""><figcaption></figcaption></figure>

**Notes:**

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

<figure><img src="/files/d4UkzHzLLSqn70iiW2Ow" 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="/files/j39FAMwQxVRkwZcJaLo2" 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="/files/L6cQKb6bTrS1SvbEjmpf" 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`
