OrbitsDocs
esc
    Open Orbits
    DomainsEmail records

    Email records

    On a domain that uses Orbits DNS, Email setup adds the MX and SPF records for Google Workspace, Microsoft 365 or Zoho Mail in one step.

    Hosting a site on Orbits doesn't include a mailbox, but if your domain uses Orbits DNS, Orbits can add the DNS records your email provider needs. You get mail from your provider as before; Orbits only publishes the records that send it there.

    Email setup is for zones on Orbits DNS. If your domain's DNS is at another provider, add your email provider's records there.

    Set up email

    On the zone's page in Domains and DNS, press Email setup and pick your provider:

    • Google (Google Workspace)
    • Microsoft (Microsoft 365)
    • Zoho (Zoho Mail)
    • Something else: adds nothing, for you to add the records yourself.

    The dialog shows how many mail records the zone has now ("Already set up · 5 records"), which provider is Active, and what each provider would add. Press Add records to apply.

    Choosing a provider replaces the mail records of the one before: MX records, the SPF TXT record and Microsoft's autodiscover CNAME. Your DMARC record and other TXT records stay. Choosing Something else clears the provider and keeps every record, for you to manage.

    The records added

    All with a TTL of one hour, at the zone's own name (@) unless noted.

    TypeNameValue
    MX@1 aspmx.l.google.com
    MX@5 alt1.aspmx.l.google.com
    MX@5 alt2.aspmx.l.google.com
    MX@10 alt3.aspmx.l.google.com
    MX@10 alt4.aspmx.l.google.com
    TXT@v=spf1 include:_spf.google.com ~all

    A record that would clash with one of yours, or with a record Orbits manages for a project, isn't added; the dialog leaves it out of what it adds.

    If your provider gives your account different records from these, choose Something else and add the records it gives you with Add record.

    DKIM and DMARC

    Email setup doesn't add DKIM or DMARC.

    • DKIM keys are made by your email account, so only your provider can give them to you. Copy the DKIM record from its admin console and add it with Add record.
    • DMARC is a TXT record at _dmarc that you write for your own policy, for example v=DMARC1; p=none; rua=mailto:dmarc@example.com. Add it with Add record; Email setup never changes it.

    Editing the records

    Mail records that came with Email setup are marked as used by email on the zone's page and stay editable, like your own. Choosing a provider again in Email setup replaces the zone's MX, SPF and autodiscover records with that provider's.

    Through the API

    Reading the dialog's state and setting the provider are in DNS.

    Was this page helpful?

    Updated