Element

Add Email to Your Account

  1. Go to Element All settings
    temp

  2. Enter your email address and click Add
    temp

  3. When you get this message, check your email
    temp

  4. Click the link in the email. Make sure it opens in another tab/window, leaving your Element client where it is
    temp

  5. When you get this message, you can close the verification tab/window and return to Element
    temp

  6. Go back to Element and click Continue
    temp

  7. Enter your account password, then click Continue
    temp

  8. If all worked correctly, your new email should now show up under the Email addresses section in Element settings. If not, something went wrong and you need to try again
    temp

Change Account Password

Resetting the account password will log out all your sessions. Before doing this, make sure that


If you know your current password

  1. Go to Element All settings
    temp

  2. Enter your current password and your new password
    temp

  3. You might want to export your E2E room keys. Just to be on the safe side in case something goes wrong. See also Export and Import E2E Room Keys

  4. Click Continue.
    Note: This warning is outdated, see this issue
    temp

  5. Click OK
    temp

  6. You now need to sign in again on all your other devices

If you do not know your current password

Note, this will only work if you have an email address attached to your Matrix account. If you do not have an email address attached, contact the administrators of your homeserver. (support@matrix.org does not reset passwords in any circumstance)

  1. Sign out of Element
    temp

  2. Click Sign out
    temp

  3. Click "Not sure of your password? Set a new one"
    temp

  4. Enter your email address, and a new password. Then click Send Reset Email
    temp

  5. Click Continue.
    Note: This warning is outdated, see this issue
    temp

  6. When you get this message, check your email
    temp

  7. Click the link in the email. Make sure it opens in new browser tab, leaving your Element client open
    temp

  8. Click Confirm changing my password
    temp

  9. You can now close this tab and return to Element
    temp

  10. Click i have verified my email address
    temp

  11. Click Return to login screen
    temp

  12. Sign in like normal with your new password. Note that all your other sessions have been signed out and you need to sign in again.

Change the default homeserver in Element Desktop

This guide applies if your system cannot connect to https://matrix.org and you see this error message when opening Element Desktop for the first time.

This is a temporary workaround until this issue is resolved.

In this guide, the homeserver domain is example.com, meaning Matrix usernames are @someone:example.com, and the homeserver is exposed on the domain matrix.example.com. Make sure you add your domains in the config below before pasting it into config.json.

First, exit Element, then follow the steps for your operating system below.

Linux

The exact steps may depend on your distro, but generally, it will be something along the lines of:

  1. Open your Terminal

  2. Right-click and paste cat > ~/.config/Element/config.json, then hit enter

  3. Right-click and paste

    {
        "default_server_config": {
            "m.homeserver": {
                "base_url": "https://matrix.example.com",
                "server_name": "example.com"
            }
        },
        "room_directory": {
            "servers": []
        }
    }
    
  4. Hit Ctrl + C

Mac

  1. Open Terminal. Hit Command + Space then enter terminal

  2. Right click and paste cat > ~/Library/Application\ Support/Element/config.json then hit enter

  3. Right-click and paste

    {
        "default_server_config": {
            "m.homeserver": {
                "base_url": "https://matrix.example.com",
                "server_name": "example.com"
            }
        },
        "room_directory": {
            "servers": []
        }
    }
    
  4. Hit Ctrl + C

Windows

  1. Press Win + R

  2. Paste in %APPDATA%\Element\

  3. Create a new text file named config.json

  4. Open config.json in Notepad

  5. Paste in

    {
        "default_server_config": {
            "m.homeserver": {
                "base_url": "https://matrix.example.com",
                "server_name": "example.com"
            }
        },
        "room_directory": {
            "servers": []
        }
    }
    
  6. Save and exit

Exporting Messages

Using your Element client you can export your Room's message history in HTML, Plain Text or JSON format - including attachments.

  1. Open the room you wish to export message history

  2. Access 'Room Info' using the icon in the top right

  3. Select 'Export Chat', then confirm your desired settings for export

  4. Finally click 'Export' - once the export has completed you will be prompted to save an archive of the export.

Submit Debug Logs

  1. Search for other issues of the same problem on

  2. If you cannot find any, create one by clicking New issue, then Get started in the Bug report section.
    temp
    temp

  3. Go to the section for your device

Element Web and Desktop

  1. Go to Element All settings
    temp

  2. Under Help & About, click Submit debug logs
    temp

  3. Enter a GitHub issue link and a description. Then click Send logs
    temp

  4. Click OK
    temp

Element iOS

  1. Tap the cog in the top left of Element
    temp

  2. Scroll down to the OTHER section, then tap Report bug
    temp

  3. Enter a GitHub issue link and a description, make sure Send logs is checked, then click Send
    temp

Element Android

  1. Tap the three stacked dots in the top right
    temp

  2. Tap Report bug
    temp

  3. Enter a GitHub issue link and a description, make sure Send logs, and Send crash logs are checked, then tap the send arrow in the top right
    temp