Quick-Start — Connect your first WordPress site

This guide assumes you have a Hubbee account (sign up free at hubbee.io/register) and one WordPress site you want to connect. Total time: ~2 minutes, and every step works on a phone too.

Step 1 — Download the Hubbee plugin

In Hubbee, click Download plugin — in step 3 of onboarding, or later under Sites → Connect Site. On a phone, the file is saved in the Files app under Downloads (iPhone) or in your Downloads folder (Android).

Note: Opened Hubbee from a link inside WhatsApp, Instagram or another app? Open the page in Safari or Chrome first — in-app browsers often can’t download files.

Step 2 — Install it in WordPress

1. WP Admin → Plugins → Add New Plugin → Upload Plugin
2. Choose the downloaded file → Install Now
3. Activate Plugin

Step 3 — Connect with Hubbee

1. In WP Admin, open Hubbee (left sidebar, or the Connect link in the Plugins list)
2. Click Connect with Hubbee
3. Hubbee opens: check the site address and workspace, then click Connect site

You’re sent back to WordPress, which shows Connected to Hubbee! — no token to copy. Site without HTTPS? Use the token instead, see Connect a WordPress site.

Within 2-3 seconds of connecting, the plugin has:

• Created two tables: wp_bz_tokens + wp_bz_processed_requests
• Stored an encrypted api_secret for future HMAC signing
• Started a hubbee_heartbeat cron job (every 5 minutes by default)
• Registered the bz/v1 REST namespace for inbound pushes

Step 4 — Verify in the dashboard

Switch back to app.hubbee.io. The site should now appear:

• Status: Online (green dot)
• Last heartbeat: a few seconds ago
• WP version, PHP version, plugin version: filled in

If status stays grey for more than 30 seconds → see Plugin shows offline.

Step 5 — Push your first token

In the dashboard:

1. Click your site → Tokens tab
2. Click + New Token Definition
3. Key: hero_title (lowercase, snake_case)
4. Label: Hero Title (human-readable)
5. Field type: text (or richtext for HTML)
6. Section: general (organizational grouping)
7. Click Save Definition

Now set a value:

1. Click the new token → Add value
2. Locale: leave empty (or de_DE for German-only)
3. Value: Welcome to my Hubbee-powered site!
4. Click Save & Push

The push runs immediately. The Activity stream shows the result:

• Site: client-foo
• Result: processed: 1, skipped: 0, errors: []
• Latency: typically <1 second

Step 6 — Render the token on your WordPress site

In Elementor (or any theme that supports shortcodes):

[bz_text key="hero_title"]

Or as Elementor Dynamic Tag: choose Hubbee → Text Token and select hero_title.

The token renders the latest pushed value on the frontend. Every future push updates the rendered value within seconds (cache-permitting — see Caching plugins).

What now?

• Add more sites: repeat Steps 1-3 for each site. Each gets its own api_secret.
• Bulk push: select multiple sites in the dashboard → Push to selected. One source-of-truth, many sites.
• Multi-locale: add per-locale values (e.g., de_DE, en_US) — the plugin selects based on get_locale() at render-time.
• Rich text + components: see Token Management Best Practices.
• Multi-workspace agency setup: see Multi-Workspace for agencies (Agency plan).

Troubleshooting

If something doesn’t work:

• Plugin won’t activate: the plugin needs PHP 8.1+ and WordPress 6.4+. Ask your host to upgrade PHP.
• Connection rejected: click Connect with Hubbee again; with the token fallback, generate a fresh token (they expire after 60 minutes and are single-use).
• Site won’t appear in dashboard: see Plugin shows offline for the 5-step diagnostic.
• Push errors: see Token push failed.

Stuck? info@hubbee.io with the diagnostic output from those FAQs.