1. Add a Site to Hub 2.0
This document covers how to connect a website to the Hub 2.0, where you can manage all your WordPress sites from one place with features like:
- One-click theme and plugin updates
- Site health and performance monitoring
- WordPress security
- SEO tools
- Cloud backups
- White label reporting
If you haven’t set up your WPMU DEV account yet, visit the Hub page, where you can explore the features, see pricing packages, and start a free trial.
Already a member? Visit your Hub dashboard to get started.
If you’re an agency operator and want to add multiple sites to your Hub in one go, see our Bulk adding sites to WPMU DEV Hub doc.
If you add a site with a non-standard port specified in its domain name, it will be added as a unique site in your Hub. This can be useful for development sites for example, where you could have domain.com as well as domain.com:8001, domain.com:8002, domain.com:8003, etc.
However, if they are all the same WordPress install and you don’t want all of them to appear in your Hub, you can add the following constants to your wp-config.php file to force the domain that should be used by your Hub and its API (the domain you specify must match the public URL of the site):
define( 'WPMUDEV_HUB_SITE_URL', 'https://domain.com' );
define( 'WPMUDEV_HUB_HOME_URL', 'https://domain.com' );
1.1 Getting StartedCopy chapter anchor to clipboard
There are two ways to connect your site to the Hub:
- Automatically from the Hub
- Remotely with the WPMU DEV Dashboard plugin
In this chapter, we will cover how to connect a site to the Hub using both methods.
It’s important to note that you cannot connect subsites in a multisite install to the Hub; only the main site of a multisite can be connected.
1.2 Connect from the HubCopy chapter anchor to clipboard
If you’ve never connected a site to the Hub, you’ll be given a prompt to Add your first website when visiting the Hub dashboard. Click the + Add Site button or the big + sign in the middle of the screen to get started.
Select the connection option that best suits your current needs.
- Connect – Connect an externally hosted site to The Hub. Note that this is the only option available here if you are a free Hub user. See Free Hub Restrictions for details.
- Migrate – Move your site to a dedicated environment hosted by us. For more on migrating a site, see our Migrating an Existing Site doc.
- Create New – Create a brand new site hosted with us. See Creating a New Site for more.
- Clone – Create a brand new site from a template. See Cloning Sites for more.
For the purposes of this guide, we’ll select the first option to connect a 3rd-party-hosted site.
You’ll then be prompted to select either the Automatic or Manual Connection method. The manual method involves installing the WPMU DEV Dashboard plugin, as detailed in the following chapter of this document. Select the Automatic method to connect your site automatically to your Hub.
Enter the website URL of the WordPress site you would like to connect to the Hub into the Website URL field and click the forward arrow to continue.
You’ll then be prompted to enter your WordPress administrator username and password for the website you are connecting. Note that we don’t store your login information as it is only used to connect your site to the Hub.
You will also be given the option to enable Secure one-click WP Login, also known as Single Sign-On (SSO). SSO allows you to access connected sites securely from the Hub without having to sign in separately to each site. SSO is enabled by default, and can be disabled by de-selecting the checkbox. Learn more about SSO.
Click the Connect button to connect your site.
This will automatically install and connect the WPMU DEV Dashboard plugin to the Hub. The WPMU DEV dashboard is a lightweight utility plugin for easily connecting with the WPMU DEV API. Read more about available tools and features in the WPMU DEV Dashboard documentation.
Once your site is connected, you’ll be presented with the Quick Setup wizard where you can install, configure and activate the Hub services you need with just a few clicks.
Click Skip quick setup at the bottom if you don’t want to set things up right away. You can always get the wizard back again later from your Site Settings if needed.
Your connected site will appear in your Hub overview screen where you can click the + Add Site button in the upper right-hand corner or the + Connect New Site button at the bottom to connect more sites as needed.
If you encounter any issues connecting a site remotely from the Hub, click the Use plugin method from the Connect WordPress website screen to manually download and install the WPMU DEV Dashboard plugin following the instructions below.
1.3 Connect from WPMU DEV Dashboard PluginCopy chapter anchor to clipboard
WPMU DEV hosted sites are automatically added to the Hub associated with the account that created the site. See Connecting WPMU DEV Hosted Sites below for more information on that.
If your site is not hosted with us, you can still connect remotely via the WPMU DEV Dashboard Plugin. Firstly, ensure that the plugin is installed and active on the site that you want to connect to the Hub.
When you navigate to the WPMU DEV Dashboard plugin tab, you will be prompted to enter your WPMU DEV account credentials to connect the site. Enter your credentials and tick the Enable SSO box if you would like to enable Single Sign-On, which allows you to access your site from the Hub without needing to log in each time. Click Connect when you’re ready.
Your site will then start connecting to the Hub. This is generally very fast but may take a few moments.
Once your site has finished connecting, you will receive a success message and can now use the WPMU DEV Dashboard plugin to its full extent.
That’s all that’s needed to connect your site to the Hub and now when you revisit your Hub and refresh the page, the new site will appear under the My Sites tab.
1.4 Connecting WPMU DEV Hosted SitesCopy chapter anchor to clipboard
WPMU DEV hosted sites are automatically added to the Hub associated with the account that creates the site. Learn more about setting up a site with WPMU DEV hosting in the Getting Started guide in the WPMU DEV Hosting section.
If you want your WPMU DEV hosted site to show in a different Hub account, visit the dashboard of your website, go to the WPMU DEV menu item, click your member avatar or the caret icon to open the logout option.
Click logout and you will be taken to the “Let’s connect your site” option. Enter the username and password of the WPMU DEV Hub account you would like to connect to and click connect.
The enable SSO option will activate single sign-on so you can jump to your site’s dashboard from the Hub without having to log back on.
Click here to learn more about secure one-click login.
Once your site is connected you can click the “Go to the Hub” button to visit the Hub account your site is connected to.
NOTE: If you want to migrate your sites’ hosting to a new account, see our site migration documentation.
Connecting a WPMU DEV hosted site to a different Hub account in this way DOES NOT transfer ownership or the hosting costs of that site to the other account. It simply makes it possible to manage Hub services for that site from the other account.