What You’ll Learn
- Setting up the Pro Reports Extension and Child Reports plugin
- Creating recurring and one-time reports
- Customizing report templates with tokens
- Managing client information and branding
- Generate professional reports in seconds
- Pre-made templates to get you started
- Automatic PDF attachment to emails
- Include or exclude specific content
- Customizable template system
- Custom branding options

Setting up the Pro Reports Extension
Installation
Install MainWP Child Reports
Install Pro Reports Extension
Sync your sites
MainWP Child Reports Plugin
The MainWP Child Reports plugin records changes on your child sites and communicates them to the Pro Reports Extension. Built on the Stream Plugin, it currently requires PHP 7.4 or higher.Viewing Recorded Data
By default, go to WP Admin > Settings > MainWP Child > Child Reports on your child site to see recorded activity. If you have customized MainWP Child branding, these labels can differ.
Child Reports Settings

Client Information
Pro Reports uses tokens to personalize reports without creating separate versions for each client. Tokens are placeholders like[client.email] and [client.name] that get replaced with actual values when reports generate. You can define client information in two ways:
Setting Per-Site Client Information
Navigate to site settings
Configure tokens

Save settings
Token Configuration
Token Configuration
Client vs Site Tokens
Report Types
Pro Reports offers two report formats. Recurring reports run on a schedule you define. One-time reports cover a specific date range you select manually.Create a Recurring Report
Open Create Report
Configure report settings

Customize content and design

Configure email settings
Select sites and schedule

Create a One-Time Report
Open Create Report
Configure report settings

Customize content and design

Configure email settings
Select sites and send

Email Customization
Email Customization
Custom Email Logo
Custom Email Template
HTML-Only Reports
Background Delivery and Recovery
Check Each Site’s Result
A report request can be accepted before generation and sending finish. The progress dialog follows the background run and reports results for each selected site. Check those results before starting another send. One failed site does not mean every site failed. Accepted for sending means the local mail system accepted the message. It does not confirm delivery to the client’s inbox. If the dialog reports an unknown or uncertain email outcome, sending may already have happened. Pro Reports does not automatically retry an unknown handoff. Check your mail delivery records before requesting another send. Automation clients can read a run and its per-site deliveries without sending again. Reuse the original request reference for an identical retry after a lost response; a new reference can start another send. Keep WordPress cron or your existing server cron runner working so queued generation and delivery can continue. Background report tasks appear in MainWP’s cron schedule list.Review Existing Reports After an Update
Existing report templates, sharing, and schedules are retained. An older report can still use the editor and its schedule without appearing in the Abilities definition list. Saving or scheduling it explicitly can create its automation definition. If a report shows Needs review, open it and check its recipients, selected sites, and schedule before saving. If it shows Paused because site access could not be confirmed, verify access to the selected sites and save the schedule to resume automatic reports.Resolve Delivery Storage or Permission Notices
If you see Report abilities are unavailable because delivery storage is not ready, ask your database administrator to check that the report tables and WordPress options table use InnoDB. Existing legacy reports can still be previewed, downloaded, and sent through the existing interface. Pro Reports does not automatically convert existing tables. Report changes, generation, sending, schedule changes, and run management require Pro Reports Management, in addition to Pro Reports access and access to the report’s sites. If an action is refused, have the Dashboard administrator review those permissions in Team Control.Pro Reports Dashboard

Status Indicators
Dashboard Columns
Create Custom Report Templates
Creating a Custom Template
Download the add-on
Extract and locate templates
/mainwp-pro-reports-extension/templates/reports/.Copy and customize
Upload the template
/wp-content/uploads/mainwp/report-templates/ on your Dashboard site.Select the template

Template Resources
Template Resources
Custom Templates Guide
Add Images to Templates
Limit Table Entries
Token Types
Pro Reports uses four token types that you can add directly to PHP templates or through the visual editor.Client Tokens
Client tokens display data set in the Individual Child site Edit tab. Set values for tokens you plan to use in reports.
[client.email] in the Send email to field to send reports to multiple clients automatically.


How Tokens Work Together
The following example demonstrates all three token types working together in a template:.count.
Section tokens loop through database records within the report date range. They require opening and closing tags.
Data tokens display specific values and must appear between section token tags.


Token Reference
Token Reference
Available Tokens
Conditional Messages
Delete Reports

Navigate to reports
Delete the report
Duplicate Reports

Navigate to reports
Duplicate the report
PDF Storage
Earlier Pro Reports builds save PDFs on the Dashboard site in/wp-content/uploads/mainwp_pro_reports/. Builds with background delivery keep run artifacts in private storage and serve previews and downloads through authorized report actions. Use the report controls instead of relying on a direct file URL.
Pro Reports Abilities API
Use the Pro Reports Abilities reference to discover eleven abilities for report definitions, catalogs, generation, sending, schedules, and delivery outcomes. Changes use a preview and confirmation; accepted background work must be checked for completion.Pro Reports REST API
All MainWP REST API calls, including documentation and examples, are available on Postman. See MainWP REST API for details on enabling the API and managing keys.Related Resources
- Create Custom Report Templates - Build custom templates
- Create a custom Pro Reports email template - Copy and customize a built-in email template
- Available Pro Reports Tokens - Token reference
- Agency Add-ons - Browse agency add-ons
