How to change your name, theme or email address

Your TeleportHQ profile lives in Account Settings. Open it from the ⋯ menu next to your name at the top of the dashboard's left sidebar. On the General tab you can change your Name; on the Theme tab you can pick Light Theme or Dark Theme. Your Email is shown there too, but you can't change it yourself.

Before you start#

• Account Settings is for your personal account. Workspace and project settings are elsewhere.
• Profile photos, usernames and two-factor authentication aren't available.

Steps#

Open Account Settings#

1. On the TeleportHQ dashboard, at the top of the left sidebar, find the row with your initial and name. If you haven't set a name, the row shows your email address.
2. Point at that row. A ⋯ icon appears at its right end.
3. Click the ⋯ icon.
4. Click Account Settings. The General tab opens.

In the editor, you can also open the Project Menu (the TeleportHQ logo at the top left) and click Account → Account Settings.

Change your name#

1. On the General tab, find Name ("This is the name you used when you signed up"). It may be empty if you signed up with an email address.
2. Type your name. For example, type Emma Brooks.
3. Click Save Changes, right under the field. The name in the sidebar updates right away.

Collaborators see this name in shared projects, for example on your comments and on the label that marks what you're editing on the canvas. Without a name, TeleportHQ makes one from the first part of your email address (for example, emma.brooks@… shows as "Emma Brooks").

Switch between light and dark theme#

1. In the SETTINGS menu on the left, click Theme.
2. Click Light Theme or Dark Theme. The change applies right away.

The theme is saved to your account, so it follows you on other computers. It changes the dashboard and settings pages, not the editor.

Changing your email address#

Changing the email address of a TeleportHQ account isn't available in the app. The Email field on the General tab ("This is the e-mail account that your link is associated to") is read-only.

TeleportHQ support changes it for you:

1. Write to hello@teleporthq.io from your current email address. Say which new address you want to use.
2. Support checks that you own both addresses, the current one and the new one, then changes it.

See How to get help.

Check that it worked#

• Name: your new name shows at the top of the dashboard sidebar.
• Theme: the dashboard switches colors immediately.

Troubleshooting#

The Save Changes button stays greyed out You haven't changed the name, or the name isn't valid yet. Names need 3 to 50 characters and can't contain <, >, { or }.

"Name should be between 3 and 90 characters" The limit is actually 50 characters, even though the message says 90. Shorten the name to 50 characters or fewer.

"Name is not in a valid format" Remove special characters such as <, >, { and }. The second character of the name must also be a plain letter (A to Z), a number or a space, so some names written in other alphabets are refused. In that case, type the name in Latin letters.

"Could not update account" Try again. If it keeps failing, reload the page.

"Could not update theme preferences, please try again!" Reload the page and pick the theme again.

Good to know#

• Log out: open the ⋯ menu next to your name in the sidebar, then click Log Out. There's no confirmation, and the Sign in page opens.
• Choose which workspace opens when you sign in: use Primary workspace on the same General tab. See How to switch workspaces and choose which one opens first.
• Sign-in methods and password: see How to add or remove Google, GitHub or Microsoft sign-in and How to reset or change your password.
• Your avatar is the first letter of your name. You can't upload a photo.
• Your answers to the welcome questions can't be edited.