---
# System prepended metadata

title: Settings Interface

---

# Settings Interface
Users component designed to help administrators manage all web agent related features.

## Settings options
Users table consist of 6 columns:
* Organization details
* Change Logo
* Change Logo192
* Change Logo512
* Change Favicon
* Change web app Manifest
* Change SMTP configurations
* Theme Settings

## Organization details
Organization details form allows the admin to set or update organization name and site title.

### Organization name
Organization name is used to be displayed on the navigation menu and is also used in generating confirmation emails for account setup and password update.

#### Validation
N/A

### Site title
Site title is used to be displayed when hovering over the browser tab for the agent.

#### Validation
N/A

### Note
* No validation is done on this form
* Both organization name and site title must be submitted. 
* If one is missed, it would be set to an empty string.

## Change logo
Site logo is used to be displayed on every page of the agent and is also used might be used in generating emails by the agent.

### Validation
* Supported formats: .jpeg, .jpg, .png, .gif, .webp
* The file must be set.
* The file must be less than 500KB size.
* Size validation is happening on both back- and fron-end

### Note
* N/A

## Change logo192
Logo192 is a react logo which is of dimension 192*192 px and is used in the template file (index.html) by default. It's used for providing users with quicker access and a richer experience using mobile devices. logo192.png is part of PWA.

### Validation
* Supported formats: .png
* The file must be set.
* The file must be less than 100KB size.
* Size validation is happening on both back- and fron-end

### Note
* The file is being saved on the backend and hosted using nginx router.

## Change logo512
Logo512 is a react logo which is of dimension 512*512 px and is used in the template file (index.html) by default. It's used for providing users with quicker access and a richer experience using mobile devices. logo512.png is part of PWA.

### Validation
* Supported formats: .png
* The file must be set.
* The file must be less than 200KB size.
* Size validation is happening on both back- and fron-end

### Note
* The file is being saved on the backend and hosted using nginx router.

## Change favicon
Favicon is square icon that represents a website in web browsers.

### Validation
* Supported formats: .ico
* The file must be set.
* The file must be less than 200KB size.
* Size validation is happening on both back- and fron-end

### Note
* Even though it will take the icon up to 200KB size, it is the best practice to have fivicons to be as lighter in size as possible.
* The file is being saved on the backend and hosted using nginx router.

## Change web app Manifest
Web app manifest files provide the capability to change how an installed application will look like on the user's desktop or mobile device.

### Validation
* N/A

### Note
* No validation is done on this form
* All fields should be submitted. 
* Field placeholders represent expected format.
* If one field is not filled in it will be represented as an empty string in the manifest
* The file is being saved on the backend and hosted using nginx router.

## Change SMTP configurations
SMTP configurations are essential for the admin to to manage users. It is responsible for sending emails for account setup confirmation and password reset. It should be set on initial agent setup.

### Requirments
* SMTP Host
* SMTP Email
* SMTP Password

### Validation
* N/A

### Note
* No validation is done on this form
* All fields must be submitted for SMTP to work. 
* If a field is not filled in it will be represented as an empty string in the manifest and the SMTP will not work

## Theme Settings
Theme settings allows the admin to change one or multiple values used for styling web application components.

### Validation
* N/A

### Note
* There is a default set of values set for the theme in the settings database.
* Theme is set as a react context provider.
* Submitting a single value change updates a single value of theme set on the database.
* No validation is done on this form.
* Field placeholders represent expected format.
* The "change" buttong allows you to see the change live without updating the database. Simply change the value to the default state but cliking on "undo" button or refresh the page.
* You must submit the theme settings form to permanently update the theme.