# Creating and editing custom content

{% hint style="info" %}
Custom content can only be created and edited by Administrators.
{% endhint %}

Custom content allows Administrators to customise the style/appearance of Tablion using either HTML or CSS. **Custom content requires skills in HTML/CSS.**

### How to create and edit custom content

1. Select 'Admin tools' from your username dropdown.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2Feli5kutYy7T2zBzP8DYu%2Fimage.png?alt=media&#x26;token=fdf22491-4340-49ba-9b6a-cff04b1b2196" alt=""><figcaption></figcaption></figure>

2. Select 'Custom content'.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FmTPldsCE5VXwk55VWEfm%2Fimage.png?alt=media&#x26;token=89a67792-238d-4199-92a6-973193fc7d2b" alt=""><figcaption></figcaption></figure>

3. **If you wish to create new custom content**, select 'Create'. **If you wish to edit existing custom content**, select 'Edit' from the relevant custom content's row.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FuoM42sJjOmhxxXBX3GlC%2Fimage.png?alt=media&#x26;token=9946cd91-d404-4b3c-9f37-0b3111da4e93" alt=""><figcaption></figcaption></figure>

**Note:** Custom content **cannot be deleted** after creation, only edited (with the exception of the 'Name' field).

4. Populate the 'Name' field in accordance to the custom content you wish to use. The following is a list of all custom content inputs recognised by Tablion, along with images of what part of Tablion they will affect:

* 'custom\_links.html': Configures header links available to all users (custom links will appear in the highlighted space below)

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FC2kFHSM2tyjLtd92DMc7%2Fimage.png?alt=media&#x26;token=bccf4d70-c5a2-4a02-aeac-c4472186b9ab" alt=""><figcaption></figcaption></figure>

* 'email\_wrapper.html': Configures the header, footer and general template that Tablion emails will be 'wrapped' in when '{% db\_template 'email\_wrapper.html' %}' is used in the HTML of an [email notification template](https://tablion-help.aristotlemetadata.com/administrator-tools/creating-and-managing-custom-email-notification-templates). This is an alternative to using 'email\_header.html' and 'email\_footer.html' (see below) in tandem

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FaMGYXvPsWXnTsUCnShPT%2Fimage.png?alt=media&#x26;token=61be75e1-9014-42b3-bb42-5f37c8143613" alt=""><figcaption></figcaption></figure>

* 'custom.css': Configures site appearance using [Bootstrap 5](https://getbootstrap.com/docs/5.0/getting-started/introduction/) in order to align Tablion's styling to corporate and other style guidelines as required. **This input is the only input which should use the 'CSS' option from the 'Content type' dropdown.**

**Note: Do not use this input if you are unfamiliar with CSS**. If you are unfamiliar with CSS, consult a member of your organisation's IT staff who is familiar.

* 'crown.html': Configures the topmost section of Tablion's header (if left unconfigured, the crown will not appear)

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2Fh2iQimuGbINKn0MmEYuU%2Fimage.png?alt=media&#x26;token=aaccae2b-ec75-493a-ae99-06d863264a9c" alt=""><figcaption></figcaption></figure>

* 'neck.html': Configures the bottommost section of Tablion's header (if left unconfigured, the neck will not appear)

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FyZIpIxsvBziYwHxsKyEQ%2Fimage.png?alt=media&#x26;token=338a878c-0678-44b7-900d-53f82efaa791" alt=""><figcaption></figcaption></figure>

* 'ankle.html': Configures the topmost section of Tablion's footer (if left unconfigured, the ankle will not appear)

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FPVXWQwFtZPqq3ZdKHGb8%2Fimage.png?alt=media&#x26;token=2224ee4f-0360-4aaa-a70f-b7572e18342b" alt=""><figcaption></figcaption></figure>

* 'custom\_footer.html': Configures the middle section of Tablion's footer

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FrxEtePBTv3xgDDhVY6MN%2Fimage.png?alt=media&#x26;token=92a590ae-1e6c-40f6-8128-af30e4240361" alt=""><figcaption></figcaption></figure>

* 'sole.html': Configures the bottommost section of Tablion's footer (if left unconfigured, the sole will not appear)

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FmxdRSZInSHYyDIn8OLyi%2Fimage.png?alt=media&#x26;token=2d69b3cf-fcc5-44b3-9f5b-df0575a30201" alt=""><figcaption></figcaption></figure>

* 'user\_summaries\_pdf\_head.html': Configures the header of user summaries downloaded from the 'Members' tab of a data request

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FNsvRwTO4a9LvfhVoYR3m%2Fimage.png?alt=media&#x26;token=03a229f6-dd99-458e-8d95-e8aeb3addad8" alt=""><figcaption></figcaption></figure>

* 'email\_header.html': Configures the header of Tablion emails when '{% db\_template 'email\_header.html' %}' is used in the HTML of an [email notification template](https://tablion-help.aristotlemetadata.com/administrator-tools/creating-and-managing-custom-email-notification-templates)

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FvhCaDIjqzXuwBnpqHrpY%2Fimage.png?alt=media&#x26;token=7aebd1d5-15fd-4a17-b68c-9a544404be11" alt=""><figcaption></figcaption></figure>

* 'email\_footer.html': Configures the footer of Tablion emails when '{% db\_template 'email\_footer.html' %}' is used in the HTML of an [email notification template](https://tablion-help.aristotlemetadata.com/administrator-tools/creating-and-managing-custom-email-notification-templates)

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FP8b7HDLgEqYRzZsaRROO%2Fimage.png?alt=media&#x26;token=9da9160e-ca1c-4f1d-a45a-8c0a9b6bad8c" alt=""><figcaption></figcaption></figure>

* 'home.html': Configures the homepage accessed via the 'Home' link in Tablion's header

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FTSwHI1kF6g7ZKop9FaL8%2Fimage.png?alt=media&#x26;token=e5e863a0-148f-4be1-9572-0790d3d8d251" alt=""><figcaption></figcaption></figure>

* 'register-account-top.html': Configures the 'top' of the 'Register an account' page that appears when a user selects 'Register' from Tablion's header

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FaqgF7avS9Lfi8wucadO2%2Fimage.png?alt=media&#x26;token=b1a961b9-2ea5-4a02-9ef4-453711d3d75e" alt=""><figcaption></figcaption></figure>

* 'robots.txt': Configures a txt page accessible via [https://\[*your-data-portal*\]/robots.txt](https://datapassport.nsw.gov.au/robots.txt)

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FSEq8q1ohCzMGvEm4iGRK%2Fimage.png?alt=media&#x26;token=1800219b-fe1c-4626-97b4-bfa180dba1b0" alt=""><figcaption></figcaption></figure>

* 'mfa\_setup\_msg.html': Configures the message displayed when a user enables Multi-Factor Authentication (MFA)

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FFWzGc9e7LDsR6Hj8VWaG%2Fimage.png?alt=media&#x26;token=a06ccc4a-0c8d-4b39-ba90-740110a7c976" alt=""><figcaption></figcaption></figure>

* 'mfa\_disable\_msg.html': Configures the message displayed when a user disables MFA

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FoJqnNr70CkXj3ur1mgg4%2Fimage.png?alt=media&#x26;token=74248201-2196-49ae-89ef-cccc2e73a169" alt=""><figcaption></figcaption></figure>

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FfHvH8BI9Ac0hgFBR4voQ%2Fimage.png?alt=media&#x26;token=c8ad59e0-5365-4d06-90d7-553d378424fc" alt=""><figcaption></figcaption></figure>

**Note:** The 'Name' field **cannot be edited** after creation.

5. Select the desired content type using the 'Content type' dropdown.

**Note:** The 'custom.css' input is the only custom content input that uses the 'CSS' content type.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FANQa1bw2kjirqKJ2F79x%2Fimage.png?alt=media&#x26;token=fa5c80ce-63a1-4041-82a5-145383c0afac" alt=""><figcaption></figcaption></figure>

**Note:** For the custom content to work correctly, the content type must align to the file extension used in the 'Name' field.

6. Populate the 'Content' field with the custom content you wish to create.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FKP9aLv4jeDHRfdxMshR3%2Fimage.png?alt=media&#x26;token=2e0cba33-66d8-49d7-8450-86c01d2a52f9" alt=""><figcaption></figcaption></figure>

6. Select 'Save'. Your custom content will now appear on the 'Custom content' tab, and will be applied to your site.