# Perspectives

The **Perspectives Manager** view is designed to further extend and customize the Management Dashboard. The view is available only to tenant administrators. Within this view, administrators can manage the available perspectives in the Emporix system, including customizing views, restricting access for particular user groups, or registering custom perspectives.

<figure><img src="/files/OkpQbQsZqsREA5jvVywJ" alt="Perspective Manager view"><figcaption><p>Perspective Manager view</p></figcaption></figure>

The available tenant perspectives list appears in the perspective chooser for other Management Dashboard users with the appropriate access rights.

<figure><img src="/files/KrxiFWCL1etBEuKxBuuk" alt="Perspective chooser" width="230"><figcaption><p>Perspective chooser</p></figcaption></figure>

## Restricting perspective access

For the already available perspectives, administrators can grant access to specific user groups, depending on their roles and needs.

{% stepper %}
{% step %}
**Navigate to Perspectives Manager view**

Go to the **Administration** -> **Perspectives**.
{% endstep %}

{% step %}
**Select the perspective to edit**

From the list, choose the available perspective which you want to restrict visibility for using the **Edit** icon.
{% endstep %}

{% step %}
**Limit access to user groups**

In the **Allowed Groups** field, expand the list to select the employee user group or multiple groups that you want to grant access to the perspective.

{% hint style="info" %}
For more information how to create user groups and assign relevant permissions, see the [Users and Groups](/ce/management-dashboard/administration/usersandgroups.md).
{% endhint %}
{% endstep %}

{% step %}
**Save the perspective**

To persist the changes, choose **Save** on the perspective level.
{% endstep %}
{% endstepper %}

**Result:** The perspective is available only to the selected groups. Users can switch between the perspectives they are assigned to with the perspective chooser.

{% hint style="info" %}
If a user has access to only one perspective assigned, the perspective chooser is not displayed.
{% endhint %}

## Registering a custom perspective

Administrators can register a custom perspective, which in essence is a Management Dashboard extension. This way, you can organize the Management Dashboard to better respond to users' needs.

{% stepper %}
{% step %}
**Prepare a custom MD extension**

Build and deploy your Management Dashboard extension with the logic you want to include.

{% hint style="success" %}
To create an MD extension with all necessary dependencies, follow the instructions described in the [Enabling custom extensions](/ce/extensibility-and-integrations/extensibility-cases/custom-extensions.md).
{% endhint %}
{% endstep %}

{% step %}
**Add an extension as a perspective**

Go to the **Administration** -> **Perspectives** and choose **+** to add a new one. Provide the required details:

* **Name** - the displayed name of the perspective
* **URL Path** - the part of the URL that directs to the perspective, it must start with the slash `/`.
* **Module URL** - the URL where the module/extension is deployed, it must point to the module's `remoteEntry.js` file for module federation.
* **Module Name** - the federation scope name from the remote's module `vite.config.js` file.

<figure><img src="/files/Wr5h7pe4Acd4qu8znjy0" alt="Add a perspective" width="660"><figcaption><p>Add a perspective</p></figcaption></figure>

Select the **Active** toggle and confirm your changes with **Save** to close the form.
{% endstep %}

{% step %}
**Save the perspective configuration**

Choose **Save** at the Perspectives Manager level to persist all your changes and make the module available from the perspective chooser.
{% endstep %}
{% endstepper %}

## Additional options

When editing or adding perspectives, there are some additional options available.

* **Discard** - Use to dismiss any changes you've made when you are modifying or adding a perspective.

<figure><img src="/files/TRk1byRhBnWJG10HdjOt" alt="Discard option" width="230"><figcaption><p>Discard option</p></figcaption></figure>

* **Reset to default** - Use when you have already saved the modified or added perspectives to the Management Dashboard, but for any reason you'd like to return to the default setup and use the standard perspectives provided in the Management Dashboard. Note this is irreversible.

<figure><img src="/files/bAtQmd3QyWoaU8tcHNel" alt="Reset to default" width="230"><figcaption><p>Reset to default state</p></figcaption></figure>

* You can deactivate the navigation menu in the perspective view so that it doesn't disturb the view. Activate the **Hide Sidebar** toggle.

<figure><img src="/files/rKuiIHomR3H6zGnEQufZ" alt="Hide navigation sidebar" width="100"><figcaption><p>Hide navigation sidebar</p></figcaption></figure>


---

# 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://developer.emporix.io/ce/management-dashboard/administration/perspectives.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.
