Mobile client provisioning links

Element mobile apps allows you to send customised links to users to automatically fill in the correct server domain and username.

This feature is available on iOS from version 25.05.2 and Android from version 25.06.0.

Using our service https://mobile.element.io/element; you can specify the homeserver with the account_provider query parameter and optionally the username with the login_hint parameter. For example:

https://mobile.element.io/element?account_provider=example.com

https://mobile.element.io/element?account_provider=example.com&login_hint=mxid:@alice:example.com

The mxid: login hint prefix is for when you are using MAS without an upstream IdP/Authentication provider. When you are using an ~~upstreadm~~upstream IdP, you need to set forward_login_hint: true in your MAS configuration for the hint to be forwarded. See the MAS documentation for more details. When you are using an upstream IdP, customise the login hint as required, for example with the ~~users~~user's username or email address.

https://mobile.element.io/element?account_provider=example.com&login_hint=alice

https://mobile.element.io/element?account_provider=example.com&login_hint=alice@example.com

For Element X Pro, use https://mobile.element.io/element-pro instead.

For classic Element mobile you can specify the homeserver domain with the hs_url query parameter, for example https://mobile.element.io/?hs_url=https://example.com