Skip to main content

Connecting your website

By default, RedBuster only knows about your business from the short description you gave it during setup. Connecting your website lets RedBuster read your actual site content, so drafted replies stay grounded in what you really offer — and stay current automatically as you add or change pages.

This is managed from /dashboard/website, and requires an active subscription — the page is locked until you're on a paid plan.

There are two ways to connect a site. Use whichever fits how your site is built.

Option 1: the website snippet​

Works on any site, regardless of what it's built with.

  1. Go to Website in the dashboard and enter your domain (e.g. yourdomain.com).

  2. Click Generate snippet. You'll get a one-line script tag:

    <script src="https://redbuster.net/sdk.js" data-rb-key="rb_pub_..." async></script>

  3. Paste it into your site's <head>, on every page (most site builders have a single "custom code" or "header scripts" field that applies it sitewide — you only need to do this once).

Copy the key now. The full key is only ever shown once, right after you generate it. If you lose it, generate a new one — the old one still works until you revoke it.

What the snippet does​

  • On each page load, it reads the page's title, meta description, and visible text content (navigation, headers, and footers are stripped out), and sends that to RedBuster — but only if the content has changed since the last time it was sent, so repeat visits don't do unnecessary work.
  • Once per browser session, it also fetches your site's /sitemap.xml and reports the URLs it finds, so RedBuster can pick up pages nobody has actually visited recently.

About the key​

The key in the snippet is visible to anyone who views your page source — it's meant to be, the same way an analytics tracking ID is. Because of that, it isn't treated as a secret: it's locked to the exact domain you generated it for, and requests from any other domain using that key are rejected. If it ever gets copied elsewhere, it's still useless off your own domain.

Option 2: the WordPress plugin​

If your site runs on WordPress, this is the more complete option — it reads your published posts, pages, and WooCommerce products directly through WordPress itself, so RedBuster has your whole content inventory from the moment you activate it, not just the pages people happen to visit.

  1. Go to Website in the dashboard and click Generate WordPress plugin.
  2. Download the .zip — your key is already built into it, so there's nothing to configure.
  3. In WordPress: Plugins → Add New → Upload Plugin, choose the zip, install, and activate.
  4. On activation, the plugin does a full sync of your published posts, pages, and products.

After that, it keeps itself current automatically:

  • Publishing or updating a post/page/product pushes the update immediately.
  • Trashing one removes it from what RedBuster knows about your site.

You can check sync status, or trigger a manual re-sync, from Settings → RedBuster Connector in your WordPress admin.

About the key​

This key stays server-side inside your WordPress install and never reaches a browser, so — unlike the snippet key — it's a real secret. Don't share the plugin zip publicly; anyone with it could use the key to push content to your RedBuster account (though not to read anything back, and not to touch anything else in your account).

Managing keys​

The Website page lists every key you've generated — type, domain (for snippet keys), and when it was last used. Revoke immediately and permanently disables a key; the snippet or plugin using it will stop working. Revoking is one-way — to reconnect, generate a new key and update the snippet or plugin with it.

What RedBuster does with this​

Every page RedBuster has read shows up in the Pages RedBuster has read table on the same screen, so you can see exactly what it knows — the page, where it came from (snippet, WordPress, or a sitemap crawl), and when it was last updated.

Troubleshooting​

  • Nothing shows up in "Pages RedBuster has read." Confirm the snippet is actually in your page's <head> (view page source), or that the WordPress plugin shows a successful sync under Settings → RedBuster Connector. Also confirm your subscription is active — ingestion silently stops the moment a plan lapses, and resumes automatically once it's active again.
  • A page's content looks stale. The snippet only re-sends a page when its content changes, and only when someone visits it. A sitemap-triggered crawl or the WordPress plugin's own sync will pick up changes without needing a visit.
  • The snippet key stopped working after I regenerated it. Only the most recently copied key is valid for a given use — if you generate a new key, update the <script> tag (or re-download the plugin) with it.