Multisite on VIP Go

VIP Go platform specific

This document is for sites running on VIP Go.

Learn more

Overview #

As well as single site WordPress installations on VIP Go, we also support multisite (also known as WordPress Networks). A WordPress multisite allows you to run multiple WordPress sites from the same WordPress installation, using the same set of user accounts. One common use case for a WordPress multisite is to support multiple languages, using the Multilingual Press plugin from Inpsyde, one of our VIP Featured Partner Agencies.

This help document covers the specifics of WordPress multisites on VIP Go, if you need a more general primer you can read the WordPress Codex article on WordPress Networks.

↑ Top ↑

Should I use a subdomain or subdirectory multisite? #

Formally, VIP Go supports only subdirectory multisites, but this still allows for all the scenarios you need to cover:

  • A pure subdirectory multisite, with sites addresses like example.com/one and example.com/two
  • A site using custom domains, with site addresses like example-another.com and example-further.com
  • A site using a mix of both, with site addresses like example.com, example.com/oneexample-another.com, and example-another.com/two

To achieve the same effect as a subdomain multisite, you could map a number of custom (sub)domains, e.g. one.example.com, two.example.com, etc.

We allow up to two segments in a subdirectory multisite path, so example.com/one (a “one segment” path) and example.com/one/two (a “two segment” path) are supported, but example.com/one/two/three (a “three segment” path) will not work, nor will adding further segments. Configuring a WordPress multisite to allow paths with two segments requires a small amount of code, see below for more details.

↑ Top ↑

Configuring a custom domain, including SSL certificate #

Configuring a custom domain requires three steps, and the site using the custom domain will not be accessible at that domain until all three have been completed:

Step 1: Configure the DNS to point to your site, using either an A record pointing to 192.0.66.2, or a CNAME record pointing to the *.go-vip.co domain for your site, e.g. example.go-vip.co. See the documentation on Managing Domains and DNS for more details.

Step 2: Submit a support ticket, requesting the domain is mapped to your WordPress multisite application in our infrastructure. At this point we need to configure an SSL certificate, to secure the admin area and, optionally, the front end for the site, there are two options:

  • As soon as the DNS is pointed to our infrastructure (see step 1 above), we can procure a Lets Encrypt SSL certificate. This is the most preferable option, as all updates are automated and your team doesn’t need to worry about renewing the certificate.
  • A custom SSL certificate can be procured, please read the SSL documentation for further information

Step 3: Add the site in the multisite using a temporary path, then edit the site to change the path to / (or up to a two segment path), and to change the domain to your desired custom domain.

Step 4: If you’re using more than one domain per site, set up your vip-config.php file to handle redirecting secondary domains to the desired primary domain for each subsite. Note that for multisite, redirects between non-www domains and www variants need to be specified in vip-config.php. More on multisite domain mapping.

↑ Top ↑

Subdirectory multisites with two segment paths #

VIP Go supports a subdirectory site with a single segment path, e.g. example.com/one, with no additional effort.

With a small amount of additional code, VIP Go can support two path segments, e.g. example.com/one/two (in this configuration it will support both one and two segment paths, as well as custom domains).

To enable paths with two segments, add the following code to /vip-config/client-sunrise.php:

function my_filter_site_by_path_segments_count( $num_segments ) {
        $num_segments = 3;
        return $num_segments;
}
add_filter( 'site_by_path_segments_count', 'my_filter_site_by_path_segments_count', 99 );

If you do not need paths with two segments, there is no need to add the above code.

↑ Top ↑

Which subsite should I launch first? #

Subsite 1 is the first site in a multisite network and will be listed first in the Network Admin > Sites listing. VIP strongly recommends launching subsite 1 first. If a client wishes to launch a different subsite first, the first site will need to be set to a non-convenience URL (something other than *.go-vip.co) at launch. While it’s not necessary to keep subsite 1 empty, many clients choose to do so.

↑ Top ↑

Data sync considerations #

Note that before performing a data sync between multisite environments, a domain mapping file must be created. Further details about data sync on VIP Go.

Ready to get started?

Drop us a note.

No matter where you are in the planning process, we’re happy to help, and we’re actual humans here on the other side of the form. 👋 We’re here to discuss your challenges and plans, evaluate your existing resources or a potential partner, or even make some initial recommendations. And, of course, we’re here to help any time you’re in the market for some robust WordPress awesomeness.