# UI Settings

The UI Settings page allows administrators to customise the appearance and behaviour of the Portal. It is accessible under **Administration → Settings**.

## General Settings

| Setting | Description |
|---------|-------------|
| **Email** | Contact email address displayed to users. |
| **Email Alias** | Alternative display text for the contact email. |
| **Phone** | Contact phone number displayed to users. |
| **Help URL** | URL to a help page or documentation site. Shown as a link in the Portal. |
| **Title** | Content title displayed on the Portal home page. Supports HTML formatting. This is different from the browser tab title, which is set via the environment variable `FrontendSettings__Title` (default: `UDiTH Portal`). |
| **Description** | Description displayed on the Portal home page. Supports HTML formatting. |

## Links

Custom links can be added to the Portal. Each link has a **Display Name** and a **URL**. Links are displayed in the Portal interface for quick access to external resources.

Use the **Add** button to create new links and the remove button to delete existing ones.

## Other Settings

| Setting | Description |
|---------|-------------|
| **Include models of subfolders** | When enabled, the model library shows models from subfolders in a collapsed view by default. |
| **Group PID search results by drawing name** | When enabled, PID search results are grouped by their drawing name. |

## Translations

Portal supports multiple languages. The translations section allows administrators to customise the text displayed in the Portal.

- **Download translations** — Downloads the current translation file as an `.xlsx` spreadsheet.
- **Overwrite translations** — Upload a modified `.xlsx` file to overwrite the Portal translations.

This allows you to adapt labels, messages, and other text to your organisation's terminology.

## Resources

The resources section allows you to customise the images used in the Portal. Navigate to **Administration → Settings → Resources** to manage the following:

| Resource | Description |
|----------|-------------|
| **Logo** | The logo displayed in the Portal navigation bar. |
| **Favicon** | The browser tab icon. |
| **Default Model Preview** | The default preview image shown for models that do not have a custom preview. |

Each resource can be replaced by uploading a new image, cleared to hide it, or reset to the built-in default.

## Themes

Portal includes multiple colour themes. If theme selection is enabled, users can switch between themes using the theme selector in the navigation bar. The user's preference is stored locally in the browser.

Available themes:

| Theme | Description |
|-------|-------------|
| **light** | Light colour scheme (default). |
| **dark** | Dark colour scheme. |
| **vienna** | Custom theme. |
| **scottsdale** | Custom theme. |

The default theme and available themes can be configured via the server-side frontend settings (`FrontendSettings__DefaultTheme`, `FrontendSettings__AvailableThemes`, `FrontendSettings__EnableThemeSelect`).