Our Raygun for WordPress plugin allows you to easily set up Crash Reporting and Real User Monitoring on WordPress sites without having to write a single line of code.
This plugin utilizes lower-level Raygun providers:
- Raygun4PHP is used to track server-side errors and exceptions.
- Raygun4JS tracks errors and monitors user performance on the client-side.
Step 1 - Install and activate the Raygun plugin
Note: The server that your WordPress site runs on requires a PHP 7.4 or newer environment. This also requires that your WordPress version be at least 5.3.
Browse to your WordPress admin panel, click on Plugins → Add New, then type Raygun in the search box. Click Install Now, then Activate.
Alternatively, you can view and download Raygun from the official WordPress plugin repository.
Step 2 - Configure and enable Raygun
- Go to the Raygun Settings page in your WordPress admin panel.
- Paste your Raygun API key into the API key field.
- API Key |
- API Key |
- Enable Crash Reporting. Make any additional configurations as needed. You may also send a test error to verify functionality.
Tip: Setting the serverside sending method to asynchronous should yeild a significant performance increase.
Once this is complete, click Save Changes.
Additionally, you can enable server-side error tracking to gain visibility into PHP errors affecting your site.
Step 3 - Release
Deploy Raygun into your production environment for best results, or raise a test exception. Once we detect your first error event, the Raygun app will automatically update.
Include the currently logged in user's details (email address, first name, and last name) with each crash report or RUM session. This information will be visible in your Raygun dashboard. If this feature is not enabled, a random ID will always be assigned to each user.
note: If a user is not logged in, no user information will be sent. A random ID will be assigned instead.
The string properties of a User have a maximum length of 255 characters. Users with fields that exceed this amount will not be processed.
client-side and PHP errors with
As of version 2.0.0, asynchronous sending is avaliable on both Unix and Windows based systems. Enabling async sending should yeild a significant performance increase.
As of version 2.0.0, errors that fail to send to Raygun will be logged to the standard WordPress log file (
The provider is open source and available at the Raygun4WordPress repository.