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

# Switch between workspaces or create a new one

> Use the header switcher to move between workspaces without losing the page you are on, and add a new one from the same place.

export const Screenshot = ({id, alt, caption, frame = 'browser', url, marks = [], lang = 'en', workspace = 'northwind-outbound'}) => {
  const src = `/images/screenshots/${lang}/${id}.png`;
  const chrome = url ? `app.pipelime.ai/${workspace}${url}` : 'app.pipelime.ai';
  return <figure className={`pl-shot pl-shot--${frame} not-prose`}>
      <div className="pl-shot__frame">
        {frame !== 'bare' && <div className="pl-shot__bar">
            <span className="pl-shot__dots">
              <span className="pl-shot__dot" />
              <span className="pl-shot__dot" />
              <span className="pl-shot__dot" />
            </span>
            <span className="pl-shot__url">{chrome}</span>
          </div>}
        <div className="pl-shot__media">
          <img src={src} alt={alt} loading="lazy" />
          {marks.map(mark => <span key={mark.n} className="pl-shot__mark" style={{
    left: `${mark.x}%`,
    top: `${mark.y}%`
  }} aria-hidden="true">
              {mark.n}
            </span>)}
        </div>
      </div>
      {caption && <figcaption className="pl-shot__caption">{caption}</figcaption>}
    </figure>;
};

When you finish you can jump into any workspace you belong to without losing the page you are on, and start a new one whenever you need it.

<div className="pl-availability">
  <div className="pl-availability__row">
    <div className="pl-availability__label">Where</div>
    <div className="pl-availability__value"><span className="pl-path">Workspace switcher<span className="pl-path__sep">→</span>Workspaces</span></div>
  </div>

  <div className="pl-availability__note">Always reachable, including while a plan is expired.</div>
</div>

## Before you begin

* You need to belong to more than one workspace for there to be anything to switch to: one you own or one you were invited to both count.
* You do not need a particular role to create a workspace, and you do not have to be inside one to start.

## Steps

<Steps>
  <Step title="Switch to another workspace">
    In the header, your current workspace sits in a block with three parts: its name, a gear, and an arrow. Choose the arrow (1). A list opens with a search box, then the workspaces you own and any you have been invited to.

    Choose the one you want (2). Switching only rewrites the workspace part of the address, so you land on the same page inside the new workspace: the Prospects list stays the Prospects list.

    <Screenshot id="workspaces-account/switch-and-create-workspaces--switcher" url="/leads/prospects" alt="The workspace switcher open above the Prospects list, showing a search box and two workspaces, Northwind Outbound and Acme Outbound" caption="Picking a workspace here keeps you on the page you were already looking at." marks={[{ n: 1, x: 18, y: 5 }, { n: 2, x: 18, y: 18 }]} />

    <Note>
      Two workspaces you belong to can carry the same name, and the list shows
      both of them under that one name. The address is what tells them apart:
      when a name is shared, every workspace sharing it gets its own id added to
      the end of its part of the address, so the address always says which one
      you are in.
    </Note>
  </Step>

  <Step title="Or see every workspace at once">
    Choose the name itself, at the left of that same block. The other two parts go elsewhere: the gear in the middle opens this workspace's settings, and the arrow opens the switcher you just used. **Workspaces** at the top of the sidebar does the same as the name, and it is there for as long as you are inside a workspace.

    Either one opens the full list, with a card for each workspace and an **Enter** button on it. **Enter** always opens that workspace's dashboard, unlike the quick switch above, which keeps whatever page you were on.
  </Step>

  <Step title="Start a new workspace">
    On that same list, choose **Create Workspace** (1) on the "Create a new workspace" banner at the top. The **Add Company** entry at the bottom of the switcher list opens the same thing.

    <Screenshot id="workspaces-account/switch-and-create-workspaces--new-workspace-card" url="workspaces?select=1" workspace="" alt="The Create a new workspace banner at the top of the Workspaces page, with a Create Workspace button, above a list of existing workspace cards" caption="This opens the same setup wizard every new account goes through." marks={[{ n: 1, x: 9, y: 30 }]} />
  </Step>
</Steps>

## What happens next

<Check>
  The header shows the new workspace's name, and the address in your browser
  carries the new workspace in place of the old one with the rest of the path
  unchanged.
</Check>

An address with no workspace in it (a bookmark like `/senders`, or `/workspaces` typed by hand) does not reliably reopen the workspace you were last in. Use the switcher when it matters which workspace you land in.

Creating a workspace takes you into the same setup wizard a brand-new account starts in. See [Create your workspace from your website](/en/getting-started/create-your-workspace) for what that wizard does.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Going to Workspaces lands you back in a workspace instead of the list">
    Without `?select=1` in the address, the app treats the visit as "get me into
    a workspace" and opens one instead of showing the list: your only workspace
    if you have just the one, and otherwise one it picks for you, which is not
    necessarily the one you were last in. Both the header switcher and the
    sidebar's **Workspaces** link add `?select=1` for you; a bookmark or a typed
    `/workspaces` does not. Add it and you get the full list.
  </Accordion>

  <Accordion title="You cannot find Create Workspace">
    The banner is hidden when you reach the product through a partner's own
    branded address and you are not that partner's own account.
    The **Add Company** entry at the bottom of the workspace switcher stays where
    it is, and opens the same setup.
  </Accordion>

  <Accordion title="Switching drops you on the dashboard instead of the page you were on">
    Your role in the workspace you switched into does not allow that page, so the
    app sends you to that workspace's dashboard instead. Roles are set per
    workspace, so the same account can read Prospects in one workspace and not in
    another. See [Roles and permissions](/en/settings-team/roles-and-permissions).
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Create your workspace from your website" icon="building" href="/en/getting-started/create-your-workspace">
    What the setup wizard actually does, screen by screen.
  </Card>

  <Card title="Workspaces overview" icon="compass" href="/en/workspaces-account/workspaces-overview">
    What lives inside a workspace, and who can edit or delete one.
  </Card>

  <Card title="Roles and permissions" icon="shield-check" href="/en/settings-team/roles-and-permissions">
    Why the same account sees different pages in different workspaces.
  </Card>

  <Card title="Navigating the app" icon="layout-dashboard" href="/en/getting-started/navigating-the-app">
    The rest of the header and sidebar, and why a menu item might not be there.
  </Card>
</CardGroup>