Merge branch '2838-gitlab-identity-migration-pt1' into 'develop'
[gitter.git] / docs / accounts.md
bloba5c67738ebd9937ce785d6a8d2dae2f65d3e69cf
1 # Gitter account
3 A Gitter account is associated with GitLab/GitHub/Twitter and matches whatever info you have on that platform.
5 If you updated some info on GitLab/GitHub/Twitter, sign out of Gitter and sign back in to have it updated.
8 ## Can I merge/connect my accounts?
10 There isn't a way to merge accounts.
12 We will probably introduce this capability after we add the [ability to set your own username](https://gitlab.com/gitterHQ/webapp/-/issues/1851). You can track [this issue](https://gitlab.com/gitterHQ/webapp/-/issues/1752) for linking different accounts together.
15 ## Can I change my username?
17 You can't change your username. Your username matches whatever OAuth provider you signed in with.
19 If you changed your username on GitHub, sign out of Gitter and sign back in again to update it.
22 ### How do I remove the  `_gitlab`/`_twitter` suffix from my username
24 See above, you can't change your username.
26 We add the `_gitlab`/`_twitter` suffix to avoid name collisions with GitHub.
27 If you don't want the suffix added, sign in with GitHub.
29 You can track [#1851](https://gitlab.com/gitterHQ/webapp/issues/1851)
30 for the ability to customize your username in the future and remove the suffix.
32 ## How do I update my avatar?
34 Sign out of Gitter and sign back in to update your avatar (or any other info).
36 Currently, there is an outstanding bug where this doesn't work with GitLab/Twitter accounts, https://gitlab.com/gitterHQ/webapp/issues/1834
39 ## How do I export my data?
41 You can export data associated with your account by using the profile menu dropdown in the top-right -> **Export user data**
43 If you're looking to export data for a room, see the [room docs on export](./rooms.md#export-room-data).
46 ## How do I delete my account?
48 You can delete your account by using the profile menu dropdown in the top-right -> **Delete Account**
50 ![](https://i.imgur.com/j3Gowl7.png)
52 This could leave some communities/rooms orphaned without an admin (make sure to set another admin before deletion).
54 We can't recover your data after deletion but you can re-create your account at any time by signing back in.
56 ### Ghost user
58 If you want to remove/disassociate all of your personal information from your Gitter account,
59 you can use the **Remove personal information and turn my account into a "ghost"** checkbox in the delete account modal.
61 This will:
63  - Clear any backing identities (such as GitLab/Twitter) including GitHub tokens
64  - Clear any emails
65  - Change your username to `ghost~<id>` and your display name to "Ghost"
66  - Clear your avatar
67  - Mark your ghost user account as removed
69 This will **NOT**:
71  - Delete your messages
72  - Delete your communities/rooms
73  - Change mentions of your username
75 ![](https://i.imgur.com/rX3plq5.png)