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 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 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