# Folder

### Overview

Highlight's Network Explorer tree comprises folders and locations. Folders may contain subfolders and/or locations. Only those with the permission **Manage folders/locations** will be able to complete these steps.

### Create folder

On the Admin page, select the containing or parent folder and click "+".

From the "Create new\..." slide-in panel, choose "Create a new folder to organise your items and complete these fields:

<figure><picture><source srcset="/files/hda1KjLdYkfUOTuj0gBS" media="(prefers-color-scheme: dark)"><img src="/files/Az1MraBBIWpdgL5ldcZn" alt="Create folder"></picture><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="169"></th><th></th></tr></thead><tbody><tr><td>Folder name</td><td>Enter the folder name, which may contain spaces and does not need to be unique. This field is required. </td></tr><tr><td>Time zone</td><td>Select a time zone which will initially apply to new subfolders and locations created in this folder; if unchanged the time zone is inherited from the parent folder - see the <a href="/pages/2DLJc4EokCR1eVp5V7eR#time-zones">Time zone section</a> for more details.</td></tr><tr><td>Category</td><td>If shown, select Internal Group for a service provider folder, Customer otherwise.</td></tr><tr><td>Customer Reference</td><td>Customer Reference - An optional reference of up to 100 characters can be set on a Customer folder. This reference is then be applied to every watch in this folder and any subfolders (unless overridden) and can be shown in Reporting. Click <strong>Override</strong> to set. </td></tr><tr><td>Save</td><td>Stores all details.</td></tr></tbody></table>

### Edit folder - Main

<figure><picture><source srcset="/files/LwOA2sNoiNcVusAJC2k2" media="(prefers-color-scheme: dark)"><img src="/files/ygL1bPmeWbuGgusZqz8D" alt="Edit Folder Main"></picture><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="164"></th><th></th></tr></thead><tbody><tr><td>Folder name</td><td>Edit the folder name if needed</td></tr><tr><td>Time zone</td><td>Select a time zone which will initially apply to new subfolders and locations created in this folder; if unchanged the time zone is inherited from the parent folder - see the <a href="/pages/2DLJc4EokCR1eVp5V7eR#time-zones">Time zone section</a> for more details.</td></tr><tr><td>Contact name</td><td>(Optional) If available select a user from those created in this folder. The contact name is sent an email (from the <strong>noreply@highlight.net</strong> address) when a watch is activated via the Admin Pending page.</td></tr><tr><td>Category</td><td>If shown, select Internal Group for a service provider folder, Customer otherwise</td></tr><tr><td>Cust ref</td><td>Customer Reference - An optional reference of up to 100 characters can be set on a Customer folder. This reference is then applied to every watch in this folder and any subfolders (unless overridden) and can be shown in Reporting. Click <strong>Override</strong> to set. </td></tr><tr><td>Agent Selection</td><td>Refer to the <a href="/pages/YNHRSRTsSMaPy6SbD0aQ">Agent selection page</a> for details on assigning an agent or agent group as a Flow collector, for Web testing, or as a Poller.</td></tr><tr><td>Alerting Thresholds</td><td>Set thresholds for WiFi, Bearers, Classes and Broadband. See the <a href="/pages/paVXUDQON9y3oWG7lw2A">Alerting Thresholds page</a> for further details</td></tr></tbody></table>

### Edit folder - Business Hours

Highlight uses business hours when displaying traffic trend graphics, for filtering report results, and when generating alerts.

See the [Business Hours](/admin/admin-general-details/business-hours.md) page for further details on the settings involved.

### Edit folder - Features

<figure><picture><source srcset="/files/y7lRP4uK1h8RZPojZPcK" media="(prefers-color-scheme: dark)"><img src="/files/tEW4sKnNmq1KTfONf5jC" alt="Edit Folder Features"></picture><figcaption></figcaption></figure>

Use this section to enable or control features, such as SLA reporting and AppVis.

Settings on a parent folder are inherited in subfolders unless overridden.

{% hint style="info" %}
Users with the **Manage folders/locations** permission can see the Features tab but not enable or disable SLA Now unless they also have the **Edit watches** permission. Users without the **Edit watches** permission will see the message You don't have permission to change this
{% endhint %}

**Application Visibility:**  This section is only visible if AppVis is enabled for this folder. Setting this to Enabled means AppVis applications can be assigned to groups which will be visible in this folder and in any subfolders. The option disabled if an application domain is already set in a parent folder. If you have visibility then the path to that parent folder is shown

### Edit folder - CCD

<figure><picture><source srcset="/files/5ARrL387rkSh68lmBWne" media="(prefers-color-scheme: dark)"><img src="/files/NjDaI2LVlHVnuK5iiG7H" alt="Edit Folder CCD "></picture><figcaption></figcaption></figure>

If displayed, this tab provides the means to set the class names of interest for Highlight to autodiscover and report on.  Use Override to edit and add new. Find out more about [Override and Revert](/admin/admin-general-details.md#override-and-revert).

See the [Define Classes](https://help.highlight.net/admin/admin-page/pages/602c86f35a8f0d8d635f6d6199f2239cf31c6bef#id-3.-capturing-class-information) section on the Class Autodiscovery page for further information about class discovery.

See the [CCD page](/admin/admin-general-details/ccd.md) for full details on the settings involved.

### Edit folder - Domain

<figure><picture><source srcset="/files/muwkkHeptmaNkHLhyhfV" media="(prefers-color-scheme: dark)"><img src="/files/ta6TdyVLzyrNeax4GSgK" alt="Edit Folder Domain"></picture><figcaption></figcaption></figure>

If this folder is a domain, then you see the domain name, URL(s), and whether switching to other domains is allowed. [Contact us](/getting-started/contact-us.md) if you are interested in domains.

The dialog enables you to edit the specific company information which is accessed from

<table data-header-hidden><thead><tr><th width="200"></th><th></th></tr></thead><tbody><tr><td>Contact provider</td><td>on the home page</td></tr><tr><td>Domain contact details</td><td>from the user menu/side bar</td></tr><tr><td>Provider logo</td><td>on the Details page</td></tr></tbody></table>

The fields in this dialog are optional but, if empty, the panel will also be empty.

<table data-header-hidden><thead><tr><th width="200"></th><th></th></tr></thead><tbody><tr><td>About company</td><td>an optional free-text field - the contents appears in the main body of the About panel</td></tr><tr><td>Support phone</td><td>an optional number you'd like your users to contact for help</td></tr><tr><td>Support email</td><td>an optional email address</td></tr></tbody></table>

Refer to the [Override and Revert section](/admin/admin-general-details.md#override-and-revert) for details on this functionality.&#x20;

### Edit folder - Authentication

<figure><picture><source srcset="/files/WGXcONFSyNmEs8866jeg" media="(prefers-color-scheme: dark)"><img src="/files/3VWFNxJBaivIIRpeqrV2" alt="Edit Folder Authentication"></picture><figcaption></figcaption></figure>

Highlight supports authentication and single sign-on through a process called **Federated Authentication** where password authentication is handed off to a third-party OAuth directory (typically Microsoft Azure AD).

Highlight also provides [Multi-Factor Authentication for non-federated users](/getting-started/new-user/user-authentication.md#multi-factor-authentication).

{% hint style="info" %}
Users with both the **Manage folders/locations** and **Manage authentication** permissions can edit the Authentication section
{% endhint %}

Use this tab for administering federated authentication (SSO) on a folder. This applies to all users at this folder level and below.

<table><thead><tr><th width="139"></th><th></th></tr></thead><tbody><tr><td>Status</td><td>Enabled or Disabled, disabled keeps the information in Highlight but not applied</td></tr><tr><td>Provider</td><td>Currently the only option is OIDC</td></tr><tr><td>Name</td><td>Enter a unique name for the authentication provider. The name can be up to 50 characters including a-z, 0-9 and dash. The name will be stored in lower case. This field is required.</td></tr><tr><td>Authority URL</td><td>Enter a valid Https URL up to 1024 characters for an OIDC provider. If Highlight cannot acquire a discovery document for the URL entered, then the URL is not recognised as an OIDC provider. This field is required.</td></tr><tr><td>Client ID</td><td>Enter up to 50 characters for the Client ID. This field is required.</td></tr><tr><td>Client Secret</td><td>This can be up to 1024 characters and is obscured on input. This field is required. </td></tr><tr><td>Email domains</td><td>Enter a comma-separated list of domain names up to 2048 characters in total. This field is required.</td></tr><tr><td>New users</td><td><strong>Create Highlight account for unknown users</strong><br>Check to have Highlight automatically create these accounts if the user has not previously logged in but has passed the authentication checks by the third-party provider. This is useful as new staff joining an organisation will be able to log into Highlight with no other admin intervention.<br>Auto-created users have no expiry date and the standard permissions (which include viewing heat tiles and details page, creating alerts and running reports). Extra admin permissions can be granted by other admin users if required.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.highlight.net/admin/admin-page/folder.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
