> For the complete documentation index, see [llms.txt](https://docs.ins-pi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ins-pi.com/command/the-portal/portal.md).

# The Portal

Reference for the Command portal screen, covering Home, the top bar, the activity rail, tabs, the content header, the panels, the Command Dialog and Settings.

The portal is where people work in YouDesign Command. It runs inside your ServiceNow instance over the same records your administrators configure in the platform, and it sits next to the classic ServiceNow forms, lists and dashboards rather than replacing them. This page is the reference for the parts of the screen; the other pages in this section cover content types, personas, My Space, the Data Hub, and tasks.

## What it is

Everything is arranged around a central work area:

| Area                              | Where             | What it does                                                         |
| --------------------------------- | ----------------- | -------------------------------------------------------------------- |
| [Top bar](#top-bar)               | Top of the screen | Settings, Home, your tabs, notifications and your profile.           |
| [Activity rail](#activity-rail)   | Left edge         | **Create**, your views (such as **My Space**), and the **Data Hub**. |
| [Work area and tabs](#tabs)       | Center            | Each open item fills the work area in its own tab.                   |
| [Command Dialog](#command-dialog) | Right edge        | The AI assistant.                                                    |

<figure><img src="https://414746897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx4mE784snR9Eb8oVrk4e%2Fuploads%2Fgit-blob-19716c3a30894494bc6e7072ae3a3745c7b81549%2Fcommand-portal-layout.png?alt=media" alt="The Command portal with My Space open on the left, a Roadmap in the work area and the Command Dialog open on the right."><figcaption><p>My Space, work area and Command Dialog</p></figcaption></figure>

## When to use it

Use the portal for portfolio and transformation work: building views, analyzing records, sharing results. Use the classic ServiceNow interface for platform administration. Both read and write the same data.

## Home

You land on **Home** when Command opens, greeted with *Welcome back,* . Click the **Command** logo in the top bar to come back to it.

Home is your own page: out of the box it shows **My tasks**, **I own**, **Command Transformation** (a box to ask the assistant), **Continue my work** and **Workspace updates**, and you can rearrange it, add to it, or make any dashboard your Home. See [Home and landing pages](https://docs.ins-pi.com/command/the-portal/home.md).

## Top bar

From left to right:

1. **Open menu** (three lines) opens the [Settings](#settings) drawer.
2. **Command** (the logo) returns you to Home. On narrower screens only the logo shows.
3. **The tab strip** holds one tab per open item. See [Tabs](#tabs).
4. **All tabs** opens tab search. Press **⌥K** (**Alt+K** on Windows) to open it from anywhere.
5. **Notifications** (the bell) shows unread messages. See [Tasks, notifications and approvals](https://docs.ins-pi.com/command/the-portal/tasks-and-notifications.md).
6. **Your avatar** opens your profile: **Working as**, where you pick your [persona](https://docs.ins-pi.com/command/the-portal/personas.md), your email and your **Command Roles**.

On a phone, the top bar also has a **Command Dialog** button.

## Activity rail

A narrow column of icons on the left.

| Entry                                                    | What it opens                                                                                                                                                                                                                                                                              |
| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Create** (the **+** at the top, or **⌥N** / **Alt+N**) | The create menu for your persona, with a search box: type and press **Enter** to create the best match. Its last group, **Organize**, creates a **Folder**. Shown only to people who can create content. See [Content types](https://docs.ins-pi.com/command/the-portal/content-types.md). |
| **My Space**                                             | Your saved content, in a side panel. See [My Space and sharing](https://docs.ins-pi.com/command/the-portal/my-space.md).                                                                                                                                                                   |
| **My Tasks**                                             | Tasks assigned to you, in a side panel. See [Tasks, notifications and approvals](https://docs.ins-pi.com/command/the-portal/tasks-and-notifications.md).                                                                                                                                   |
| **Portfolio**                                            | A shared, read-only tree of key content that an administrator curates, in a side panel. Search it with **Search Portfolio**.                                                                                                                                                               |
| **Governance**                                           | The architecture governance cockpit. See [Architecture Governance](https://docs.ins-pi.com/command/features/architecture-governance.md).                                                                                                                                                   |
| **Assessments**                                          | Questionnaires and surveys. See [Assessments](https://docs.ins-pi.com/command/features/assessments.md).                                                                                                                                                                                    |
| **Glossary**                                             | Shared business terms with definitions. Search or jump by letter.                                                                                                                                                                                                                          |
| **Ideation Portal**                                      | Capture and follow ideas. See [Ideation Portal](https://docs.ins-pi.com/command/features/ideation-portal.md).                                                                                                                                                                              |
| **Framework Intelligence Center**                        | Frameworks and their conformance. See [Framework Intelligence Center](https://docs.ins-pi.com/command/features/framework-intelligence-center.md).                                                                                                                                          |
| **AI Portfolio Management**                              | The register of AI assets. See [AI Portfolio Management](https://docs.ins-pi.com/command/features/ai-portfolio-management.md).                                                                                                                                                             |
| **Data Hub** (at the bottom, or **⌥D** / **Alt+D**)      | The panel for finding records and dragging them into content. It appears when the item in front of you can take records. See [Data Hub](https://docs.ins-pi.com/command/the-portal/data-hub.md).                                                                                           |

<figure><img src="https://414746897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx4mE784snR9Eb8oVrk4e%2Fuploads%2Fgit-blob-8fa0ceb84f8895c698ed1e971e92ca063accd1ca%2Fportal-workspace-views.png?alt=media" alt="The activity rail, showing the create button above the workspace view icons" width="52"><figcaption><p>The activity rail</p></figcaption></figure>

A persona can carry all of these views, a subset, or none. Glossary, Governance and the other full-page views open as tabs; My Space, My Tasks and Portfolio open as side panels.

On a narrow phone screen the rail is hidden: tap **Show workspace views** at the bottom left to slide it in.

## Tabs

Every item you open gets a tab, like a browser.

* **The active tab always shows its title.** Other tabs show theirs when there is room, and shrink to their icons when space runs out.
* **All tabs** at the end of the strip, or **⌥K** (**Alt+K**), opens tab search. Type to find a tab. It lists:

  * **Open**: every open tab, with **Home** always first;
  * **Not used in 7 days**: tabs you have not looked at for a week;
  * **Recently closed**: click one to reopen it.

  Each group opens and closes from its heading. While **Open** or **Not used in 7 days** is open, its heading carries **Close all tabs**, which closes that group's tabs and keeps any with unsaved changes. Use **↑** **↓** to move, **Enter** to open, and **Delete** to close the highlighted tab.
* Close a tab with its **×**, or press **⌥W** (**Alt+W**) to close the active tab. **Home** cannot be closed. A message offers **Undo**. Closing a tab never deletes the content.
* Tabs with unsaved changes are never closed for you.
* On a phone, the tab strip is replaced by one button showing the current tab's title with a **▾**. Tap it to open tab search, which lists every tab.

<figure><img src="https://414746897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx4mE784snR9Eb8oVrk4e%2Fuploads%2Fgit-blob-432c7941b9bfaa0f565563cfcfd62eb7eab5b606%2Fcommand-tab-search.png?alt=media" alt="Several items open as tabs in the top bar, with tab search open and listing every open tab."><figcaption><p>Tab search lists every open tab</p></figcaption></figure>

## Content header

Each open item has a header with:

| Control              | What it does                                                                                                                                                                                                             |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Icon, title and type | Click the title to rename the item.                                                                                                                                                                                      |
| **Edit**             | Switches types you edit in place into edit mode. It reads **Editing** while on. Grayed out when you only have viewer access.                                                                                             |
| **Share**            | Opens the Share dialog. Its arrow offers **Share page…**, **Copy page link** and downloads. See [My Space and sharing](https://docs.ins-pi.com/command/the-portal/my-space.md#share-content).                            |
| **⋮**                | **Add description**, the **Panels** switches, **Save in My Space** and **Clear**. On most types, **Clear** asks you to confirm before it removes every record from the item. A dashboard also has **Make landing page**. |
| **Extended view**    | Hides everything except the content. Press **Esc** to leave.                                                                                                                                                             |

### Panels

Most visual content types can show three optional panels, switched on and off from **⋮ > Panels**:

| Panel        | What it shows                                                                                                                                                                                                                     |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **View**     | The toolbar row with the type's own controls, such as filters, layout and axes. On by default.                                                                                                                                    |
| **Metric**   | Cards that total a measure across the item's records. Click **Add or manage measures** to pick measures, or **Automatically add** to show every measure with data. Clicking a card filters to the records that have that measure. |
| **Timeline** | A **Time** scrubber with play controls and **Today**. Drag it to see measures as they were in a past period or as planned for a future one.                                                                                       |

Each content type's defaults are listed in [Content types](https://docs.ins-pi.com/command/the-portal/content-types.md).

## Command Dialog

The **Command Dialog** is the AI assistant, headed **ins-pi Transformation OS™**.

1. Click **Command Dialog** on the right edge of the screen. On a phone, open it from the button in the top bar.
2. The assistant greets you by name, for example "Good evening, Alex. What would you like to work on?"
3. Type a request in plain words and press **Enter**.

The chip above the message box shows the content the assistant is working with. It follows the tab you are on, and is empty on Home and on full-page views such as Governance. Click its **×** to detach it for the current tab.

What you can ask, and how to read an answer, is in [Command Dialog](https://docs.ins-pi.com/command/features/command-dialog.md).

{% hint style="info" %}
Your administrator can switch the assistant off for the whole instance. The **Command Dialog** button is then not shown, and everything else keeps working.
{% endhint %}

## Settings

Click **Open menu** at the far left of the top bar.

| Setting           | Options                                                                                                                                                                                                                                                        |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Theme mode**    | **Light**, **Dark** or **System**. **System** follows your device's light or dark setting.                                                                                                                                                                     |
| **Language**      | English (US), English (UK), Deutsch, Türkçe, Español, Português, Français, 日本語, हिन्दी, বাংলা. Almost every screen is translated, and dates follow the language you choose. The assistant's answers, emails and some messages from ServiceNow stay in English. |
| **Accessibility** | **Reduce motion** and **High contrast**.                                                                                                                                                                                                                       |

Your settings, open tabs and layout are saved with your user, so they follow you to another browser. The drawer footer shows the version of Command you are running.

Administrators also see [Global Settings](https://docs.ins-pi.com/command/administration/global-settings.md) and, while legacy data remains to be moved, **Migration**. A Command Editor whose persona grants some Global Settings sections sees just those sections (see [Personas](https://docs.ins-pi.com/command/the-portal/personas.md#admin-settings)).

<figure><img src="https://414746897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx4mE784snR9Eb8oVrk4e%2Fuploads%2Fgit-blob-875c208699cd00de4e214d29a8c3b4f575286e2c%2Fcommand-settings-drawer.png?alt=media" alt="The Settings drawer with Theme mode set to Light, Dark or System, Global Settings, Migration, Language and Accessibility."><figcaption><p>The Settings drawer</p></figcaption></figure>

## Good to know

* **Sessions.** When your ServiceNow session is about to time out, a bar offers **Stay signed in**. If it has ended, Command shows **Sign in again** and keeps what is on screen.
* **Permissions.** The portal reads through your ServiceNow roles and access rules. A persona changes what is offered, never what is allowed. See [Access Rights](https://docs.ins-pi.com/command/prior-v26.0/configuration/access-rights.md).
* **Phones and tablets.** See [Mobile and accessibility](https://docs.ins-pi.com/command/features/mobile-and-accessibility.md).

## Related

* [Content types](https://docs.ins-pi.com/command/the-portal/content-types.md)
* [Personas](https://docs.ins-pi.com/command/the-portal/personas.md)
* [My Space and sharing](https://docs.ins-pi.com/command/the-portal/my-space.md)
* [Data Hub](https://docs.ins-pi.com/command/the-portal/data-hub.md)
* [Tasks, notifications and approvals](https://docs.ins-pi.com/command/the-portal/tasks-and-notifications.md)
* [Metamodel](https://docs.ins-pi.com/command/reference/metamodel.md)


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.ins-pi.com/command/the-portal/portal.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
