Documentation

Everything you need to monitor and manage your WordPress sites

Installation

Get started with IncidentWP in just a few minutes by installing the WordPress agent plugin.

1

Download the WordPress Agent

Download the latest version of the IncidentWP agent plugin.

Download IncidentWP Agent

Latest version • Compatible with WordPress 5.0+

2

Install the Plugin

Upload and activate the plugin in your WordPress admin:

  1. Go to WordPress Admin → Plugins → Add New
  2. Click Upload Plugin
  3. Choose the downloaded ZIP file
  4. Click Install Now
  5. Click Activate Plugin
3

Create Your Account

Sign up for a free IncidentWP account if you haven't already.

Create Free Account

Connecting Your Site

Connect your WordPress site to IncidentWP using secure login-based authentication.

Secure Authentication

IncidentWP uses login-based authentication. No API keys to manage or expose.

Connection Steps

  1. In WordPress, go to IncidentWP in the admin menu
  2. Click "Login to IncidentWP"
  3. Enter your IncidentWP account email and password
  4. Click "Connect This Site"
  5. Your site will appear in your dashboard within seconds
💡 Tip: You can connect multiple WordPress sites to a single IncidentWP account.

Quick Start Guide

Once your site is connected, here's what you can do immediately:

View Dashboard

See real-time stats, critical events, and site health at a glance.

Browse Events

Filter and search through all events with advanced filtering options.

Monitor Uptime

Track your site's availability with 5-minute interval checks (Pro plan).

Set Up Alerts

Configure email notifications for critical events and downtime.

Dashboard Overview

Your IncidentWP dashboard provides a comprehensive view of all your WordPress sites.

Dashboard Stats

  • Total Sites: Number of connected WordPress sites
  • Critical Events (24h): Fatal errors and critical issues in the last 24 hours
  • Sites Online: Number of sites currently online and responding
  • Events (7d): Total events captured in the last 7 days

Recent Events

The dashboard shows your most recent events across all sites, including:

  • PHP errors (fatal, warnings, notices)
  • User activity (logins, profile changes)
  • Plugin and theme changes
  • Security events (failed logins)
  • Uptime incidents

Events & Logs

The Events page is your central hub for viewing and analyzing all activity across your WordPress sites.

Event Types

Error

PHP Errors

Fatal errors, warnings, notices, and deprecated function usage

User

User Activity

Logins, logouts, profile changes, and user actions

Plugin

Plugin Changes

Activations, deactivations, updates, and installations

Security

Security Events

Failed logins, suspicious activity, and security alerts

Uptime

Uptime Events

Site down, site up, and response time changes

Event Details

Each event includes comprehensive information:

  • Timestamp: When the event occurred (in your timezone)
  • Severity: Critical, warning, or info
  • Event Type: Category of the event
  • Message: Detailed description
  • Stack Trace: For PHP errors, full stack trace with file and line numbers
  • User Context: Which user triggered the event (if applicable)
  • URL: The page where the event occurred

Sites Management

Manage all your connected WordPress sites from a single dashboard.

Site Information

For each site, you can view:

  • Site Name & URL: Identify your sites easily
  • Status: Online, offline, warning, or disconnected
  • Plan: Free or Pro subscription status
  • WordPress Version: Current WordPress version
  • PHP Version: Server PHP version
  • Agent Version: IncidentWP agent plugin version
  • Last Seen: When the site last communicated with IncidentWP

Site Actions

  • View Details: See comprehensive site information and stats
  • View Events: Filter events for a specific site
  • Disconnect: Temporarily disconnect a site from monitoring
  • Delete: Permanently remove a site and its data

Uptime Monitoring

Monitor your WordPress sites' availability with automated health checks.

Pro Feature

Uptime monitoring is available on Pro plans with checks every 5 minutes.

What's Monitored

  • HTTP Status: Checks if your site returns a 200 OK response
  • Response Time: Measures how long your site takes to respond
  • SSL Certificate: Verifies SSL certificate validity
  • Uptime Percentage: Calculates availability over time

Monitoring Stats

For each monitored site, you'll see:

  • Current status (online/offline)
  • Uptime percentage (30-day rolling average)
  • Average response time
  • Last check timestamp
  • Recent incidents and downtime

Alerts & Notifications

Get instant email notifications when critical issues occur on your sites.

Alert Types

  • Site Down: When your site becomes unreachable
  • Site Up: When your site comes back online after downtime
  • Fatal PHP Error: When a fatal error occurs
  • Failed Logins: Multiple failed login attempts detected
  • Plugin Changes: When plugins are activated, deactivated, or updated

Managing Alerts

In the Alerts page, you can:

  • View all active and resolved alerts
  • Mark alerts as resolved
  • Filter by severity (critical, warning, info)
  • See alert history and timestamps

Error Tracking

IncidentWP automatically captures and tracks all PHP errors on your WordPress sites.

Error Severity Levels

Fatal

Critical errors that stop script execution. These require immediate attention.

Warning

Non-fatal errors that may indicate problems. Should be reviewed and fixed.

Notice

Minor issues and deprecated function usage. Good to fix but not urgent.

Error Information

For each PHP error, you'll see:

  • Error Message: The exact error message
  • File & Line: Where the error occurred
  • Stack Trace: Full call stack for debugging
  • Frequency: How often this error occurs
  • First/Last Seen: When the error first and last occurred

User Activity Logging

Track all user actions and changes on your WordPress sites for security and audit purposes.

Tracked Activities

  • User Logins: Successful login attempts with IP address
  • Failed Logins: Failed login attempts for security monitoring
  • User Logouts: When users log out
  • Profile Changes: Updates to user profiles
  • Password Changes: When users change their passwords
  • Role Changes: When user roles are modified

Filtering & Search

Powerful filtering options help you find exactly what you're looking for.

Available Filters

  • Site: Filter events by specific site
  • Severity: Critical, warning, or info
  • Event Type: Error, user, plugin, security, or uptime
  • Date Range: Filter by date range (from/to)
  • Search: Full-text search across event messages

Combining Filters

You can combine multiple filters to narrow down results. For example:

  • Show only critical errors from a specific site
  • View all user activity in the last 7 days
  • Find plugin changes on a particular date

Export Data

Export your event data for external analysis or record-keeping.

Pro Feature

Data export is available on Pro plans.

Export Formats

  • CSV: Export events to CSV format for spreadsheet analysis
  • JSON: Export in JSON format for programmatic access

Exports include all filtered events with complete details including timestamps, severity, messages, and metadata.

Billing & Plans

Manage your subscription and billing information.

Available Plans

Free Plan

  • 1 WordPress site
  • 7-day event history
  • Email notifications
  • Basic error tracking

Pro Plan - $3/month

  • 1 WordPress site per plan
  • Unlimited event history
  • Uptime monitoring (5-min checks)
  • All event types tracked
  • Advanced filtering & search
  • Priority email support
  • Export events data

Managing Your Subscription

In the Billing page, you can:

  • View your current plan and billing cycle
  • Upgrade or downgrade plans
  • Update payment method
  • View billing history and invoices
  • Cancel subscription

Settings

Configure your IncidentWP account preferences.

Available Settings

  • Profile: Update your name and email address
  • Password: Change your account password
  • Timezone: Set your preferred timezone for event timestamps
  • Notifications: Configure email notification preferences

Timezone Configuration

All event timestamps are displayed in your configured timezone.

💡 Tip: Set your timezone in Settings to see events in your local time.

By default, timestamps are shown in UTC. You can change this to any timezone to make it easier to correlate events with your local time.

Troubleshooting

Common issues and solutions.

Site Not Appearing in Dashboard

  • Verify the plugin is activated in WordPress
  • Check that you're logged in to the agent
  • Ensure your site can make outbound HTTPS requests
  • Check for firewall or security plugin conflicts
  • Try disconnecting and reconnecting the site

Events Not Being Tracked

  • Verify the connection status in WordPress Admin → IncidentWP
  • Check if the agent version is up to date
  • Ensure no caching plugins are interfering
  • Check PHP error_reporting settings

Uptime Monitoring Not Working

  • Verify you have an active Pro subscription
  • Ensure your site isn't blocking our monitoring servers
  • Verify SSL certificate is valid (if using HTTPS)

Not Receiving Email Notifications

  • Check your spam/junk folder
  • Verify your email address in Settings
  • Check notification preferences in Settings
  • Ensure alerts are configured for the event types you want

Still Need Help?

Contact our support team at support@incidentwp.com or visit our support page.

Frequently Asked Questions

Does the agent slow down my WordPress site?

No. The IncidentWP agent is designed to be extremely lightweight and runs asynchronously. It has zero impact on your site's performance or page load times. All processing happens in the background.

How is data transmitted and stored?

All data is transmitted over secure HTTPS connections using industry-standard encryption. Data is stored securely on our servers with regular backups. We never store sensitive information like passwords or payment details.

Can I monitor multiple sites?

Yes! The Free plan includes 1 site. Each Pro plan ($3/month) covers 1 additional site. You can purchase multiple Pro plans to monitor as many sites as you need from a single dashboard.

How long is event data retained?

Free plans retain 7 days of event history. Pro plans have unlimited event history retention.

Can I disconnect a site temporarily?

Yes. You can disconnect a site at any time from WordPress Admin → IncidentWP → Disconnect, or from your IncidentWP dashboard. You can reconnect it later without losing your subscription.

What happens if I cancel my Pro subscription?

If you cancel, your site will automatically downgrade to the Free plan at the end of your billing period. You'll lose access to Pro features like uptime monitoring and unlimited history, but your site will continue to be monitored with Free plan limits.

Do you offer refunds?

Yes, we offer a 14-day money-back guarantee. If you're not satisfied with IncidentWP, contact us within 14 days of your purchase for a full refund.