Sign in Start free

← Docs  /  Getting started

Connect your first site

Updated 2026-09-05

Register a site and pair the free WPClientHub connector plugin — the one-time pairing code, what it can and can't do, and what happens on the first sync.

Browse documentation

What it does

A site becomes "connected" once the free WPClientHub connector plugin is installed on it and paired to your agency's account. Pairing exchanges a one-time code for a cryptographic identity: WPClientHub generates a unique Ed25519 keypair for that site, keeps the private half on the hub, and the site stores only the public half. From then on, every instruction WPClientHub sends the site — a sync, an update, a backup, a one-click login — is signed with a timestamp and a random nonce, and the site verifies the signature before doing anything. Your WordPress password is never seen by, or stored in, WPClientHub.

Once paired, uptime and SSL checks start on their own; the site's health score, plugin/theme inventory and update list appear within about a minute of the first sync.

How to

  1. On Sites, click Add site.
  2. Enter the Site name and Site URL, optionally assign a Client, then click Register site.
  3. Copy the pairing code shown — it is shown only once.
  4. Download the WPClientHub plugin and install it on the site (wp-admin → Plugins → Add New → Upload Plugin).
  5. In wp-admin, open Settings → WPClientHub.
  6. Paste the hub URL (shown in the same dialog) and the pairing code, then save.
  7. The site flips to Connected in WPClientHub automatically after its first sync — no further action needed.
Already registered this URL? If a site with that address already exists in your portfolio, the dialog shows "Already added" and the submit button becomes Open existing site instead — there is no way to register the same URL twice by accident.

Limits & defaults

SettingDefault
Connector requirementsWordPress 6.0+, PHP 7.4+ (self-update and diagnostics need 0.5.0+; the fleet target is 0.7.0)
Pairing codeOne-time use; request a new one from Add Site if it expired before you pasted it
What the connector can doSync versions/health, run updates you trigger, take backups, one-time 60-second single-use login, toggle maintenance mode, self-update
What it never doesStore or transmit your WordPress password; auto-apply any update without you asking

Troubleshooting

The site won't pair / "invalid pairing code"
Codes are single-use and tied to the site record you created — go back to Sites, open Add Site again for a fresh code, and make sure the hub URL you pasted into wp-admin matches exactly (same scheme, no trailing slash).
Pairing succeeds but the site never shows "Connected"
The connector needs outbound HTTPS to your hub. Check the site's own error log, and confirm nothing (a firewall, a security plugin) is blocking outbound requests or WordPress's own REST API.
I need to move a site to a different client afterwards
Open the site, use the client field in its header — no need to re-pair.