> For the complete documentation index, see [llms.txt](https://developer.emporix.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.emporix.io/ce/management-dashboard/administration/perspectives.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://developer.emporix.io/ce/management-dashboard/administration/perspectives.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
