WP Debug Toolkit (WPDT) notification emails are fully customizable. You control the branding, content, layout, and optional sections from the admin dashboard. A live preview updates as you change settings.
Go to Debug Toolkit > Settings > Email Design. The page is split into a settings panel on the left and a live preview on the right. Changes in the settings panel reflect in the preview immediately.
| Setting | Description | Default |
|---|---|---|
| Company name | Displayed in the email header and footer | Your site name |
| Logo URL | URL to your company or site logo image | WPDT logo |
| Logo height | Height of the logo in the email header (20–200px) | 40px |
| Brand color | Primary color used for buttons and accents (hex value) | #e83f94 |
Set the company name and logo to match your organization. For agencies managing client sites, this makes notifications look like they come from your brand rather than a debugging tool.
| Setting | Description | Default |
|---|---|---|
| From name | The sender name shown in the recipient’s email client | WP Debug Toolkit |
This controls the “From” display name on notification emails. The actual from email address is determined by your WordPress or SMTP plugin configuration.
| Setting | Description | Character limit |
|---|---|---|
| Email intro | Text displayed below the error details | 500 |
| Recovery button text | Label on the recovery mode button | 50 |
| Recovery description | Text below the recovery button explaining what it does | 300 |
| Footer text | Text at the bottom of the email | 500 |
| Support email | Contact email shown in the footer | Admin email |
| Support URL | Link to your support page or help desk | Site URL |
Use these variables in content fields. WPDT replaces them with actual values when sending:
| Variable | Replaced with |
|---|---|
{site_name} | Your WordPress site name |
{site_url} | Your WordPress site URL |
{date} | Current date |
{time} | Current time |
{support_email} | The configured support email address |
{support_url} | The configured support page URL |
| Setting | Options | Default |
|---|---|---|
| Button style | Gradient, Solid, Outlined | Gradient |
| Email width | Standard (600px), Narrow (500px), Wide (700px) | Standard |
| Font family | System (sans-serif stack), or specific fonts | System |
The email width setting controls the maximum width of the email container. Most email clients display well at the standard 600px width. Use narrow for minimal notifications or wide if your error messages and stack traces need more horizontal space.
Toggle White-label mode to remove WPDT branding from notification emails. When enabled:
This is designed for agencies and freelancers who manage client sites. Clients receive professional error notifications without seeing third-party tool branding.
Two sections can be toggled on or off:
Include stack trace — When enabled, the notification email includes the PHP stack trace for the error. Stack traces show the chain of function calls that led to the error, which helps developers identify the root cause without logging into the site. Disable this if non-technical recipients receive the notifications.
Include recovery mode section — When enabled, the email includes a recovery mode button and description. This section is relevant when dealing with fatal errors that trigger WordPress recovery mode. See Recovery mode integration.
The preview panel on the right side of the Email Design page updates as you change settings. It renders a sample notification email with your current branding, content, and layout choices. The preview uses a realistic sample error to show how actual notifications look.
Click Send Test Email at the bottom of the settings panel to send a sample notification to the configured recipient. Use this to verify the email renders correctly in your email client and arrives in the inbox (not spam).
Click Reset to Defaults to revert all customization settings to their original values. This resets branding, content, layout, and optional section toggles. The reset takes effect immediately and updates the live preview.
