Workspaces

How to rename a workspace

September 15, 2026
How to rename a workspace

In TeleportHQ, the workspace Owner renames a workspace from its General settings: point at the workspace in the dashboard sidebar, click ⋯ → Rename, type the new name in Workspace name and click Save Changes. The new name shows everywhere straight away, for everyone in the workspace.

Before you start

  • Only the workspace Owner can rename it. Other members see the name as read-only.

Steps

  1. On your dashboard, in the left sidebar, point at the workspace under WORKSPACES.
  2. Click the ⋯ icon that appears at the right end of its row.

  3. Click Rename, at the bottom of the menu. Workspace Settings opens on the General tab.

    The ⋯ menu of a workspace in the TeleportHQ dashboard sidebar, with Rename highlighted at the bottom
  4. Scroll to the Workspace card and click the Workspace name field.
  5. Replace the name with the new one, for example Studio North.
  6. Click Save Changes.
The Workspace card on the General tab of TeleportHQ Workspace Settings, with the Workspace name field and the Save Changes button highlighted

Check that it worked

TeleportHQ shows "Workspace was successfully updated." The new name appears in the left sidebar.

Troubleshooting

"Name should be between 3 and 90 characters" The name is too short or too long. Use 3 to 50 characters: the message says 90, but a workspace name can have at most 50.

"Name is not in a valid format" The name has characters TeleportHQ doesn't allow, such as <, >, { or }, or its second character is a letter with an accent. Change those characters.

"Workspace name already exists" Another workspace in your sidebar already has this name, including workspaces shared with you. Choose a different name.

Save Changes does nothing The button stays greyed out until you change the name, and does nothing while a message shows under the field. Fix the name first. If you aren't the Owner, the field can't be edited and the button isn't shown.

"Could not rename workspace. Please try again." The name wasn't saved. Reload the page and try again.

Good to know

  • The web address doesn't change. The workspace's link in your browser keeps its original name, so saved links still work.
Share

Related Articles

What is a workspace?

A TeleportHQ workspace is a shared space with one Owner that holds projects, members with roles, and its own plan and billing; you can own several workspaces and be a member of other people's, all listed in the dashboard sidebar under WORKSPACES and SHARED WITH ME.

How to create a new workspace

In TeleportHQ, click New Workspace at the bottom of the dashboard sidebar, choose Pro, Premium or Academic, name the workspace, pick yearly or monthly billing and click Start with Pro (or the plan you chose) to pay at checkout; TeleportHQ then opens the new workspace.

How to delete a workspace

In TeleportHQ, the workspace Owner opens Workspace Settings → General and clicks Delete workspace in the red card at the bottom; this permanently deletes every project in it, and it's only possible once the plan, seats and add-ons have stopped billing and you own another workspace.

How to switch workspaces and choose which one opens first

In TeleportHQ, click any workspace name in the dashboard's left sidebar to switch to it, and set Account Settings → General → Primary workspace to choose which workspace opens when you sign in, on any browser or device.