How to Use Airbrake with your Wordpress Site

Using Airbrake on your WordPress site just got a whole lot easier. Where once you had to download third-party zip files from Github and manually upload them to your server root, now it's as simple as installing a new plugin. You don't need to know any code or even what an API key is to use it.

Step #1: Mosey on over to Airbrake and click on the friendly orange "Start Your Free Trial" button to get going. Choose the plan that fits your needs, and fill out a simple form to create your account.

AB front page


Step #2: When you log in for the first time, Airbrake will prompt you to create your first project. You can put in all your Github information if you want, but it's not necessary for now.

AB new project


Step #3: Go to your WordPress Dashboard and go to Plugins and Add New. Search for Airbrake-- the one and only! Or just check out the page here. Install it, activate it, and you should see a friendly, simple control panel that looks like this:

airbrake plugin control panel

Step #4: Now we need your API key. Go back to your Airbrake account and make sure you've clicked on the project you're currently working with. Your API key will be easy to find, in the upper left-hand corner. Fill in the API key in the WordPress plugin, and make sure you've changed the Status from "Disabled" to "Enabled" (this is crucial). Save Changes.

AB homepage sidebar

Step #5: Now go back to your Airbrake account again, and click on Simulate Exception--it's right underneath your API key in the sidebar.

Not Even a Step: You're done. Sit back and wait for your first exception notification to pop up in your inbox. Don't get too comfy, though! It's gonna show up in a matter of nanoseconds.

If you want to get into the nitty gritty about using Resque, ignoring certain exceptions, etc., all the code is up on Github.