Skip to main content

Onboarding

If you are a new user click Create Account to register.

Select where to host your account by choosing a “homeserver”. You can use the custom server options to sign into other Matrix servers by specifying a homeserver URL. This allows you to use Element with an existing Matrix account on a different homeserver.

create_account

homeserver

Click "Edit" to choose your preferred Matrix homeserver if you have one, or host your own.

To learn more about homeservers, please visit matrix.org.

From here, please enter a username, password and email address and click Register.

Alternatively you can register with your existing Github, Google, GitLab, Facebook or Apple account.

Once prompted, please read the Terms and Conditions and click accept.

An email will be sent to your inbox to verify your email address, please follow the steps in the email to complete your registration.

Now you can login

Enter your email or username and password then click sign in / log in. From here you will be taken to Home, where you can start exploring!

Secure backup

Secure backup is an important safeguarding step to take, to ensure you never lose access to your encrypted messages and data.

When setting up your account, a message will appear which prompts you to do so. If you missed the prompt you can set this up from within your security and privacy settings.

  1. Click continue to start this process.

    setup_secure_backup

  2. Choose a memorable security passphrase or security key (for file store). This will create an encrypted backup on your server that only you can decrypt.

    generate_security_key

The next time you login on a new device or session, simply enter the passphrase or key to verify your session and you’ll have access to all of your data.

Device Verification

Device verification is optional and allows you to verify who you’re talking to.

  1. Click the Avatar the person you would like to verify, in the room header or after clicking the information icon.

    invite_to_room

  2. This will bring up their information and options, including one named "verify".

    user_profile

  3. Once accepted, both you and the other user will have a set of emoji s appear on screen. We recommend comparing these in real life or over a video call to ensure you're verifying the right person. If these match, click accept and a green shield will display.

    session_verification

Verify an additional device

To add your additional device please log into the Element app. You will be asked to verify this login on your existing device. This is an important step as it’ll allow other people to see that the new login is really you.

  1. Click Accept on your desktop app to start the verification process.

    verification_request_prompt

  2. Next you will be asked to either scan a QR code with your mobile camera or compare unique emoji's.

    verify_other_login_prompt

  3. A green shield will show once the process is complete.

    green_shield

  4. To manage your verified device, go to Security & Privacy in your settings where you can see all devices, rename or sign out of them.

    security_and_privacy_settings