Description
An AI chatbot that knows your content, and earns for you. Brambles.ai adds an AI chatbot and AI search to your site. It answers readers’ questions from your own articles, suggests what to read next, and recommends products that fit the page. You earn from ads shown with the conversation, and from affiliate sales when a reader buys through a recommendation. You don’t add a single link by hand.
Three ways to bring AI chat to your pages
- Floating chat: a chat button in the corner of every page. It can open with conversation starters, and it can suggest another article when a reader is about to leave.
- Inline chat: a unit placed inside your articles. It offers questions about the story, reading suggestions and products that match it. Place it automatically, or exactly where you want with a block or shortcode.
- Answer search bar: a search bar that answers readers’ questions in plain language, cites your articles and suggests follow-up questions. Add it with a block or shortcode.
Turn each one on or off and set it up from your WordPress dashboard.
Set it up in WordPress
- Colors, fonts, header title, welcome message, logo and chat button icon
- Chat button position, style and offset; the size of each product
- Conversation starters and opening prompts: write your own, or let the AI write the opening prompts
- Inline placement: automatic or manual, the position in the article, and pages to skip
- A chat disclaimer, exit-intent article suggestions, and answer sections
Your settings are saved in your Brambles.ai account, the same place the Brambles.ai dashboard keeps them, so the two never disagree. WordPress keeps only a temporary copy, for up to a day, to show the settings page when Brambles.ai can’t be reached.
Built for publishers
- Hands-free: the AI reads each page and picks what to show.
- Lightweight: the plugin adds one deferred script tag, served from a CDN. Nothing loads until you turn Brambles on for your site.
- Secure by design: each site gets its own storefront key, limited to the chat itself. Requests from WordPress to Brambles.ai are signed.
- Accessible admin: labelled controls, keyboard friendly, and every form works without JavaScript.
- Works with your setup: the block editor, Classic Editor, most themes, page builders and caching plugins, alongside WooCommerce.
More controls, reports, conversations, your content index and knowledge base live in the Brambles.ai dashboard. The plugin links to them.
External service
This plugin connects your site to the Brambles.ai service, which provides the AI chat. It sends data to Brambles.ai (widget.brambles.ai) as follows:
- On activation, and when you retry setup: your site’s address and name, the administrator email address, the WordPress, PHP and plugin versions, and an identifier and secret the plugin creates for your site. Brambles.ai uses these to create your account and issue your site’s storefront key.
- When you open or save the plugin’s settings: your site’s identifier and storefront key, and the settings you change.
- On your public pages, while Brambles is turned on: visitors’ browsers load the Brambles.ai script. It reads the page to answer questions and choose suggestions, and it records interactions such as questions and clicks. If you choose a Google Font, browsers also load it from Google Fonts. Depending on your Brambles.ai account, the script can also show labeled ads and offers from Brambles.ai’s advertising partners, whose servers then receive the visitor’s browser request, such as the IP address and the page address.
Read the Brambles.ai Terms of Service and Privacy Policy.
Privacy
The plugin stores your site’s identifier, its secret and its storefront key in WordPress, plus a short-lived copy of your settings for display. It never stores visitor data. Visitors’ interactions with the chat are processed by Brambles.ai, as described under “External service”. Add suitable privacy policy and affiliate disclosure text to your site. The plugin’s Help tab suggests some.
Installation
- Install and activate the plugin.
- Open Brambles.ai in the WordPress admin menu. Secure setup runs automatically and gives your site its own storefront key.
- Choose the products you want, then select Turn Brambles on for this site.
- Adjust the look and placement on the product and Appearance tabs.
- To see reports and earnings and to set up payouts, connect the site to a Brambles.ai account from the Overview tab.
To place inline chat or the answer search bar yourself, use the Brambles blocks in the block editor, or the shortcodes listed on the plugin’s Help tab.
FAQ
How does my site earn?
Two ways. Ads from Brambles.ai’s advertising partners appear with the conversation, and you earn when they are shown or clicked. Product recommendations carry affiliate links, and you earn when a reader buys. Both are handled for you: there is nothing to sell and no links to add.
How do I get paid?
Connect your site to a Brambles.ai account from the plugin’s Overview tab, then set up your payout account in the Brambles.ai dashboard. Earnings are tracked from the moment Brambles is turned on, before you connect.
Do I need to add affiliate links?
No. The AI reads each page and recommends products that fit it.
Where are my settings stored?
In your Brambles.ai account. WordPress reads and saves them there, so a change made in the Brambles.ai dashboard shows up in WordPress, and the reverse. If someone else saved a newer change, WordPress asks you to reload instead of overwriting it.
What happens if Brambles.ai can’t be reached?
Your pages keep working, and the chat comes back as soon as the service does. The settings page shows the last settings it read, read-only, until Brambles.ai answers again.
Will it slow down my site?
No. The plugin adds one deferred script, only to public pages, only while Brambles is on. It is never added to the admin, feeds or REST responses.
Can I keep Brambles off some pages?
Yes. List them under Exclude Brambles on these pages on the Overview tab. Developers can also use the brambles_ai_load_on_page filter.
Can I use Brambles on a staging copy of my site?
A copy made from your live site carries the same Brambles account, so its changes would reach your live site. The plugin compares the address the site answers at with the one your Brambles.ai account was set up with, and turns saving off on a copy. To be safe, update your live site before you copy it, and don’t save settings on older copies. If your site really moved, confirm the new address on the Brambles.ai page.
Which settings are not in WordPress?
Monetization, affiliate networks, campaigns, billing and payouts are managed with Brambles.ai, not in WordPress. So are the AI’s personality, article-aware suggestions, your content index, knowledge base and reports.
Do I need an affiliate disclosure?
We recommend one on pages that show products, for example “We may earn a commission from qualifying purchases.” The plugin’s Help tab includes suggested privacy policy text.
Do I need a Brambles account?
No. The plugin works without one. Connect an account from the Overview tab to see this site’s reports and earnings and to set up payouts. A WordPress admin confirms every connection.
What happens when I delete the plugin?
Deleting it removes everything it stored in WordPress, including your site’s identifier and storefront key. Your settings stay in your Brambles.ai account.
If you install it again, AI chat keeps working, but your settings can then only be changed in the Brambles.ai dashboard until Brambles.ai support moves your account to the new installation. To troubleshoot, deactivate the plugin instead of deleting it.
Screenshots





Changelog
0.4.0
- NEW: Connect this site to a Brambles account. Open your site’s dashboard for its reports, earnings and payouts, or add a new site to an account you already run. It’s optional, and a WordPress admin confirms every connection.
- NEW: Turn floating chat, inline chat and the answer search bar on and off from WordPress.
- NEW: Set the publisher look-and-placement options from WordPress: colors, fonts, logo and chat button icon, header and welcome text, the chat disclaimer, chat button position, style and offsets, sizes, conversation starters and opening prompts, exit-intent articles, inline placement, answer sections, and pages to keep Brambles off.
- NEW: Settings are read from and saved to your Brambles.ai account, the same place the dashboard keeps them. WordPress keeps only a short-lived copy for display, and a newer dashboard change is never overwritten.
- NEW: Blocks and shortcodes to place inline chat and the answer search bar, listed on the plugin’s Help tab. The old
[brambles_ai]shortcode now places inline chat. - NEW: Editors can preview article-aware suggestions before they go live.
- IMPROVED: A redesigned admin page with setup status, product tabs and links to the Brambles.ai dashboard. Its controls are labelled and keyboard friendly, and it works without JavaScript.
- IMPROVED: When Brambles.ai is slow, down or busy, the settings page says so and for how long, shows the last settings it read (read-only), and backs off instead of retrying. It never shows default values in place of your settings.
- IMPROVED: If Brambles.ai stops accepting this site’s storefront key, or cannot verify its requests, the plugin page offers secure setup again.
- IMPROVED: On a staging or development copy of the site, saving is turned off so the copy can’t change the live site. Confirm a real move on the Brambles.ai page.
- IMPROVED: If Brambles.ai could only partly apply a change, the settings page offers Reload saved configuration, as the dashboard does, instead of failing on every save.
- IMPROVED: The script loads with
defer, only on public pages, and is kept out of caching plugins’ minify and combine steps. - IMPROVED: Requires WordPress 6.8 or later. Tested with PHP 7.4 to 8.5.
- CHANGED: Payouts are no longer set up from WordPress. Monetization, billing and payouts are managed with Brambles.ai.
- REMOVED: The colors, welcome message, header title, position and proactive settings that earlier versions kept in WordPress. Your Brambles.ai account now holds them.
- SECURITY: Settings changes are signed and limited on the server to publisher look-and-placement options. The admin-capable key is never stored.
- SECURITY: Uninstalling removes every option, cached value and per-user note the plugin stored, on every site of a network.
0.3.2
- FIX: Surface secure-setup errors in Quick Setup and after Retry
- FIX: Lock Enable AI Chat until a scoped storefront key is stored
- FIX: Make the Enable AI Chat toggle reliably clickable
0.3.1
- SECURITY: Removed the legacy identifier-only iframe fallback
- SECURITY: Storefront loading now requires a scoped storefront key
- IMPROVED: Existing installs request a fresh scoped key through signed onboarding
- IMPROVED: Added an admin notice and retry action when secure onboarding is incomplete
0.3.0
- NEW: Upgraded to the Shadow DOM web component (better performance, style isolation)
- NEW: Automatic API key provisioning on plugin activation
- NEW: Existing installs auto-migrate on update, with no action needed
- IMPROVED: Configuration now managed via the Brambles.ai dashboard
0.2.2
- FIX: Resolved “Network error: A valid URL was not provided” when connecting Stripe after saving customizations
- FIX: Prevented internal API base URL setting from being inadvertently cleared on settings save
- SECURITY: Added defensive URL validation for Stripe Connect endpoint
0.2.1
- DOCS: Enhanced readme with SEO optimization and clearer monetization guidance
- DOCS: Added Stripe payout setup instructions and affiliate disclosure recommendations
- DOCS: Expanded FAQ with earnings and compatibility information
- DOCS: Added Privacy & Disclosures section for compliance
0.2.0
- MAJOR: Complete AI-powered affiliate chatbot integration
- NEW: Auto-generated CUID for revenue tracking and Stripe Connect payouts
- NEW: Full admin interface with customization and conversational commerce
- SECURITY: Enhanced HMAC signing and data sanitization
- PERFORMANCE: Async CDN loading with zero site speed impact
0.1.0
- Initial release with basic affiliate integration
