The number one reason why you will only see the Home screen, and not the Game screen, on the Zwift Mobile Link (ZML) app is because your Zwift device and mobile device are not on the same network.
In order for the app to work, your mobile device has to be connected on the same WiFi as your Zwift device and logged in with the same Zwift account in order for the app to show the additional in-game ride controls.
Note: You will still be able to pair an Ethernet-connected device if it's going through the same router that's transmitting WiFi.
If your mobile device is on the same WiFi network as your Zwift device, but you're still having problems, there's a few other scenarios that could block the connection, and we'll cover them below.
If you have a proxy, VPN, or strict/enterprise-strength firewall on your computer and/or phone, it can prevent you from connecting, so we recommend making exceptions for Zwift as appropriate.
If that doesn't apply to you, try the following:
- Make sure ZML is completely closed
- Turn off mobile data on OR turn on Airplane mode on your phone
- Connect to your Wi-Fi network
- Launch ZML
- Launch Zwift on your other device
These steps should ensure that you're connecting solely over WiFi versus mobile data.
The last reason why you may be unable to connect is because you haven't updated to the newest app version. If you've turned off automatic updates or rejected updates for the app, you may be stuck with a version that's no longer supported. Visit the Play Store or iTunes store on your device to make sure that you have the newest version installed.
ZML listens on TCP port 21587. Your router firewall should also allow all incoming/outgoing Zwift TCP traffic on ports 80 and 443 and all Zwift incoming UDP traffic on port 3022.
If you have port blocking enabled, you may need to either turn it off, or port forward to those specific ports, for ZML to work properly.
ZML keeps losing its connection
We cover this in a different article.
If you're still unable to connect, submit a support ticket, so we can investigate with you further.