---
title: "Navigation"
description: "The one sidebar behind Home, Projects and every project — pinned and recent projects, project rows that unfold into their five surfaces, and what is remembered where."
source: "https://testorchestrator.com/docs/getting-started/navigation"
---

# Navigation

One sidebar carries everything outside workspace settings. It is on screen on [Home](https://testorchestrator.com/docs/getting-started/workspace-home), on [Projects](https://testorchestrator.com/docs/projects/browsing-projects) and inside every project, and it is the _same_ sidebar throughout — the projects you pinned are still there when you step into one, and the project you are working in never leaves it.

> **There is no bar across the top.** Everything you navigate with is in this one sidebar, and each surface names itself in a breadcrumb above its own content.

## The sidebar, top to bottom

| Where | What it holds |
| --- | --- |
| **Top** | Your workspace, with a chevron. Click it to open the [workspace menu](https://testorchestrator.com/docs/getting-started/navigation#workspace-menu). A collapse control sits beside it. |
| **Under it** | **Home** and **Projects** — the two workspace-wide destinations. |
| **The middle** | [Your projects](https://testorchestrator.com/docs/getting-started/navigation#your-projects). Each one is a row that unfolds into the five places you work inside it. |
| **Foot** | Your avatar and name. Click to open the [account menu](https://testorchestrator.com/docs/getting-started/navigation#account-menu). |

### The workspace menu

Clicking the workspace name opens a menu headed by the workspace and its plan, then up to four destinations. Each one appears only if your role can actually reach it, so the menu never offers a page that would turn you away:

| Destination | Opens |
| --- | --- |
| **Invite people** | [Invitations](https://testorchestrator.com/docs/getting-started/accept-invitation#for-admins-sending-invitations) — needs the _Invite users_ permission. |
| **Plan & usage** | [Your subscription and its limits](https://testorchestrator.com/docs/plans-and-billing). Tenant Admins and Project Admins — read-only for anyone who isn’t a billing admin. |
| **Workspace settings** | [Settings](https://testorchestrator.com/docs/getting-started/navigation#settings), landing on **Users & access**. |
| **Help & docs** | This documentation site, in a new tab. Always available. |

## Home and Projects

**Home** is your workspace landing page — setup progress, a row of workspace facts, and the projects you opened most recently. See [Workspace Home](https://testorchestrator.com/docs/getting-started/workspace-home).

**Projects** opens the full list of everything you can get into. It carries a **count** only when the sidebar is not already showing you every project you have — a number that matched the rows above it would say nothing. On a workspace of six projects showing three in the sidebar it reads **6**; on a workspace of five showing all five it carries no count at all. See [Projects](https://testorchestrator.com/docs/projects/browsing-projects).

## Your projects

How the sidebar lists your projects depends on how many you have. The switch is at **six**.

| Workspace | What the sidebar shows |
| --- | --- |
| **Five projects or fewer** | One group, **Your projects**, listing every one of them — pinned first. Two headings to organise four rows would be ceremony. |
| **Six or more** | Two groups: **Pinned**, up to eight, and **Recent**, up to five below it. The rest live on the Projects page, and the **Projects** row above carries the workspace total. |
| **No projects** | No group at all — just Home and Projects. |

Those caps are the point: a hundred-project workspace and a ten-project workspace produce a sidebar of the same height. It does not grow with the workspace.

Each group heading is a control. Click **Pinned** or **Recent** to fold that group away and click it again to bring it back; the answer is kept on your account, so a group you folded is still folded on your next machine.

### Pinned

A pin is a position you chose, and it holds. Pin a project from its [row menu in the sidebar](https://testorchestrator.com/docs/getting-started/navigation#row-menu), or from its row menu on the [Projects](https://testorchestrator.com/docs/projects/browsing-projects#row-menu) page — **Pin to sidebar** — and it appears in the sidebar straight away, in the order you pinned them. **Unpin from sidebar** in either menu takes it back out.

Pinning is a personal act, not an administrative one: everyone in the workspace can pin, including people who cannot edit a project at all.

In a workspace small enough for one **Your projects** group, a pinned row carries a small star beside its name, announced as _Pinned to the sidebar_ — and it appears the moment you pin, as the row moves up to sit with the other pinned ones. Once the list splits into **Pinned** and **Recent** the star goes away again: the heading above the row already says it.

### Recent

**Recent** is earned by work, not by clicking. It lists the projects you have actually done something in, most recent first, and a pinned project is never repeated in it. Merely opening a project does not put it here.

These are the acts that earn a project its place, each counted for you alone:

- creating or editing a [test case](https://testorchestrator.com/docs/test-cases);
- creating a [test run](https://testorchestrator.com/docs/test-runs);
- recording a result;
- adding a note, finding or result to an [exploration](https://testorchestrator.com/docs/explorations);
- uploading an attachment.

Because the list is kept on your account rather than in the browser, it is the same list wherever you sign in — and it is yours: two people working in the same workspace see different Recent groups.

> **Before you have worked anywhere: Newest.** A brand-new account has no activity to order, and rather than show you five projects that have not earned the word, the group renames itself **Newest** and lists the most recently created active projects instead. The heading changes to **Recent** the first time you do work in a project, and that project leads it.

> **Completed projects are not hidden here.** Completing a project takes it out of the project switcher and out of new runs, but Pinned and Recent are not a roster of where you may work — one is what you chose, the other is where you worked. A completed project stays in either group, drawn greyed and italic, and its name is announced with _(completed)_. The **Newest** fallback is the exception: it leaves completed projects out, because created-order is not earned.

## A project row unfolds

A project in the sidebar is not a link. Clicking its name unfolds it — the caret sits against the name, and turns as the row opens — revealing the five places you work inside that project:

- **Dashboard** — the project’s own summary of cycles, runs and explorations
- [Cycles](https://testorchestrator.com/docs/cycles)
- [Test Cases](https://testorchestrator.com/docs/test-cases)
- [Test Runs](https://testorchestrator.com/docs/test-runs)
- [Explorations](https://testorchestrator.com/docs/explorations)

Those five are the destinations, so the row itself does not navigate — going through a project dashboard you did not ask for costs a page load and a trip back. Unfold as many rows as you like; each one remembers whether you left it open.

The five entries are filtered by your permissions for the project you are **inside**. On any other row all five are listed, because permissions are read for one project at a time; the surfaces themselves still refuse anyone who should not be there.

### The row menu

Each project row carries the same short menu its row on the [Projects](https://testorchestrator.com/docs/projects/browsing-projects#row-menu) page does. It appears at the end of the row when you hover it or reach it with the keyboard, so twenty rows are not twenty permanent controls, and it is announced as _Actions for \<name>_:

| Entry | When it appears |
| --- | --- |
| **Pin to sidebar** / **Unpin from sidebar** | Always, for everyone — what the sidebar lists is changed from the sidebar itself. |
| **Edit project** | If you can edit projects. Opens the [project editor](https://testorchestrator.com/docs/projects/create-project). |
| **Mark completed** / **Mark active** | If you can edit projects. The same action, and the same **Undo**, as the Projects page — see [Marking a project completed](https://testorchestrator.com/docs/projects/browsing-projects#completing). |

Someone who cannot edit projects gets a menu of exactly one entry, **Pin to sidebar**. Every entry takes effect as you watch: pin, and the row moves to its pinned position immediately; mark a project completed, and it is greyed here and out of the Active views without a reload, with **Undo** beside the confirmation.

The menu is not drawn in the [collapsed sidebar](https://testorchestrator.com/docs/getting-started/navigation#collapsing) — there is no room beside a centred chip, and the row there is already nothing but the chip.

### Inside a project

The project you are viewing is always on the sidebar, and it is marked where it already sits rather than lifted out into a group of its own:

- If it is **pinned**, it stays exactly where you pinned it.
- If it is in **Recent**, it stays where its activity puts it.
- If it is in neither — a project you reached from the Projects page, say — it is added **below** the earned groups, so the row you just arrived at cannot disappear behind you.

Those added rows stay for as long as the tab is open, in the order you opened them, and going back to Home or Projects does not clear them — a row you were just using is still there when you turn round. Each one takes its place in Recent proper the first time you do work in that project.

They are a courtesy for the session, not a record: they are not saved to your account, and a new tab starts without them unless you worked there. Nothing is ever pushed above Pinned, and no unlabelled row appears at the top of the sidebar.

The current project’s row is unfolded when you arrive, and the surface you are on is highlighted inside it. Leaving for another project does not fold it again — the rows you have opened stay as you left them, so the sidebar does not rearrange itself underneath the pointer. Folding one away yourself is allowed, and that answer is remembered.

## Nothing goes blank while a page loads

The sidebar stays exactly where it is on every navigation — on screen, in the same scroll position, still clickable. So does the page you are leaving: it holds until the next one is ready to take its place, instead of being cleared to an empty panel first. There is no blank flash, and no skeleton that only appears to tell you a fast page was fast.

What acknowledges the click is the sidebar itself: the row you clicked shows a small dot while its page is on the way, and the dot goes out when the page arrives.

So you can keep going: click a project row, and while its dashboard is still arriving, unfold another project and pick the surface you actually wanted. Going back to a project you were in a moment ago does not fetch it again: what the app already has is reused, so the return is not a second wait.

## Collapsing and resizing

The control beside the workspace name collapses the sidebar to a narrow strip of icons. Collapsed:

- the workspace mark becomes a link to **Home**;
- the project you are in keeps its five surfaces, stacked as icons under its chip, so every destination is still one click away;
- every other project becomes one click straight to its dashboard — _Open \<name>_.

Drag the sidebar’s right edge to resize it instead. On a narrow screen it becomes a drawer, opened from the control beside the page heading.

## What is remembered, and where

Three different kinds of memory, and the difference matters if you use TestOrchestrator on more than one machine:

| Setting | Remembered |
| --- | --- |
| Pinned projects; where you last did work, which is what orders [Recent](https://testorchestrator.com/docs/getting-started/navigation#recent); which groups and project rows are unfolded; dismissing the setup checklist; the [Projects](https://testorchestrator.com/docs/projects/browsing-projects#display) layout and display choices | **On your account.** They follow you to any browser and any device, and they survive signing out and back in. |
| Whether the sidebar is collapsed, and how wide you dragged it | **In this browser only.** A different browser or a cleared browser starts with the sidebar expanded at its default width. |
| The [projects you opened](https://testorchestrator.com/docs/getting-started/navigation#inside-a-project) that Pinned and Recent do not already list | **In this tab only.** They stay listed until you close it, and a new tab starts without them. |

Everything in the first row is yours alone. Pinning a project changes nobody else’s sidebar.

### The account menu

Clicking your avatar at the foot of the sidebar opens **Settings**, **Notifications**, a **Theme** switch reading _Light_ or _Dark_, and **Log out**.

The avatar is also where background saves report in. Most edits across the product apply the moment you make them and persist behind you, with no Save button; a small dot appears on the avatar while a save is in flight, and changes colour if one fails. See [Background saves](https://testorchestrator.com/docs/test-runs/recording-results#background-saves).

## Settings has its own sidebar

Everything configurable — your own profile and the whole of workspace administration — lives behind **Settings**. Open it from the account menu (which lands on your profile) or from **Workspace settings** in the workspace menu.

Settings replaces the sidebar rather than adding to it. In place of your projects you get a **Search settings…** box, your **Personal** sections first — [Profile](https://testorchestrator.com/docs/personal-settings/profile), [Preferences](https://testorchestrator.com/docs/personal-settings/preferences), [Notifications](https://testorchestrator.com/docs/personal-settings/notifications), API keys, [Connected apps](https://testorchestrator.com/docs/mcp#connected-apps) — and then the workspace groups you are allowed to administer:

| Group | Sections |
| --- | --- |
| **Users & Access** | [Users](https://testorchestrator.com/docs/users-and-access/all-users), [Access groups](https://testorchestrator.com/docs/users-and-access/access-groups), [Roles & permissions](https://testorchestrator.com/docs/users-and-access/roles), Invitations, [Authentication](https://testorchestrator.com/docs/authentication), [Connected apps](https://testorchestrator.com/docs/mcp#connected-apps) (Tenant Admins) |
| **Test Design** | [Projects](https://testorchestrator.com/docs/projects/all-projects), [Fields](https://testorchestrator.com/docs/fields), [Templates](https://testorchestrator.com/docs/templates) |
| **Execution** | [Statuses](https://testorchestrator.com/docs/statuses), [Workflows](https://testorchestrator.com/docs/workflows), [Cycles](https://testorchestrator.com/docs/cycles/cycle-types) |
| **Workspace** | [Environments](https://testorchestrator.com/docs/environments), [Tags](https://testorchestrator.com/docs/tags), [Integrations](https://testorchestrator.com/docs/integrations) |
| **Administration** | [AI Settings](https://testorchestrator.com/docs/ai-test-generation), [Subscription](https://testorchestrator.com/docs/plans-and-billing), [Workspace Requests](https://testorchestrator.com/docs/users-and-access/access-levels#workspace-requests) |

**‹ Back to app** at the top returns you to the surface you came from, with your projects back in the sidebar.

> **An empty group is not shown at all.** The list is built from the permissions you actually hold, so a group whose every section is out of reach disappears, heading included, rather than sitting there greyed out. A section you cannot see is a section you could not have opened; hiding it grants and denies nothing. Throughout these guides a path written as **Settings → Fields** means that section of this list.
