This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.



Raygun keeps a watchful eye on your website and notifies you of problems as they arise.

Crash Reporting

Raygun Crash Reporting silently monitors your software and notifies you when users encounter errors. Crash Reporting also provides deep diagnostic information about the root cause of the error or crash, meaning your team won’t be losing valuable time digging through log files.

Using this plugin you can enable crash reporting to track errors and exceptions generated by your WordPress site.

Real User Monitoring

Ensure your website delivers a flawless user experience using Raygun Real User Monitoring. Monitor the performance of every user session so you can make improvements. Measure how geographic location affects your user experience by viewing detailed breakdowns. Increase user retention by discovering the problematic pages your users get stuck on.

Using this plugin you can enable real user monitoring to track individual user sessions, asset load times and more about your WordPress site.

Signup for a free trial of Raygun today.


Customers are why we create software. See them all, what they do, and how they’re impacted by errors, crashes, and performance issues when using your software applications. Raygun Customers gives you complete clarity on who is using your application, alongside any problems they encountered that negatively impacted their end-user experience. Understand what actions led to an issue occurring and whether the overall experience was good or bad for individual users. Customers is included in all Raygun plans and can be set up quickly by enabling it in your plugin settings.


  1. Download and enable the Raygun4WP Plugin
  2. Activate it
  3. Paste in your Raygun API Key (Found in Application Settings)



How do I enable Real User Monitoring

As of 1.8, you can enable real user monitoring by navigating to the Raygun4WP settings page and checking the Enable Real User Monitoring checkbox.

User information will be sent along if you have the Customers feature enabled.

Client-side JavaScript error tracking

As of 1.4, this plugin now also includes Raygun4JS so you can automatically track JavaScript errors that occur in your user’s browser once your site’s pages are loaded.

To activate this, turn on the JavaScript error tracking option in the Raygun4WP settings page.

What does my WordPress site require to use this plugin?

This plugin automates the installation of Raygun4PHP, the PHP 5 provider for Raygun. As a result it requires the dependencies that Raygun4PHP needs.

Specifically, the server that your WordPress site runs on requires a PHP 5.3 environment with the curl library and dependencies. Please ask your administrator if this is not enabled. You can see your PHP information with `phpinfo()“.

When activating the plugin, if you receive a PHP error message stating that there is an ‘Unexpected T_STRING’, you may be running a PHP 5.2 or below installation. Raygun4WP currently only supports PHP 5.3, a version compatible with 5.2 may be available – please contact us if you require this.

Multisite Support

It is recommended to use the most recent version WordPress and PHP possible. This procedure should be first followed on a staging server that matches your production environment as closely as possible, then replicated live.

  1. On your root network site, install the plugin using the Admin dashboard’s Plugin page as standard, but do not activate it.

  2. FTP in and modify wp-content/plugins/raygun4wp/raygun4wp.php – change the value on line 12 to true.

  3. Visit the Admin dashboard of a child site (not the root network site). Go to its Plugin page, and you should see Raygun4WP ready to be activated – do so.

  4. A new Raygun4WP submenu will be added to the left sidebar. In there click on Configuration, paste in your API key, change the top dropdown to Enabled then click Save Changes. You can now click Send Test Error and one will appear in your Raygun dashboard.

  5. Repeat the above process for any other child sites – you can use different API keys (to send to different Raygun applications) or the same one.

Finally, if you so desire you should be able to visit the root network site, activate it there and configure it. You must however activate it on at least one child site first.

How do I use Customers?

If you enable this feature in your Raygun4WP Plugin settings, the currently logged in user’s email address, first name and last name will be transmitted along with each error, or session. This will be visible in the Raygun dashboard. If they have associated a Gravatar with that address, you will see their picture. If this feature is not enabled, a random ID will be assigned to each user. Either way, you can view a count of the affected users for each error.


December 30, 2020
Tried to activate this plugin on our website, hosted with Pagely, and it immediately crashed the server. An error of type E_COMPILE_ERROR was caused in line 168 of the file /dom34643/wp-content/plugins/raygun4wp/main.php. Error message: require_once(): Failed opening required '/dom34643/wp-content/plugins/raygun4wp/external/raygun4php/src/Raygun4php/RaygunClient.php' (include_path='.:/usr/share/php')
Read all 2 reviews

Contributors & Developers

“Raygun4WP” is open source software. The following people have contributed to this plugin.


Translate “Raygun4WP” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • Updated User Tracking to Customers


  • Update Pulse to Real User Monitoring (RUM)


  • Don’t set user cookie when user tracking is disabled


  • Add async sending option to dashboard
  • Bump Raygun4PHP dependency to v1.8.2
  • Bump Raygun4JS dependency to v2.8.5


  • Fix XSS vulnerability in settings
  • Replace the iframe with a link to the Raygun dashboard


  • Bump Raygun4JS version to v2.6.2


  • XSS bug fix


  • Bump Raygun4JS dependency to v2.4.0
  • Bump Raygun4PHP dependency to v1.7.0
  • Pulse support added
  • Raygun4JS also includes the unique user tracking feature
  • Restructured the settings screen
  • JavaScript error tagging option added
  • Fixed an issue where the Send Test Error page wouldn’t display results
  • Updated the about page to include information about Pulse & Crash Reporting
  • Raygun Dashboard uses more space to provide a better user experience
  • Updated notifications
  • Raygun4JS tracks the version WordPress being used
  • Unique user tracking also tracks the users first & last names


  • Fixed issue with WP 4.5.2 plugin api


  • Fixed redundant cURL check when running in socket mode


  • Fix issue with tags not being provided for caught exceptions


  • Bump Raygun4JS dependency to v1.18.4

  • Bump Raygun4php dependency to v1.6.1

  • Admin warning notice fix

  • Added auto client-side JavaScript error tracking

  • Ignored Domains setting added
  • Bump RG4PHP to v1.3.5

  • Updated admin message

  • Now requires PHP 5.3.3 or newer
  • Default to using socket sending method; bump Raygun4PHP to 1.3.3

  • Bump underlying Raygun4PHP to latest version with minor bugfixes and improvements

  • Update Raygun4PHP to use async cURL sending. This should be very fast on linux environments

  • WordPress version tracking enabled
  • Updated Raygun4PHP. There were two bugs in 1.1 with nested request data and user tracking, updating is recommended.

  • Added Unique User tracking support to Settings page
  • Updated internal Raygun4PHP to use latest v1.1

  • Added button to test setup on config page
  • Added status indicator, improved handling when API key missing or invalid
  • Fixed a major bug where the provider would attempt to send errors, even if the status was ‘disabled’, cURL was missing, or an invalid API key was provided. Because of these changes, we strongly recommend you upgrade from any earlier releases to or greater.

  • Added 404 error handling
  • Enabled tag support
  • Misc UX improvements


  • Initial release.