Title: Ruby Relay Author: rubyrelay Published: April 22, 2026 Last modified: April 22, 2026 --- Search plugins ![](https://ps.w.org/ruby-relay/assets/banner-772x250.png?rev=3513118) ![](https://ps.w.org/ruby-relay/assets/icon-256x256.png?rev=3513118) # Ruby Relay By [rubyrelay](https://profiles.wordpress.org/rubyrelay/) [Download](https://downloads.wordpress.org/plugin/ruby-relay.1.2.0.zip) * [Details](https://xho.wordpress.org/plugins/ruby-relay/#description) * [Reviews](https://xho.wordpress.org/plugins/ruby-relay/#reviews) * [Installation](https://xho.wordpress.org/plugins/ruby-relay/#installation) * [Development](https://xho.wordpress.org/plugins/ruby-relay/#developers) [Support](https://wordpress.org/support/plugin/ruby-relay/) ## Description Ruby Relay is a hosted live chat service. This plugin loads the Ruby Relay chat widget on every public page of your site, including WooCommerce shop, cart, checkout, and product pages. Configure everything from a standard WordPress settings page and the widget appears immediately. **Features** * Zero-code install, configure everything from Settings > Ruby Relay * WooCommerce compatible with no extra setup * Async widget load so page render is never blocked * Nine built-in theme presets, plus per-color overrides for user messages, chat background, text, and header * Four corner positions * Optional custom link inside the chat window * Show or hide sender names, open the chat automatically on page load * No tracking scripts or analytics beyond the Ruby Relay session needed to deliver chat **How the widget works** The plugin loads `https://cdn.rubyrelay.com/chat-widget/ruby-relay-widget.min.js` from Ruby Relay’s CDN and calls `RubyRelayWidget.init()` with the values you save in Settings > Ruby Relay. No data is sent to Ruby Relay until a site visitor opens the chat bubble and sends a message. ### External services This plugin loads a JavaScript bundle from Ruby Relay’s CDN and opens a WebSocket connection to Ruby Relay’s chat infrastructure when a visitor interacts with the chat widget. * Widget bundle: [https://cdn.rubyrelay.com/chat-widget/ruby-relay-widget.min.js](https://cdn.rubyrelay.com/chat-widget/ruby-relay-widget.min.js) * Chat API: [https://api.rubyrelay.com](https://api.rubyrelay.com) * Chat WebSocket: `wss://msg.rubyrelay.com` **Personal data sent to Ruby Relay** * Chat messages that site visitors send through the widget, and the page URL where the conversation started. * When the “Share logged-in user info” setting is enabled (off by default; admins must opt in from Settings > Ruby Relay) and a WordPress user is logged in, the plugin also sends the visitor’s WordPress user ID and email address to Ruby Relay so your support team has context on who is chatting. Nothing is sent for guest visitors, and nothing is sent at all until an admin enables the setting. Ruby Relay’s terms of service: [https://rubyrelay.com/terms](https://rubyrelay.com/terms) Ruby Relay’s privacy policy: [https://rubyrelay.com/privacy](https://rubyrelay.com/privacy) ## Screenshots * [[ * The Ruby Relay chat widget rendered on the front-end of a site, with the chat panel open and ready for a visitor to start a conversation. ## Installation 1. Upload the `ruby-relay` folder to the `/wp-content/plugins/` directory, or install via the Plugins screen in WordPress. 2. Activate the plugin through the Plugins screen. 3. Go to Settings > Ruby Relay and paste your API key. 4. (Optional) Customize position, theme, header title, and welcome message. 5. Visit your site to confirm the chat bubble appears. ## FAQ ### Do I need a Ruby Relay account? Yes. Sign up at [https://rubyrelay.com](https://rubyrelay.com) and copy your API key from the dashboard. ### Does this work with WooCommerce? Yes. The widget loads on every public page including WooCommerce shop, cart, checkout, and product pages with no additional configuration. ### Does it slow down my site? The widget script is loaded asynchronously and weighs about 500 KB. It does not block page render or first paint. ### Can I hide the widget on specific pages? Not through this plugin’s settings yet. If you need conditional loading, use the` wp_enqueue_scripts` filter to dequeue `ruby-relay-widget` on specific templates. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “Ruby Relay” is open source software. The following people have contributed to this plugin. Contributors * [ rubyrelay ](https://profiles.wordpress.org/rubyrelay/) [Translate “Ruby Relay” into your language.](https://translate.wordpress.org/projects/wp-plugins/ruby-relay) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/ruby-relay/), check out the [SVN repository](https://plugins.svn.wordpress.org/ruby-relay/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/ruby-relay/) by [RSS](https://plugins.trac.wordpress.org/log/ruby-relay/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.2.0 * Added “Share logged-in user info” setting. Off by default; when an admin opts in from Settings > Ruby Relay, the plugin passes the current WordPress user’s ID and email address to Ruby Relay so support agents know who is chatting. Nothing is sent for guest visitors. #### 1.1.0 * Added eight new settings: show sender names, open on page load, custom link text, custom link URL, user message color, chat background color, text color, header color. #### 1.0.0 * Initial release. ## Meta * Version **1.2.0** * Last updated **2 weeks ago** * Active installations **Fewer than 10** * WordPress version ** 5.8 or higher ** * Tested up to **6.9.4** * PHP version ** 7.4 or higher ** * Language * [English (US)](https://wordpress.org/plugins/ruby-relay/) * Tags * [chat](https://xho.wordpress.org/plugins/tags/chat/)[chat widget](https://xho.wordpress.org/plugins/tags/chat-widget/) [customer support](https://xho.wordpress.org/plugins/tags/customer-support/)[live chat](https://xho.wordpress.org/plugins/tags/live-chat/) [woocommerce](https://xho.wordpress.org/plugins/tags/woocommerce/) * [Advanced View](https://xho.wordpress.org/plugins/ruby-relay/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/ruby-relay/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/ruby-relay/reviews/) ## Contributors * [ rubyrelay ](https://profiles.wordpress.org/rubyrelay/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/ruby-relay/)