> ## Documentation Index
> Fetch the complete documentation index at: https://help.broadstripes.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Switch between projects

> Use the project switcher to move between Broadstripes projects, sort your project list, and open projects in new tabs.

The **project switcher** lets you move between any Broadstripes projects you have access to without leaving the app. It opens as a searchable dialog directly from the top navigation bar.

<Note>
  If you belong to only one project, the project name appears as a plain label in the top navigation bar -- there is no interactive button, and the project switcher does not open.
</Note>

## Open the project switcher

Click your current project name in the top navigation bar to open the project switcher. The button shows the name of the project you are currently working in (or "Projects" when you are in the admin portal) and a <Icon icon="angle-down" iconType="light" color="#545454" /> indicator.

You can also open and close the project switcher with a keyboard shortcut: **Cmd-.** on a Mac, or **Ctrl-.** on Windows and Linux.

<img src="https://mintcdn.com/broadstripes/Xqlyh-jNN1nWZwwH/images/getting-started/project-switcher.png?fit=max&auto=format&n=Xqlyh-jNN1nWZwwH&q=85&s=30cc44a443bdf1b87f44fe58aed096f5" alt="Project switcher dialog open showing a searchable list of projects" width="592" height="378" data-path="images/getting-started/project-switcher.png" />

## Find and switch to a project

When the project switcher opens, your projects appear in a list. Each project displays a colored badge with the project's initials on the left. Your current project always appears at the top of the list, is highlighted with a subtle background, and is marked with a check mark (<Icon icon="check" iconType="regular" color="#545454" />) on the right.

Type any part of a project name to filter the list. The list narrows as you type, scoring results by how well they match what you typed. Press **Enter** or click a project name to switch to it.

If you have more than 100 projects, the switcher shows the first 100 and displays a hint at the bottom: "Showing first 100 of N -- keep typing to narrow." Continue typing to see more specific results.

## Sort your project list

The project switcher has a **Sort alphabetically** toggle at the bottom of the dialog. When the toggle is on, projects are listed in alphabetical order. When it is off, projects are sorted by recency -- the projects you have visited most recently appear first.

Your sort preference is saved to your account, so it persists the next time you open the project switcher or log in.

<Note>
  You can also change this setting from your user account page under **User settings > Project sort order**.
</Note>

## Open a project in a new tab

Turn on the **Open in new tabs** toggle at the bottom of the project switcher to open each project you select in a new browser tab instead of navigating the current tab. Your current tab stays open on the project you are already working in.

This preference is saved to your account and remembered between sessions.

## Project group badges

If you are a super-admin or a member whose projects span multiple project groups, each project in the switcher is tagged with a color-coded badge showing its group name. The same group always appears in the same color, making it easy to tell at a glance which organization a project belongs to.

Projects that have not been assigned to any group display a gray **No group** badge instead.

If all of your projects belong to a single group, no badges are shown.

## Keyboard shortcuts

| Action                             | Mac                    | Windows / Linux        |
| ---------------------------------- | ---------------------- | ---------------------- |
| Open or close the project switcher | Cmd-.                  | Ctrl-.                 |
| Filter the project list            | Type in the search box | Type in the search box |
| Switch to a project                | Enter or click         | Enter or click         |
| Close without switching            | Escape                 | Escape                 |