Skip to content

Managing Domains in FlyWP

Domain TypeServes Content?Stored as Site URLTypical Use Case
PrimaryYesDatabase (WordPress sites) or ENV (1-Click Apps and other apps)Your site’s main, canonical domain
AliasYesNot stored as the site URLMultisite setups, hosting on multiple domains
RedirectNo (forwards traffic)Not stored as the site URLwww/non-www redirects, old domains, typo domains, legacy URLs

Every FlyWP site, whether it’s a WordPress site, a 1-Click App, an Nginx site, a PHP site, or a Laravel site, comes with a Site Domains panel where you can add, organize, and manage the domains connected to that site. You’ll find this panel under Site Dashboard > Settings.

Image

This guide explains the three domain types you’ll see in that panel, how they behave, and what to do after adding a new domain.

When you add a domain to a site, you’ll assign it one of three types: Primary, Alias, or Redirect. Each one behaves differently, so it’s worth understanding the distinction before you start adding domains.

The Primary domain is your site’s main URL. Where it’s stored depends on the type of site:

  • WordPress sites: the Primary domain is stored in the site’s database.
  • 1-Click Apps and other apps (Nginx, PHP, Laravel, etc.): the Primary domain is stored in the site’s environment variables (ENV).

There can only be one Primary domain per site at a time. If you need to change which domain is Primary, you can do this from the Site Domains panel — just keep in mind that this updates the URL your site references internally, so it’s a good idea to test the change carefully, especially on a live site.

An Alias domain serves your site’s content, just like the Primary domain does — but without changing the stored site URL (whether that’s the database or the ENV, depending on your site type). In other words, visitors can reach your site through the alias domain and see the exact same content as the Primary domain, side by side.

This is especially useful if you:

  • Run a WordPress Multisite installation and need to serve different domains from the same install
  • Want to host the same site on multiple domains (for example, regional domain variants or legacy domains you still want active)

A Redirect domain doesn’t serve content on its own. Instead, any visitor who lands on a Redirect domain is automatically forwarded to your Primary domain. This is the type to use when you want an old domain, a typo variant, or a secondary domain to simply point traffic back to your main site.

A common example is www and non-www redirects. If your Primary domain is www.example.com, you can add example.com as a Redirect domain so visitors who type in the non-www version are automatically sent to the www version (or vice versa), keeping your traffic and SEO consolidated on a single, consistent domain.

From your site’s Settings page, you can add a new domain at any time using the Add New Domain button in the top-right corner of the Site Domains panel. There’s currently no limit on the number of domains you can add to a site, so feel free to add as many Primary, Alias, or Redirect domains as your setup needs.

If the Name Already Has a Cloudflare A Record

Section titled “If the Name Already Has a Cloudflare A Record”

When Add DNS record on Cloudflare is ticked, FlyWP looks in the Cloudflare zone for an A record with the same name before it adds the domain. If your team has more than one Cloudflare account, choose the account first.

Cloudflare accepts two A records with the same name, and traffic then splits between both servers. FlyWP does not add a second record. Instead, it shows the DNS Record Already Exists dialog, which lists each existing record:

Existing A records: shop.example.com → 203.0.113.10.

The dialog opens for every IP, including this server’s IP. If you enabled wildcard subdomains, the check also covers the *. record, and the dialog lists it too.

  • Click Delete and continue to delete the listed records and add the domain. FlyWP then creates its own A record for the domain, pointing to the server.
  • Click Close to stop. Nothing is deleted or added, and the Add New Domain form stays open with your values.

Editing a domain never shows this dialog.

If another FlyWP site manages the A record for that name, FlyWP refuses to add the domain. The error appears under the Name field, and no dialog opens:

  • Same team: FlyWP manages the DNS record for shop.example.com for the site old-site.example.com on 203.0.113.10. Remove the domain from that site first.
  • Another team: FlyWP manages the DNS record for shop.example.com for another site. Remove the domain from that site first.

To add the domain here, first remove it from the other site. Deleting that domain there also removes the DNS record FlyWP made for it. Then add the domain again.

Only a member who can manage DNS for the zone can delete existing records. Team Administrators can. Other members can if they have been given DNS access. For more on roles, see Team Members and DNS Manager.

A member without DNS access does not see the dialog or the record list. The error under Name reads:

shop.example.com already has an A record in Cloudflare. Ask a team member with DNS access to add this domain.

Adding a domain to the Site Domains panel does not automatically issue an SSL certificate for it. When you make a domain the primary one, FlyWP issues a free Let’s Encrypt certificate only if the site was set up with HTTPS (Let’s Encrypt). For any alias or secondary domain, you’ll need to manually activate SSL before it’s served securely over HTTPS.

If you skip this step, visitors reaching your new domain may see a browser security warning, so it’s worth making SSL activation part of your routine whenever you add a domain.

If you run into any issues while adding domains or activating SSL, our support team is happy to help — just reach out and let us know what you’re seeing.

Still stuck? How can we help?

View as Markdown