Skip to content

WordPress integration guide

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.

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.

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.

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!