Third-party email clients can configure a custom-domain mailbox in several ways. The available setup flow may differ between Android, iOS, macOS, and Windows, even when the same mailbox is being added. The main options are Autodiscover, QR-code setup, provider templates, and manual IMAP/SMTP entry.
Automatic methods are usually the quickest when the email client and provider support the same setup method. Manual configuration remains important because it lets you enter the required mail server settings directly when automatic discovery does not complete. Setup differences between platforms are common, so the same account may show different options on different devices. Email client setup methods can vary significantly between platforms such as Android and iOS.
Table of Contents
Which email setup methods are available?
| Method | How it works | When to use it |
|---|---|---|
| Autodiscover | The client uses the email address and password to retrieve the account settings automatically. | Use it first when the client offers automatic account detection. |
| QR-code setup | The client uses a QR code as part of the account setup process. | Use it when the email provider or client provides a QR-code option. |
| Provider template | The client applies a predefined setup profile for a supported email provider. | Use it when the provider appears in the client’s list of supported providers. |
| Manual IMAP/SMTP | You enter the mail server settings directly instead of letting the client discover them. | Use it when automatic setup is unavailable or does not finish. |
How Autodiscover works
Autodiscover is a protocol that allows an email client to retrieve server settings automatically. In the standard flow, you enter the email address and password, and the client attempts to find the settings needed for the account. This avoids entering each server value by hand. Autodiscover uses the user’s email address and password to retrieve email settings automatically.
Autodiscover is a practical first choice on Android, iOS, macOS, or Windows when the option is shown. The exact screen names and available choices depend on the email client. If the client cannot discover the account, continue with a provider template, QR-code setup, or manual IMAP/SMTP entry when available.
How QR-code setup and provider templates differ
QR-code setup and provider templates are both alternatives to typing every setting manually. A QR-code flow requires a QR code supplied as part of the setup process. A provider template requires the email provider to be listed or supported by the client. The two methods are not interchangeable: a client may support one without supporting the other.
These options are most useful when the provider and the email client have a prepared setup flow. They reduce the amount of information that must be entered by hand, but the available choices can differ between Android, iOS, macOS, and Windows. If neither option appears, use manual IMAP/SMTP configuration.
When manual IMAP/SMTP setup is required
Manual setup is required when the client cannot discover the mailbox, does not include the provider in its templates, or does not offer the required QR-code flow. Manual IMAP/SMTP configuration means entering the server details for receiving and sending mail directly in the email client. It is the fallback method that does not depend on automatic discovery.
Before starting manual setup, have the following information ready:
- The full email address for the mailbox.
- The mailbox password.
- The incoming mail server details for IMAP.
- The outgoing mail server details for SMTP.
- The authentication details required by the email provider for each service.
Use the exact server names, ports, encryption settings, and login format supplied for the mailbox. These values are provider-specific, so a client cannot safely replace them with values from another email service. The email address and password used during automatic setup are also the first account details to check when manual authentication fails.
Which method should you use on each platform?
- Android: Start with Autodiscover if the email app offers it. If the account is not detected, try a provider template or QR-code setup. Use manual IMAP/SMTP when those options are unavailable.
- iOS: Use the automatic setup method shown by the email app. Platform setup flows can differ from Android, so a method available on one device may not appear on another. Use manual IMAP/SMTP when automatic discovery does not complete.
- macOS: Choose Autodiscover or a provider template when offered. If the client asks for server details, enter the IMAP and SMTP values supplied for the mailbox.
- Windows: Try the available automatic method first. If the client cannot identify the custom-domain account, switch to manual IMAP/SMTP configuration and enter the provider’s exact settings.
What to verify when automatic setup fails
Check the full email address and password first. Then confirm that the selected account type matches the setup information provided for the mailbox. For manual setup, verify the incoming IMAP server, outgoing SMTP server, server ports, encryption settings, and authentication details as a complete set. A single incorrect value can prevent the client from connecting or sending mail.
Automatic setup is the preferred starting point when it is available and supported. Manual IMAP/SMTP entry is the most direct fallback because it exposes the server details and authentication fields that the client needs. QR codes and provider templates are useful alternatives, but their availability depends on the email client and provider combination.