1. Home
  2. Language Guides
  3. JavaScript
  4. Real User Monitoring
  5. WordPress

WordPress

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.
Server-side Documentation

Further documentation on the PHP component can be found in PHP/WordPress.

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 | paste_your_api_key_here
  • Check Enable Real User Monitoring checkbox
  • Click Save Changes.

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: User details will only be included if you have customer tracking enabled.

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.

The provider is open source and available at the Raygun4WordPress repository.

On this page: