WordPress Exception & Error Tracking

Typical installation time: 5 minutes

Hi there! You've found Honeybadger's guide to WordPress error and exception tracking. Once installed, Honeybadger will automatically report errors wherever they may happen, both in the front-end (JavaScript) and back-end (PHP) of your WordPress site.

On this page:

Installation

First, install the Honeybadger Application Monitoring plugin via the WordPress plugin repository:

  1. In your WordPress admin panel, go to Plugins > Add New.
  2. Search for "Honeybadger Application Monitoring".
  3. Click Install Now next to the Honeybadger plugin.
  4. After installation, click Activate.

Alternatively, you can install the plugin manually:

  1. Download the plugin from the WordPress plugin repository.
  2. Upload the plugin files to the /wp-content/plugins/honeybadger-application-monitoring directory.
  3. Activate the plugin through the Plugins page in WordPress.

Configuration

After activating the plugin, you need to configure it with your Honeybadger API key(s):

  1. In your WordPress admin panel, go to Settings > Honeybadger.
  2. Grab your API key(s) from your Honeybadger project settings. It is recommended that you have two separate projects, one for PHP and another for JavaScript error tracking.
  3. Enter your Honeybadger API key(s) in the PHP API Key and JS API Key fields.
  4. Ensure that PHP error reporting enabled is checked if you want to track PHP errors, as well as JS error reporting enabled if you want to track JavaScript errors.
  5. (Optional) You can also configure the Environment and Version settings to better track your errors.
  6. Click Save Changes.

Testing the Integration

To ensure everything is set up correctly, you can trigger a test error:

  1. In your WordPress admin panel, go to Settings > Honeybadger.
  2. Check the Send test notification from PHP or Send test notification from JS checkboxes.
  3. Click Save Changes.

If everything is set up correctly, you should now have an error (or two if you checked both checkboxes) reported in Honeybadger!

Make sure to uncheck the test notification checkboxes after testing to avoid unnecessary test errors in your Honeybadger dashboard.